Skip to content

sud.showToast ​

显示消息提示框。可通过 sud.hideToast 提前关闭。

javascript
sud.showToast(object);

参数 ​

属性类型必填说明
titlestring是提示文字
iconstring否图标类型,见下表;建议显式传入
imagestring否自定义图标的本地文件路径,优先级高于 icon
durationnumber否提示显示时长,单位 ms;建议显式传入正数
maskboolean否是否显示透明蒙层,阻止触摸穿透;建议显式传入
successfunction否调用成功的回调,无额外结果字段
failfunction否调用失败的回调,参数见下文
completefunction否调用结束时执行,成功、失败均执行,不传入参数

icon 的合法值 ​

值说明
success成功图标
error失败图标
loading加载图标
none不显示图标

失败回调参数 ​

属性类型说明
errCodenumber错误码
errMsgstring错误说明

使用说明 ​

使用前请确认目标 App 支持该界面能力。建议使用简短文字,并显式设置图标、显示时长和蒙层。成功回调表示提示调用成功,不表示提示已关闭。

示例 ​

javascript
sud.showToast({
  title: '保存成功',
  icon: 'success',
  duration: 2000,
  mask: false,
  fail(error) {
    console.error('显示消息提示失败', error.errCode, error.errMsg);
  }
});