Version: next

Taro.showToast(option)

显示消息提示框

注意

  • Taro.showLoading 和 Taro.showToast 同时只能显示一个
  • Taro.showToast 应与 Taro.hideToast 配对使用

参考文档

类型

(option: Option) => Promise<CallbackResult>

参数

Option

参数类型必填说明
title
string
提示的内容
complete
(res: CallbackResult) => void
接口调用结束的回调函数(调用成功、失败都会执行)
duration
number
提示的延迟时间
fail
(res: CallbackResult) => void
接口调用失败的回调函数
icon
"success" | "loading" | "none"
图标

可选值:
- 'success': 显示成功图标,此时 title 文本最多显示 7 个汉字长度;
- 'loading': 显示加载图标,此时 title 文本最多显示 7 个汉字长度;
- 'none': 不显示图标,此时 title 文本最多可显示两行
image
string
自定义图标的本地路径,image 的优先级高于 icon
mask
boolean
是否显示透明蒙层,防止触摸穿透
success
(res: CallbackResult) => void
接口调用成功的回调函数

示例代码

Taro.showToast({
title: '成功',
icon: 'success',
duration: 2000
})

API 支持度

API微信小程序H5React Native
Taro.showToast✔️✔️✔️