uni.showModal(options)
显示模态弹窗,可以只有一个确定按钮,也可以同时有确定和取消按钮。类似于一个API整合了 html 中:alert、confirm。
参数
ShowModalOptions 属性值
名称 | 类型 | 必备 | 默认值 | 描述 |
title | string | 否 | - | 提示的标题 |
content | string | 否 | - | 提示的内容 |
showCancel | boolean | 否 | true |
是否显示取消按钮,默认为 true | |
cancelText | string | 否 | - | 取消按钮的文字,默认为"取消" |
cancelColor | string | 否 | - | 取消按钮的文字颜色,默认为"#000000" |
confirmText | string | 否 | - | 确定按钮的文字,默认为"确定" |
confirmColor | string | 否 | - | 确定按钮的文字颜色 |
editable | boolean | 否 | false |
是否显示输入框 | |
placeholderText | string | 否 | - | 显示输入框时的提示文本 |
success | (res: ShowModalSuccess) => void | 否 | - | 接口调用成功的回调函数 |
fail | (res: UniError) => void | 否 | - | 接口调用失败的回调函数 |
complete | (res: any) => void | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
ShowModalSuccess 属性值
名称 | 类型 | 必备 | 默认值 | 描述 |
confirm | boolean | 是 | - | 为 true 时,表示用户点击了确定按钮 |
cancel | boolean | 是 | - | 为 true 时,表示用户点击了取消(用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭) |
content | string | 否 | - | editable 为 true 时,用户输入的文本 |
showModal 兼容性
安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
4.4.4 | √ | 3.9.0 | 9.0 | √ | 3.9.0 |
参见
showModal
通用类型
GeneralCallbackResult
名称 | 类型 | 必备 | 默认值 | 描述 |
errMsg | string | 是 | - | 错误信息 |