原生UI

confirm

创建并显示系统样式确认对话框,可设置确认对话框的标题、内容、按钮数目及其文字。 弹出的确认对话框为非阻塞模式,用户点击确认对话框上的按钮后关闭,并通过callBack回调函数通知用户点击的按钮索引值。

支持平台

微信 钉钉 友空间 原生 HTML5
✔︎

参数

字段 类型 必填 说明
message string 确认对话框上显示的内容
title string 对话框的标题
buttons Array 两个按钮,默认“取消”和“确认”,可自定义,如["NO","YES"]

返回值
-无-

示例

mtl.mobile.confirm({
  message: "你好",
  title:"提示",
  buttons:["NO","YES"],
  success: function(res) {
    var index = res.index; // index为0表示点击了第一个按钮,1表示点击了第二个按钮
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

lockOrientation

锁定屏幕方向后屏幕只能按锁定的屏幕方向显示,关闭当前页面后仍然有效。 可再次调用此方法修改屏幕锁定方向或调用unlockOrientation()方法恢复到应用的默认值。

支持平台

微信 钉钉 友空间 Android iOS HTML5
✔︎ ✔︎

参数

字段 类型 必填 说明
orientation string 取值:
"portrait": 竖屏方向;
"landscape-right": 横屏正方向,屏幕正方向按顺时针旋转90°; "landscape-left": 横屏反方向,屏幕正方向按顺时针旋转270°; "landscape": 横屏正方向或反方向,根据设备重力感应器自动调整

返回
-无-

示例

mtl.lockOrientation({
  orientation:'portrait',
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

unlockOrientation

解除锁定屏幕方向后将恢复应用默认的屏幕显示方向(通常为应用打包发布时设置的方向)。

支持平台

微信 钉钉 友空间 Android iOS HTML5
✔︎ ✔︎

参数
-无-

返回
-无-

示例

mtl.unlockOrientation();

setStatusBarBackground

设置应用在前台运行时系统状态栏的背景颜色,默认使用系统状态栏默认背景色(由系统状态栏样式及应用的主题决定)。 通常系统状态栏的前景色为白色或黑色,所以避免设置接近白色或黑色的颜色值。 注意:如果应用设置为沉浸式状态栏样式,则无法设置状态栏的背景颜色。

支持平台

微信 钉钉 友空间 原生 HTML5
✔︎

Android - 5.0+ (支持): Android5.0及以上版本生效。
iOS - 7.0+ (支持): iOS7.0-iOS12.4版本生效,iOS13以上不生效

参数

字段 类型 必填 说明
color string 颜色值格式为"#RRGGBB",如"#FF0000"为红色,默认颜色由系统状态栏样式决定


返回值
-无-

示例

mtl.setStatusBarBackground({
  color: "#FF0000",
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

setStatusBarStyle

保设置应用在前台运行时系统状态栏的样式

支持平台

微信 钉钉 友空间 原生 HTML5
✔︎


**参数**
字段 类型 必填 说明
style string 可取值:
"dark":深色前景色样式(即状态栏前景文字为黑色),此时background建议设置为浅颜色;
"light":浅色前景色样式(即状态栏前景文字为白色),此时background建设设置为深颜色;


返回值
-无-

示例

mtl.setStatusBarStyle({
  style: "dark",
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

setFullscreen

设置应用是否全屏显示

设置应用在全屏模式显示时,将隐藏系统状态栏,通常游戏类应用才会设置为全屏模式显示

支持平台

微信 钉钉 友空间 原生 HTML5
✔︎


**参数**
字段 类型 必填 说明
fullscreen bool 可取值:
true表示全屏模式显示,
false表示非全屏模式显示,默认为非全屏模式显示


返回值
-无-

示例

mtl.setFullscreen({
  fullscreen: false,
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});