界面组件

导航栏配置

setNavBar (6.0.0及以上)
settingNavBar (即将废弃)
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✔︎

参数

字段 类型 默认值 必填 说明
hide int 0 否 是否隐藏导航栏，1隐藏 0 不隐藏，【iOS需要注意修改的是全局导航，遵循谁修改谁负责还原】
backgroundColor string
否 导航条背景色
tintColor string
否 导航栏上按钮、标题等的颜色统一设置
fullScreen number 0 否 是否调整webview内边距(仅iOS)
hideShadowImage number 0 否 是否显示导航栏底部线(仅iOS)
statusBarStyle number 0 否 状态栏样式(仅iOS)
leftItems array.
否 导航栏左边的菜单项
centerItems array.
否 导航栏中间的菜单项
rightItems array.
否 导航栏右边的菜单项

leftItems、centerItems、rightItems的内部结构字段说明

名称 类型 默认值 必填 说明
title string
否 按钮文字
subTitle string
否 副标题
titleColor string tintColor颜色 否 文字颜色
subTitleColor string tintColor颜色 否 副标题颜色
fontSize number 1 否 字体大小类型（0：小 1：中 2：大）
iconColor string tintColor颜色 否 按钮颜色
titlePosition number 0 否 文字与图片位置（iOS：仅值为0或1时可同时配置副标题）
icon string
否 按钮图片
callback string
否 菜单项回调 （为空不需要回调）

入参说明

参数 类型 说明
backgroundColor string 颜色需要6位16进制格式（例如：#ffffff)
tintColor string 颜色需要6位16进制格式（例如：#ffffff)
fullScreen number 0调整webview内边距，1关闭调整webview内边距属性
hideShadowImage number 导航栏底部线：0:显示 1:不显示 (仅iOS)
statusBarStyle number 状态栏样式：0:黑色 1:白色
参数 类型 说明
titleColor string 颜色需要6位16进制格式（例如：#ffffff)
iconColor string 颜色需要6位16进制格式（例如：#ffffff)
titlePosition number 文字与图片同时存在，0:文字在icon右边 1:文字在icon左边
icon string 若是网络图片，需要传背景透明的图片，否则图片整体会为灰色

示例

mtl.setNavBar({
  hide: 0,
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

获取原生导航信息

getNavBarInfo
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数
-无-

成功回调返回

字段 类型 说明
isNativeNavBar bool false 否， true 是
height number 导航高度

示例

mtl.getNavBarInfo({
  success: function(res) {
    // 成功回调
    var isNativeNavBar = res.isNativeNavBar;
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

信息提示框

showToast
注：android系统只支持固定的长提示（3.5s）和短提示（2s）两种。
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
content string 是 需要显示的文本内容
duration number 否 显示时长

示例

mtl.showToast({
  content: '文本',
  duration: 2,
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

警告框

showAlert
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
type string 否 弹窗类型。

| | title | string | 否 | alert框的标题 | | content | string | 是 | alert框的内容 | | confirmButtonText | string | 否 | 左侧按钮的文字 | | cancelButtonText | string | 否 | 右侧按钮的文字 |

type参数说明

值 说明
alert 只有一个按钮的弹窗，只显示confirmButtonText（cancelButtonText不用传参）
confirm 显示两个按钮的弹窗，左侧按钮文本：confirmButtonText
右侧按钮文本：cancelButtonText

成功回调返回

字段 类型 说明
selectButton string 点击 confirm 返回 "confirm"，点击 cancel 返回"cancel"

示例

mtl.showAlert({
  type: 'alert',
  title: '温馨提示',
  content:'消息已发出',
  confirmButtonText: '我知道了',
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

打开新的浏览窗体

navigateTo
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
url string 是 新浏览器窗体加载的url
orientation number 否 0 强制竖屏; 1 跟随系统; 2 强制横屏(微信不支持)
navShow number 否 0：不显示顶部导航栏 1：显示顶部导航栏(微信不支持)，默认1
title sting 否 导航标题(微信不支持)

示例

mtl.navigateTo({
  url: 'https://www.***.com',
  orientation: 1,
  navShow:0,
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

关闭当前浏览窗体

navigateBack
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数
-无-
示例

mtl.navigateBack({
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

打开新的浏览窗体，并关闭当前页面

redirectTo

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 默认 说明
url string 是 新浏览器窗体加载的url
orientation number 否 1 0 强制竖屏; 1 跟随系统; 2 强制横屏(微信不支持)
isClearCookie number 否 0 是否清除cookie。0 否；1 是(微信不支持)
navShow number 否 1 0：不显示顶部导航栏 1：显示顶部导航栏(微信不支持)
title sting 否 导航标题(微信不支持)

示例

mtl.redirectTo({
  url: 'https://www.***.com',
  orientation: 1,
  navShow:0,
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

打开新的浏览窗体，关闭前面所有页面

reLaunch

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 默认 说明
url string 是 新浏览器窗体加载的url
orientation number 否 1 0 强制竖屏; 1 跟随系统; 2 强制横屏(微信不支持)
isClearCookie number 否 0 是否清楚cookie。0 否；1 是(微信不支持)
navShow number 否 1 0：不显示顶部导航栏 1：显示顶部导航栏(微信不支持)
title sting 否 导航标题(微信不支持)

示例

mtl.reLaunch({
  url: 'https://www.***.com',
  orientation: 1,
  navShow:0,
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

当前页面打开url

webviewLoadUrl

支持平台

微信 友空间 安卓 iOS
✔︎ ✘ ✔︎ ✔︎

参数

字段 类型 默认值 必填 说明
url sting 无 是 接口请求域名

示例

mtl.webviewLoadUrl({
  url: '',
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

打开应用

openExclusiveApp

支持平台

微信 友空间 安卓 iOS
✔︎ ✘ ✔︎ ✔︎

参数

字段 类型 默认值 必填 说明
appletExtId sting 无 否 小程序与MDF小程序资源包id
appletVersion sting 无 否 小程序与MDF小程序资源包版本号
extId sting 无 否 gzip资源包id
gzipVersion sting 无 否 gzip资源包版本号
serviceCode sting 无 是 应用编码
app_type int 无 是 应用类型
serviceIcon sting 无 是 应用icon
serviceName sting 无 是 应用名
tenantId sting 无 是 要打开应用所在的租户id
serviceId sting 无 是 应用唯一标识符
appUrl sting 无 是 应用打开URL
appletPackageType sting 无 是 应用类型
packageType sting 无 是 应用类型
appletUrl sting 无 否 小程序拼接URL
navShow sting 无 否 是否显示导航栏，1显示，2不显示
supportHorizontal int 无 否 横竖屏，0竖屏，1横竖屏均支持，2横屏
tintColor sting 无 否 导航条颜色
titleColor sting 无 否 导航条字体颜色
statusBarStyle int 无 0 状态栏颜色
isbrowser sting 无 否 是否使用外部浏览器打开

微信仅支持 appUrl

示例

mtl.openExclusiveApp({
  appletExtId: '',
  ...
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

获取字体大小

getUserFontSize

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✔︎

参数
-无-
返回参数说明

字段 类型 默认值 说明
level int 1 字体大小
0:移动端字体14；1:移动端字体16；2:移动端字体18；
3:移动端字体20；4:移动端字体22；5:移动端字体24

示例

mtl.getUserFontSize({
  success: function(res) {
    // 成功回调
        ver level = res.level
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

设置字体大小

setUserFontSize

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✔︎

参数

字段 类型 默认值 说明
level int 1 字体大小
0:移动端字体14；1:移动端字体16；2:移动端字体18；
3:移动端字体20；4:移动端字体22；5:移动端字体24

示例

mtl.setUserFontSize({
  level: 1,
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

webView配置

configureWebView

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
pullDownRefresh bool 否 是否开启下拉刷新
pullUpRefresh bool 否 是否开启上拉刷新|
scrollViewBounces bool 否 是否允许WebView弹簧效果，true允许，false不允许，如果设置了上拉或下拉，则强制允许（友空间iOS特有，友空间7.0.5及以上版本）

示例

mtl.configureWebView({
  pullDownRefresh: false,
  pullUpRefresh: false,
  scrollViewBounces: false,
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});
是否仍需要帮助？ 请保持联络！
最后更新于 2026/04/24