• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 交互反馈
  • tt.enableAlertBeforeUnload
  • tt.showToast
  • tt.hideToast
  • tt.showLoading
  • tt.hideLoading
  • tt.showModal
  • tt.showActionSheet
  • tt.showFavoriteGuide
  • tt.showInteractionBar
  • tt.hideInteractionBar
  • tt.disableAlertBeforeUnload
  • 导航栏
  • 菜单
  • 动画
  • 页面位置
  • 滑动返回
  • 下拉刷新
  • 键盘
  • TabBar
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • 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扫码

    代码示例