tt.showToast
从基础库 1.0.0 开始支持。
显示灰色背景的消息提示框,用以提供成功、警告和错误等反馈信息。
语法
tt.showToast(options)
参数说明
options
为 object 类型,属性如下:
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
title | string | 是 | 内容 | 1.0.0 | |
icon | string | success | 否 | 图标,取值范围包括success ,loading , none ,fail | 1.0.0 |
duration | number | 1500 | 否 | 提示框停留时间,单位ms | 1.0.0 |
success | Function | 否 | 接口调用成功后的回调函数 | 1.0.0 | |
fail | Function | 否 | 接口调用失败后的回调函数 | 1.0.0 | |
complete | Function | 否 | 接口调用结束后的回调函数(调用成功、失败都会执行) | 1.0.0 |
icon
为 string 类型,枚举值如下:
值 | 说明 | 最低支持版本 |
---|---|---|
success | 成功 | 1.0.0 |
loading | 加载中 | 1.0.0 |
none | 不显示图标 | 1.0.0 |
fail | 失败 | 1.36.0 |
回调成功
object 类型,属性如下
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "showToast:ok" | 1.0.0 |
回调失败
object 类型,属性如下
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "showToast:fail " + 详细错误信息 | 1.0.0 |
效果示例

扫码体验
请使用字节宿主APP扫码
代码示例
tt.showToast({
title: "添加购物车成功",
duration: 2000,
success(res) {
console.log(`${res}`);
},
fail(res) {
console.log(`showToast 调用失败`);
},
});
Bug & Tip
- Tip:暂不支持自定义图标和透明遮罩
- Tip:多次弹出 toast 时,后一个会立刻覆盖前一个
- Tip:当显示图标时,最多能够展示 8 个汉字长度。不显示图标时,文本可最多展示 2 行
点击纠错
评价此篇文档