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 行
点击纠错
评价此篇文档