Key管理设备按键事件

方法:

对象:

回调方法:

权限:

5+功能模块(permissions)

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// ...</span>
<span style="color:#ffa0a0">"permissions"</span><span style="color:#ffffff">:{</span>
	<span style="color:#87ceeb">// ...</span>
	<span style="color:#ffa0a0">"Webview"</span><span style="color:#ffffff">:</span> <span style="color:#ffffff">{</span>
		<span style="color:#ffa0a0">"description"</span><span style="color:#ffffff">:</span> <span style="color:#ffa0a0">"窗口管理"</span>
	<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
			</code></span></span>

addEventListener

添加按键事件监听器

<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> keyevent</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> listener</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> capture </span><span style="color:#ffffff">);</span>
				</code></span></span>

说明:

添加按键事件监听器,当指定的按键事件发生时,回调函数将触发。 应用中存在多个Webview窗口时,按照窗口的显示栈顺序从后往前查找,查找到添加按键事件监听器的窗口后停止(中断前面Webview窗口对按键事件的监听),并向窗口触发执行按键回调事件。 在同一Webview窗口中可多次调用此方法对同一事件添加多个监听器,触发时按照添加的顺序先后调用。 注意:此方法无法监听软键盘的按键事件。

参数:

  • event: KeyType ) 必选 要监听的按键事件类型

  • listener: KeyEventCallback ) 必选 监听按键事件发生时调用的回调函数

  • capture: ( Boolean ) 可选 捕获按键事件流顺序,暂作为保留参数

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span>
	<span style="color:#f0e68c"><strong><head></strong></span>
	<span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span>
	<span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Key Example</span><span style="color:#f0e68c"><strong></title></strong></span>
	<span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// 监听“返回”按钮事件</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> addEventTest</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"backbutton"</span><span style="color:#ffffff">,</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
		alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"BackButton Key pressed!"</span> <span style="color:#ffffff">);</span>
	<span style="color:#ffffff">});</span>
<span style="color:#ffffff">}</span>
	<span style="color:#f0e68c"><strong></script></strong></span>
	<span style="color:#f0e68c"><strong></head></strong></span>
	<span style="color:#f0e68c"><strong><body></strong></span>
		<span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">addEventTest</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">监听“返回”按键</span><span style="color:#f0e68c"><strong></button></strong></span>
	<span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span>
				</code></span></span>

uni-app使用plus注意事项

hideSoftKeybord

隐藏软键盘

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">hideSoftKeybord</span><span style="color:#ffffff">();</span>
				</code></span></span>

说明:

隐藏已经显示的软键盘,如果软键盘没有显示则不做任何操作。

参数:

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span>
	<span style="color:#f0e68c"><strong><head></strong></span>
	<span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span>
	<span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Key Example</span><span style="color:#f0e68c"><strong></title></strong></span>
	<span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span>
<span style="color:#ffffff">}</span>
<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">window</span><span style="color:#ffffff">.</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
	plusReady</span><span style="color:#ffffff">();</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span><span style="color:#ffffff">{</span><span style="color:#ffffff">
	document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
	<span style="color:#f0e68c"><strong></script></strong></span>
	<span style="color:#f0e68c"><strong></head></strong></span>
	<span style="color:#f0e68c"><strong><body></strong></span><span style="color:#ffffff">
		编辑框:</span><span style="color:#f0e68c"><strong><input</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text"</span> <span style="color:#bdb76b"><strong>placeholder</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"请输入"</span><span style="color:#f0e68c"><strong>></input><br/></strong></span>
		<span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">hideSoftKeybord</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">隐藏软键盘</span><span style="color:#f0e68c"><strong></button><br/></strong></span>
	<span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span>
				</code></span></span>

uni-app使用plus注意事项

setAssistantType

设置辅助输入类型

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setAssistantType</span><span style="color:#ffffff">(</span><span style="color:#ffffff">type</span><span style="color:#ffffff">);</span>
				</code></span></span>

说明:

input的type类型为text获取焦点时,在软键盘上方显示辅助输入条方便用户快速输入。 在页面中input编辑框type类型不为"tel"、"email"时生效(type为tel类型时一定显示tel的辅助输入条,type为email时一定显示email的辅助输入条)。

参数:

  • type: ( String ) 必选 辅助输入类型

    可取值: "nick" - 用户名(昵称)类型,自动保存最后输入的两个用户名,并在辅助输入条上显示; "address" - 地址类型,在辅助输入条上显示当前位置(定位获取)、家庭地址(在设置界面中配置)、单位地址(在设置界面中配置); "tel" - 电话号码类型,自动保存最后两次输入的两个手机号码显示在辅助输入条上,与input的type类型为tel逻辑一致; "email" - 邮箱地址类型,自动保存最后两次输入的两个邮箱地址显示在辅助输入条上,与Input的type类型为email逻辑一致; "company" - 公司名称类型,自动保存最后一次输入的公司名称显示在辅助输入条上; "tax" - 税号类型,自动保存最后一次输入的企业税务标识显示在辅助输入条上; "id" - 身份证号码类型,自动保存最后一次输入的身份证号显示在辅助输入条上; "none" - 不使用辅助输入。

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span>
	<span style="color:#f0e68c"><strong><head></strong></span>
	<span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span>
	<span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Key Example</span><span style="color:#f0e68c"><strong></title></strong></span>
	<span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span>
<span style="color:#ffffff">}</span>
<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">window</span><span style="color:#ffffff">.</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
	plusReady</span><span style="color:#ffffff">();</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span><span style="color:#ffffff">{</span><span style="color:#ffffff">
	document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
	<span style="color:#f0e68c"><strong></script></strong></span>
	<span style="color:#f0e68c"><strong></head></strong></span>
	<span style="color:#f0e68c"><strong><body></strong></span><span style="color:#ffffff">
		用户名编辑框:</span><span style="color:#f0e68c"><strong><input</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text"</span> <span style="color:#bdb76b"><strong>onfocus</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setAssistantType</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'nick'</span><span style="color:#ffffff">)</span><span style="color:#ffa0a0">"</span> <span style="color:#bdb76b"><strong>onblur</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setAssistantType</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'none'</span><span style="color:#ffffff">)</span><span style="color:#ffa0a0">"</span> <span style="color:#bdb76b"><strong>placeholder</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"请输入用户名"</span><span style="color:#f0e68c"><strong>></input><br/></strong></span><span style="color:#ffffff">
		地址编辑框:</span><span style="color:#f0e68c"><strong><input</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text"</span> <span style="color:#bdb76b"><strong>onfocus</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setAssistantType</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'address'</span><span style="color:#ffffff">)</span><span style="color:#ffa0a0">"</span> <span style="color:#bdb76b"><strong>onblur</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setAssistantType</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'none'</span><span style="color:#ffffff">)</span><span style="color:#ffa0a0">"</span> <span style="color:#bdb76b"><strong>placeholder</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"请输入地址"</span><span style="color:#f0e68c"><strong>></input><br/></strong></span>
	<span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span>
				</code></span></span>

uni-app使用plus注意事项

showSoftKeybord

显示软键盘

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">showSoftKeybord</span><span style="color:#ffffff">();</span>
				</code></span></span>

说明:

强制显示系统软键盘,如果软键盘已经显示则不做任何操作。

参数:

返回值:

void : 无

平台支持:

  • Android - ALL (支持)
  • iOS - ALL (不支持) :

    需获取DOM中的input元素并调用其focus方法获取焦点才能主动弹出系统软键盘。

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span>
	<span style="color:#f0e68c"><strong><head></strong></span>
	<span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span>
	<span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Key Example</span><span style="color:#f0e68c"><strong></title></strong></span>
	<span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span>
<span style="color:#ffffff">}</span>
<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">window</span><span style="color:#ffffff">.</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
	plusReady</span><span style="color:#ffffff">();</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span><span style="color:#ffffff">{</span><span style="color:#ffffff">
	document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
	<span style="color:#f0e68c"><strong></script></strong></span>
	<span style="color:#f0e68c"><strong></head></strong></span>
	<span style="color:#f0e68c"><strong><body></strong></span><span style="color:#ffffff">
		编辑框:</span><span style="color:#f0e68c"><strong><input</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text"</span> <span style="color:#bdb76b"><strong>placeholder</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"请输入"</span><span style="color:#f0e68c"><strong>></input><br/></strong></span>
		<span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">showSoftKeybord</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">显示软键盘</span><span style="color:#f0e68c"><strong></button><br/></strong></span>
	<span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span>
				</code></span></span>

uni-app使用plus注意事项

removeEventListener

移除按键事件监听器

<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">removeEventListener</span><span style="color:#ffffff">(</span> <span style="color:#f0e68c"><strong>event</strong></span><span style="color:#ffffff">,</span><span style="color:#ffffff"> listener </span><span style="color:#ffffff">);</span>
				</code></span></span>

说明:

从窗口移除指定的事件监听器。若没有查找到对应的事件监听器,则无任何作用。

参数:

  • event: KeyType ) 必选 要移除的事件类型

  • listener: KeyEventCallback ) 必选 要移除回调函数对象

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span>
	<span style="color:#f0e68c"><strong><head></strong></span>
	<span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span>
	<span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Key Example</span><span style="color:#f0e68c"><strong></title></strong></span>
	<span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> onback</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
	alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"BackButton Key pressed!"</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#87ceeb">// 监听“返回”按钮事件</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> addEventTest</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"backbutton"</span><span style="color:#ffffff">,</span><span style="color:#ffffff">onback</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#87ceeb">// 取消监听“返回”按钮事件</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> removeEventTest</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">removeEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"backbutton"</span><span style="color:#ffffff">,</span><span style="color:#ffffff">onback</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
	<span style="color:#f0e68c"><strong></script></strong></span>
	<span style="color:#f0e68c"><strong></head></strong></span>
	<span style="color:#f0e68c"><strong><body></strong></span>
		<span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">addEventTest</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">监听“返回”按键</span><span style="color:#f0e68c"><strong></button></strong></span>
		<span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">removeEventTest</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">取消监听“返回”按键</span><span style="color:#f0e68c"><strong></button></strong></span>
	<span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span>
				</code></span></span>

uni-app使用plus注意事项

KeyType

按键类型

常量:

  • "backbutton": (String 类型 )设备“返回”按钮按键事件

    如果需要改变默认“返回”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"backbutton"事件。

    平台支持

    • Android - 2.2+ (支持) :

      默认处理逻辑为退出应用。

    • iOS - ALL (支持) :

      标题栏的“返回”按钮点击时触发此事件。 默认不处理此事件。

  • "keydown": (String 类型 )键按下事件

    如果需要改变默认键按下的处理逻辑,则可通过plus.key.addEventListener来注册监听"keydown"事件。 可通过回调函数中KeyEvent对象的keyCode来获取按下的键值。

    平台支持

    • Android - 2.2+ (支持) :

      根据系统keydown事件触发,软键盘不会触发此事件。 默认处理逻辑由系统决定。

    • iOS - ALL (不支持) :

      不触发此事件。

  • "keyup": (String 类型 )键松开事件

    如果需要改变默认键松开的处理逻辑,则可通过plus.key.addEventListener来注册监听"keyup"事件。 可通过回调函数中KeyEvent对象的keyCode来获取松开的键值。

    平台支持

    • Android - 2.2+ (支持) :

      根据系统keyup事件触发,软键盘不会触发此事件。 默认处理逻辑由系统决定。

    • iOS - ALL (不支持) :

      不触发此事件。

  • "longpressed": (String 类型 )长按键事件

    如果需要改变默认长按键的处理逻辑,则可通过plus.key.addEventListener来注册监听"longpressed"事件。 长按键时会多次触发回调函数,通过回调函数中KeyEvent对象的keyCode来获取长按的键值。

    平台支持

    • Android - 2.2+ (支持) :

      根据系统keyup事件触发,软键盘不会触发此事件。 默认处理逻辑由系统决定。

    • iOS - ALL (不支持) :

      不触发此事件。

  • "menubutton": (String 类型 )设备“菜单”按钮按键事件

    如果需要改变默认“菜单”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"menubutton"事件。

    平台支持

    • Android - 2.2+ (支持) :

      默认处理逻辑无操作。

    • iOS - ALL (不支持) :

      不触发此事件。

  • "searchbutton": (String 类型 )设备“搜索”按钮按键事件

    如果需要改变默认“搜索”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"searchbutton"事件。

    平台支持

    • Android - 2.2+ (支持) :

      默认处理逻辑为打开系统搜索应用。

    • iOS - ALL (不支持) :

      不触发此事件。

  • "volumeupbutton": (String 类型 )设备“音量+”按钮按键事件

    如果需要改变默认“音量+”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumeupbutton"事件。

    平台支持

    • Android - 2.2+ (支持) :

      默认处理逻辑为增加系统音量。

    • iOS - ALL (不支持) :

      不触发此事件。

  • "volumedownbutton": (String 类型 )设备“音量-”按钮按键事件

    如果需要改变默认“音量-”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumedownbutton"事件。

    平台支持

    • Android - 2.2+ (支持) :

      默认处理逻辑为减少系统音量。

    • iOS - ALL (不支持) :

      不触发此事件。

KeyEvent

按键事件

属性:

  • keyCode: (Number 类型 )触发按键事件的键值

    键值由各系统平台定义,一些特殊按键在不同的设备上可能存在差异。

    <span style="background-color:#333333"><code>
    <span style="color:#cccccc"><!DOCTYPE html></span>
    <span style="color:#f0e68c"><strong><html></strong></span>
    	<span style="color:#f0e68c"><strong><head></strong></span>
    	<span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span>
    	<span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Key Example</span><span style="color:#f0e68c"><strong></title></strong></span>
    	<span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
    <span style="color:#87ceeb">// H5 plus事件处理</span>
    <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span>
    	<span style="color:#87ceeb">// 监听键按下事件</span><span style="color:#ffffff">
    	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"keydown"</span><span style="color:#ffffff">,</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
    		console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"keydown: "</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">keyCode</span><span style="color:#ffffff">);</span>
    	<span style="color:#ffffff">},</span><span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
    	<span style="color:#87ceeb">// 监听键松开事件</span><span style="color:#ffffff">
    	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"keyup"</span><span style="color:#ffffff">,</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
    		console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"keyup: "</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">keyCode</span><span style="color:#ffffff">);</span>
    	<span style="color:#ffffff">},</span><span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
    	<span style="color:#87ceeb">// 监听长按键事件</span><span style="color:#ffffff">
    	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">key</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"longpressed"</span><span style="color:#ffffff">,</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
    		console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"longpressed: "</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">keyCode</span><span style="color:#ffffff">);</span>
    	<span style="color:#ffffff">},</span><span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
    <span style="color:#ffffff">}</span>
    <span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">window</span><span style="color:#ffffff">.</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">){</span><span style="color:#ffffff">
    	plusReady</span><span style="color:#ffffff">();</span>
    <span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span><span style="color:#ffffff">{</span><span style="color:#ffffff">
    	document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"plusready"</span><span style="color:#ffffff">,</span><span style="color:#ffffff">plusReady</span><span style="color:#ffffff">,</span><span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
    <span style="color:#ffffff">}</span>
    	<span style="color:#f0e68c"><strong></script></strong></span>
    	<span style="color:#f0e68c"><strong></head></strong></span>
    	<span style="color:#f0e68c"><strong><body></strong></span><span style="color:#ffffff">
    		监听键事件</span><span style="color:#f0e68c"><strong><br/></strong></span>
    	<span style="color:#f0e68c"><strong></body></strong></span>
    <span style="color:#f0e68c"><strong></html></strong></span>
    						</code></span>
  • keyType: (KeyType 类型 )按键事件类型

    用于表明触发此按键事件的类型,值为KeyType中定义的值。

KeyEventCallback

按键事件的回调函数

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onKeyEvent</span><span style="color:#ffffff">(</span> <span style="color:#98fb98">KeyEvent</span> <span style="color:#f0e68c"><strong>event</strong></span> <span style="color:#ffffff">){</span>
	<span style="color:#87ceeb">// Event handled code.</span>
	<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> key</span><span style="color:#ffffff">=</span><span style="color:#f0e68c"><strong>event</strong></span><span style="color:#ffffff">.</span><span style="color:#ffffff">keyCode</span><span style="color:#ffffff">;</span> <span style="color:#87ceeb">// 用户按键的键值</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

参数:

  • event: KeyEvent ) 必选 监听用户按键操作返回的数据

    可通过event的keyCode属性(String类型)获取用户按键的类型,参考KeyType类型。

返回值:

void : 无

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值