Events
Events模块管理客户端事件,包括系统事件,如扩展API加载完毕、程序前后台切换等。
常量:
- "plusready"扩展API加载完成事件
- "pause"运行环境从前台切换到后台事件
- "resume"运行环境从后台切换到前台事件
- "netchange"设备网络状态变化事件
- "newintent"新意图事件
- "plusscrollbottom"窗口滚动到底部事件
方法:
- addEventListener添加事件监听函数
回调方法:
- EventTrigCallback事件触发回调
addEventListener
添加事件监听函数
void document.addEventListener( event, callback, capture );
说明:
通过Html中标准document对象的addEventListener方法添加扩展事件监听器,当指定事件发生时,将触发对应额监听回调函数。
参数:
- event (DOMString) 可选 要添加监听的事件类型,可取上面列出的所有事件常量
- callback (EventTrigCallback) 可选 扩展API加载完毕触发的回调函数
- capture (Boolean) 可选 事件流捕获顺序,可忽略
返回值:
无
"plusready"
扩展API加载完成事件
document.addEventListener( "plusready", plusreadyCallback, capture );
说明:
为了保证扩展API的有效调用,所有应用页面都会用到的重要事件。 应用页面显示时需要首先加载扩展和API代码库,当扩展API代码库加载完成时会触发pluseready事件,当设备触发该事件后,用户就可以安全的调用扩展API。 如果程序中打开多个页面,每个都会收到此事件。
"pause"
运行环境从前台切换到后台事件
document.addEventListener( "pause", pauseCallback, capture );
说明:
当程序从前台切换到后台时会触发此事件。 若应用需要处理从前台切换到后台的事件行为,可通过注册事件监听器来监听“pause”事件,此事件需要在plusready事件后通过document进行注册。
"resume"
运行环境从后台切换到前台事件
document.addEventListener( "resume", resumeCallback, capture );
说明:
当程序从后台切换到前台时会触发此事件。 若应用需要处理从后台切换到前台的事件行为,可通过注册事件监听器来监听“resume”事件,此事件需要在plusready事件后通过document进行注册。
"netchange"
设备网络状态变化事件
document.addEventListener( "netchange", netchangeCallback, capture );
说明:
设备网络状态发生时会触发此事件。 若应用需要处理网络状态变化的事件行为,可通过注册事件监听器来监听“netchange”事件,此事件需要在plusready事件后通过document进行注册。
"newintent"
新意图事件
document.addEventListener( "newintent", newintentCallback, capture );
说明:
程序从后台被第三方程序调用并传入新意图事件。 此时程序将切换到前台运行,若应用需要处理新意图的事件行为,可通过注册事件监听器来监听“newintent”事件,此事件需要在plusready事件后通过document进行注册。
"plusscrollbottom"
窗口滚动到底部事件
document.addEventListener( "plusscrollbottom", eventCallback, capture );
说明:
当滚动Webview窗口到底部时触发此事件。
关键词: html5puls,Events 编辑时间: 2015-03-23 22:55:14
0
高兴0
支持0
搞笑0
不解0
谎言0
枪稿0
震惊0
无奈0
无聊0
反对0
愤怒
- 暂无评论
网友评论