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