tt.showToast
收藏
我的收藏

基础库 1.0.0 开始支持本方法,这是一个异步方法。

显示灰色背景的消息提示框,用以提供成功、警告和错误等反馈信息。

前提条件
业务背景
使用限制
注意事项
  • 多次弹出 toast 时,后一个会立刻覆盖前一个;
  • 当显示图标时,最多能够展示 8 个汉字长度。不显示图标时,文本可最多展示 2 行。
支持沙盒
相关教程

语法

tt.showToast(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
imagestring
自定义图标的本地路径,image 的优先级高于 icon
2.62.0
maskbooleanfalse
是否显示透明蒙层,防止触摸穿透
2.47.0
durationnumber1500
提示框停留时间,单位`ms`
1.0.0
iconstringsuccess
图标,取值范围包括`success`,`loading`, `none`,`fail`
1.0.0
titlestring
内容
1.0.0
successfunction
接口调用成功的回调函数
1.0.0
failfunction
接口调用失败的回调函数
1.0.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
1.0.0

icon 参数说明

说明

最低支持版本

success

成功

1.0.0

loading

加载中

1.0.0

none

不显示图标

1.0.0

fail

失败

1.36.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"showToast:ok"
1.0.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"showToast:fail" + 详细错误信息
1.0.0

扫码体验

请使用字节宿主APP扫码

代码示例