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✔️✔️✔️
Edit this page