Skip to content

页面事件绑定

JS-SDK提供方法用于绑定设备的一些场景操作事件,例如安卓设备特有的物理返回按钮(或虚拟按钮),绑定后,可以在回调方法内处理特定的逻辑。

事件监听

一旦调用该接口,将会监控页面上的pause(页面离开)resume(页面可见)back(安卓的物理返回事件,iOS为页面右滑)事件,可以通过返回数据里的action来区分事件类型。

注意,该方法调用后,事件对应的原始行为动作不会被重置。此外,该方法不支持取消绑定。

使用说明

客户端AndroidiOS
支持情况支持支持
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;
  }
});

安卓物理返回按钮

绑定安卓设备的物理返回按钮,绑定后,原始返回动作将无效。

使用说明

客户端AndroidiOS
支持情况支持不支持
js
// 单个 WebView 中只需要绑定一次
w6s.event.bindBackButtonEvent(() => {
  // 此处处理返回的逻辑
});

// 解除绑定
w6s.event.unbindBackButtonEvent();

关于返回

在 WebView 中,物理返回按钮会以标准的浏览器访问记录进行页面退回,但是往往在开发单页面应用(SPA)时,返回事件可能会让整个应用退出,此时可以通过绑定物理返回按钮事件,正确地处理页面切换。

页面离开

当页面不可见时,WorkPlus 会产生回调,开发者可以监听此pause事件,并处理特定的业务逻辑。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.event.bindPauseEvent(() => {
  // 此处执行特定逻辑
});

页面返回

当页面重新可见并可交互时,WorkPlus 会产生回调,开发者可监听此resume事件,并处理特定的业务逻辑。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.event.bindResumeEvent(() => {
  // 此处执行特定逻辑
});