tt.showToast

从基础库 1.0.0 开始支持。

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

语法

tt.showToast(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
titlestring内容1.0.0
iconstringsuccess图标,取值范围包括success,loading, none,fail1.0.0
durationnumber1500提示框停留时间,单位ms1.0.0
successFunction接口调用成功后的回调函数1.0.0
failFunction接口调用失败后的回调函数1.0.0
completeFunction接口调用结束后的回调函数(调用成功、失败都会执行)1.0.0

icon 为 string 类型,枚举值如下:

说明最低支持版本
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扫码

代码示例

开发者工具中预览

tt.showToast({
  title: "添加购物车成功",
  duration: 2000,
  success(res) {
    console.log(`${res}`);
  },
  fail(res) {
    console.log(`showToast 调用失败`);
  },
});

Bug & Tip

  • Tip:暂不支持自定义图标和透明遮罩
  • Tip:多次弹出 toast 时,后一个会立刻覆盖前一个
  • Tip:当显示图标时,最多能够展示 8 个汉字长度。不显示图标时,文本可最多展示 2 行
点击纠错
评价此篇文档