PhoneGap 提供了 menubutton 事件,用來攔截 Android 等平台上使用者的菜單按鍵,並在 HTML5 層級接手處理。
這個事件會在使用者按下菜單鍵時觸發。
document.addEventListener("menubutton", yourCallbackFunction, false);
Amazon Fire OS、Android、BlackBerry 10
document.addEventListener("menubutton", onMenuKeyDown, false);
function onMenuKeyDown() {
// 處理菜單按鍵
}
<html>
<head>
<title>Menu Button Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待 device API 相關程式庫載入
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// device API 已可用
function onDeviceReady() {
// 註冊事件監聽
document.addEventListener("menubutton", onMenuKeyDown, false);
}
// 處理菜單按鍵
function onMenuKeyDown() {
// 菜單按鈕的執行邏輯
}
</script>
</head>
<body onload="onLoad()">
</body>
</html>
deviceready 只需要監聽一次即可,它代表 PhoneGap(Cordova)的原生 API 已經載入完畢。若在這個事件之前註冊 menubutton 這類依賴原生橋接的事件,監聽很可能不會生效——這是新手最常踩的坑。
與菜單鍵一同提供的還有其他實體按鍵事件:backbutton(返回鍵)、searchbutton(搜尋鍵)、pause 與 resume(應用進入背景 / 回到前景)、online 與 offline(網路狀態變化)。這些事件的註冊方式完全一致,也同樣要在 deviceready 之後進行。
實務上,menu 鍵通常用來開啟 App 內的抽屜選單或選項面板;而 backbutton 則建議攔截後自行處理導覽堆疊,避免使用者一按就直接關閉 App。