wx.showModal(Object object)

本接口从基础库版本 1.9.6 起支持在小程序插件中使用

显示模态对话框

参数

Object object

属性类型默认值必填说明最低版本
titlestring提示的标题
contentstring提示的内容,editable 为 true 时,会输入框默认文本
editablebooleanfalse是否显示输入框2.15.0
placeholderTextstring输入框提示文本2.15.0
showCancelbooleantrue是否显示取消按钮
cancelTextstring‘取消’取消按钮的文字,最多 4 个字符
cancelColorstring#000000取消按钮的文字颜色,必须是 16 进制格式的颜色字符串
confirmTextstring‘确定’确认按钮的文字,最多 4 个字符
confirmColorstring#576B95确认按钮的文字颜色,必须是 16 进制格式的颜色字符串
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数
Object res
属性类型说明最低版本
contentstringeditable 为 true 时,用户输入的文本
confirmboolean为 true 时,表示用户点击了确定按钮
cancelboolean为 true 时,表示用户点击了取消(用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭)1.1.0

示例代码

  1. wx.showModal({
  2. title: '提示',
  3. content: '这是一个模态弹窗',
  4. success (res) {
  5. if (res.confirm) {
  6. console.log('用户点击确定')
  7. } else if (res.cancel) {
  8. console.log('用户点击取消')
  9. }
  10. }
  11. })

注意

  • Android 6.7.2 以下版本,点击取消或蒙层时,回调 fail, errMsg 为 “fail cancel”;
  • Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗,所以尽量避免使用「取消」分支中实现业务逻辑