主题
页面事件绑定
JS-SDK
提供方法用于绑定设备的一些场景操作事件,例如安卓设备特有的物理返回按钮(或虚拟按钮),绑定后,可以在回调方法内处理特定的逻辑。
事件监听
一旦调用该接口,将会监控页面上的pause(页面离开)
、resume(页面可见)
和back(安卓的物理返回事件,iOS为页面右滑)
事件,可以通过返回数据里的action
来区分事件类型。
注意,该方法调用后,事件对应的原始行为动作不会被重置。此外,该方法不支持取消绑定。
使用说明
客户端 | Android | iOS |
---|---|---|
支持情况 | 支持 | 支持 |
js
w6s.event.bindMessageChannel((result: any) => {
/** 返回的事件类型 */
// action: 'pause' | 'resume' | 'back';
switch (result.action) {
case 'pause':
alert('页面离开');
break;
case 'resume':
alert('页面返回');
break;
case 'back':
alert('触发了物理返回事件');
break;
default:
break;
}
});
安卓物理返回按钮
绑定安卓设备的物理返回按钮,绑定后,原始返回动作将无效。
使用说明
客户端 | Android | iOS |
---|---|---|
支持情况 | 支持 | 不支持 |
js
// 单个 WebView 中只需要绑定一次
w6s.event.bindBackButtonEvent(() => {
// 此处处理返回的逻辑
});
// 解除绑定
w6s.event.unbindBackButtonEvent();
关于返回
在 WebView 中,物理返回按钮会以标准的浏览器访问记录进行页面退回,但是往往在开发单页面应用(SPA)时,返回事件可能会让整个应用退出,此时可以通过绑定物理返回按钮事件,正确地处理页面切换。
页面离开
当页面不可见时,WorkPlus 会产生回调,开发者可以监听此pause事件
,并处理特定的业务逻辑。
使用说明
客户端 | Android | iOS |
---|---|---|
支持情况 | 支持 | 支持 |
js
w6s.event.bindPauseEvent(() => {
// 此处执行特定逻辑
});
页面返回
当页面重新可见并可交互时,WorkPlus 会产生回调,开发者可监听此resume事件
,并处理特定的业务逻辑。
使用说明
客户端 | Android | iOS |
---|---|---|
支持情况 | 支持 | 支持 |
js
w6s.event.bindResumeEvent(() => {
// 此处执行特定逻辑
});