Skip to main content
Version: 3.x

Taro.showToast(option)

显示消息提示框

注意

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

支持情况:

参考文档

类型

(option?: Option) => Promise<TaroGeneral.CallbackResult>

参数

参数类型
optionOption

Option

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

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

示例代码

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