您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

PhoneGap 菜單鍵事件:攔截 menubutton 並在 HTML5 中處理

編輯:iOS 開發綜合

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

deviceready 只需要監聽一次即可,它代表 PhoneGap(Cordova)的原生 API 已經載入完畢。若在這個事件之前註冊 menubutton 這類依賴原生橋接的事件,監聽很可能不會生效——這是新手最常踩的坑。

相關事件

與菜單鍵一同提供的還有其他實體按鍵事件:backbutton(返回鍵)、searchbutton(搜尋鍵)、pause 與 resume(應用進入背景 / 回到前景)、online 與 offline(網路狀態變化)。這些事件的註冊方式完全一致,也同樣要在 deviceready 之後進行。

實務上,menu 鍵通常用來開啟 App 內的抽屜選單或選項面板;而 backbutton 則建議攔截後自行處理導覽堆疊,避免使用者一按就直接關閉 App。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved