显示消息提示框。
参数
Object object
属性 |
类型 |
默认值 |
必填 |
说明 |
title |
string |
无 |
是 |
提示的内容 |
icon |
string |
‘success’ |
否 |
图标 |
image |
string |
|
否 |
自定义图标的本地路径,image 的优先级高于 icon |
duration |
number |
1500 |
否 |
提示的延迟时间 |
mask |
boolean |
false |
否 |
是否显示透明蒙层,防止触摸穿透 |
success |
function |
无 |
否 |
接口调用成功的回调函数 |
fail |
function |
无 |
否 |
接口调用失败的回调函数 |
complete |
function |
无 |
否 |
接口调用结束的回调函数(调用成功、失败都会执行) |
object.icon 的合法值
值 |
说明 |
success |
显示成功图标,此时 title 文本最多显示两行 |
loading |
显示加载图标,此时 title 文本最多显示两行 |
none |
不显示图标,此时 title 文本最多可显示两行 |
示例代码
wx.showToast({ title: '成功', icon: 'success', duration: 2000 })
|
注意
- wx.showLoading 和 wx.showToast 同时只能显示一个
- wx.showToast 应与 wx.hideToast 配对使用
多平台支持
属性 |
平台支持 |
title |
支付宝 |
icon |
支付宝 |
image |
|
duration |
支付宝 |
mask |
|
success |
支付宝 |
fail |
支付宝 |
complete |
支付宝 |
注释:
支付宝的icon属性不支持loading,toast默认遮罩层,对title文字长度过长时、title为空字符串显示方式不一致