已定稿
感謝Dcloud等1人做出了貢獻
常見問題 我要提意見 贊(151)

Key

Key管理設備按鍵事件

方法:

對象:

回調方法:

addEventListener

添加按鍵事件監聽器

plus.key.addEventListener( keyevent, listener, capture );

說明:

添加按鍵事件監聽器,當指定的按鍵事件發生時,回調函數将觸發。 應用中存在多個Webview窗口時,按照窗口的顯示棧順序從後往前查找,查找到添加按鍵事件監聽器的窗口後停止(中斷前面Webview窗口對按鍵事件的監聽),并向窗口觸發執行按鍵回調事件。 在同一Webview窗口中可多次調用此方法對同一事件添加多個監聽器,觸發時按照添加的順序先後調用。

參數:

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Key Example</title>
	<script type="text/javascript">
// 監聽“返回”按鈕事件
function addEventTest() {
	plus.key.addEventListener("backbutton",function(){
		alert( "BackButton Key pressed!" );
	});
}
	</script>
	</head>
	<body>
		<button onclick="addEventTest()">監聽“返回”按鍵</button>
	</body>
</html>

removeEventListener

移除按鍵事件監聽器

plus.key.removeEventListener( event, listener );

說明:

從窗口移除指定的事件監聽器。若沒有查找到對應的事件監聽器,則無任何作用。

參數:

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Key Example</title>
	<script type="text/javascript">
function onback(){
	alert( "BackButton Key pressed!" );
}
// 監聽“返回”按鈕事件
function addEventTest() {
	plus.key.addEventListener("backbutton",onback);
}
// 取消監聽“返回”按鈕事件
function removeEventTest(){
	plus.key.removeEventListener("backbutton",onback);
}
	</script>
	</head>
	<body>
		<button onclick="addEventTest()">監聽“返回”按鍵</button>
		<button onclick="removeEventTest()">取消監聽“返回”按鍵</button>
	</body>
</html>

KeyType

按鍵類型

常量:

"backbutton"

設備“返回”按鈕按鍵事件

說明:

如果需要改變默認“返回”按鈕的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"backbutton"事件。

平台支持:

Android : 2.2+

默認處理邏輯為退出應用。

WP : 7.5+

默認處理邏輯為退出應用。

"keydown"

鍵按下事件

說明:

如果需要改變默認鍵按下的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"keydown"事件。 可通過回調函數中KeyEvent對象的keyCode來獲取按下的鍵值。

平台支持:

Android : 2.2+

默認處理邏輯由系統決定。

"keyup"

鍵松開事件

說明:

如果需要改變默認鍵松開的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"keyup"事件。 可通過回調函數中KeyEvent對象的keyCode來獲取松開的鍵值。

平台支持:

Android : 2.2+

默認處理邏輯由系統決定。

"longpressed"

長按鍵事件

說明:

如果需要改變默認長按鍵的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"longpressed"事件。 長按鍵時會多次觸發回調函數,通過回調函數中KeyEvent對象的keyCode來獲取長按的鍵值。

平台支持:

Android : 2.2+

默認處理邏輯由系統決定。

"menubutton"

設備“菜單”按鈕按鍵事件

說明:

如果需要改變默認“菜單”按鈕的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"menubutton"事件。

平台支持:

Android : 2.2+

默認處理邏輯無操作。

"searchbutton"

設備“搜索”按鈕按鍵事件

說明:

如果需要改變默認“搜索”按鈕的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"searchbutton"事件。

平台支持:

Android : 2.2+

默認處理邏輯為打開系統搜索應用。

"volumeupbutton"

設備“音量+”按鈕按鍵事件

說明:

如果需要改變默認“音量+”按鈕的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"volumeupbutton"事件。

平台支持:

Android : 2.2+

默認處理邏輯為增加系統音量。

"volumedownbutton"

設備“音量-”按鈕按鍵事件

說明:

如果需要改變默認“音量-”按鈕的處理邏輯,則可通過plus.key.addEventListener來注冊監聽"volumedownbutton"事件。

平台支持:

Android : 2.2+

默認處理邏輯為減少系統音量。

KeyEvent

按鍵事件

屬性:

KeyEventCallback

按鍵事件的回調函數

void onKeyEvent( KeyEvent event ){
	// Event handled code.
	var key=event.keyCode; // 用戶按鍵的鍵值
}

說明:

按鍵事件的回調函數

參數: