界面组件

导航栏配置

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.xxx.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.xxx.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.xxx.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; // 错误信息
  }
});

是否仍需要帮助? 请保持联络!
最后更新于 2024/12/2