界面控制

控制导航栏

matrix.setNavBarVisible(params)

显示或隐藏顶部导航栏。隐藏后进入沉浸式模式，返回按钮和右上角操作会以悬浮形式显示。此接口无需 config 即可调用。

请求参数

调用示例

// 隐藏导航栏（完全沉浸式，默认）
matrix.setNavBarVisible({
  visible: false,
  onSuccess: function() {
    console.log('导航栏已隐藏');
  },
  onFail: function(error) {
    console.error('操作失败:', error.message);
  }
});

// 隐藏导航栏（非沉浸式，保留状态栏安全区域）
matrix.setNavBarVisible({
  visible: false,
  immersive: false,
  onSuccess: function() {
    console.log('导航栏已隐藏');
  },
  onFail: function(error) {
    console.error('操作失败:', error.message);
  }
});

控制菜单项

matrix.setMenuItemsVisible(params)

批量显示或隐藏指定的菜单项。此接口无需 config 即可调用。

请求参数

菜单项标识

调用示例

// 隐藏返回按钮和更多按钮
matrix.setMenuItemsVisible({
  items: ['menu_back', 'menu_more'],
  visible: false,
  onSuccess: function() {
    console.log('菜单项已隐藏');
  },
  onFail: function(error) {
    console.error('操作失败:', error.message);
  }
});

进入浮窗

matrix.setWindowFloating(params)

将当前 WebView 页面切换为系统浮窗，效果与点击更多菜单中的“浮窗”一致。当前网页、应用上下文以及 JSSDK 设置的导航栏和菜单状态会在恢复时保留。此接口无需 config 即可调用。

请求参数

调用示例

matrix.setWindowFloating({
  onSuccess: function() {
    console.log('当前页面已进入浮窗');
  },
  onFail: function(error) {
    console.error('进入浮窗失败:', error.message);
  }
});

关闭页面

matrix.closeApp(params)

关闭当前 WebView 页面。此接口无需 config 即可调用。

请求参数

调用示例

matrix.closeApp({
  onSuccess: function() {
    console.log('页面即将关闭');
  },
  onFail: function(error) {
    console.error('关闭失败:', error.message);
  }
});

浏览器打开链接

matrix.openInBrowser(params)

使用系统默认浏览器打开指定 URL。此接口无需 config 即可调用。

请求参数

调用示例

matrix.openInBrowser({
  url: 'https://www.example.com',
  onSuccess: function() {
    console.log('已打开浏览器');
  },
  onFail: function(error) {
    console.error('打开失败:', error.message);
  }
});