wx.showToast(Object object)

显示消息提示框。

参数

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为空字符串显示方式不一致