sud.showToast
显示消息提示框。可通过 sud.hideToast 提前关闭。
javascript
sud.showToast(object);参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 提示文字 |
| icon | string | 否 | 图标类型,见下表;建议显式传入 |
| image | string | 否 | 自定义图标的本地文件路径,优先级高于 icon |
| duration | number | 否 | 提示显示时长,单位 ms;建议显式传入正数 |
| mask | boolean | 否 | 是否显示透明蒙层,阻止触摸穿透;建议显式传入 |
| success | function | 否 | 调用成功的回调,无额外结果字段 |
| fail | function | 否 | 调用失败的回调,参数见下文 |
| complete | function | 否 | 调用结束时执行,成功、失败均执行,不传入参数 |
icon 的合法值
| 值 | 说明 |
|---|---|
| success | 成功图标 |
| error | 失败图标 |
| loading | 加载图标 |
| none | 不显示图标 |
失败回调参数
| 属性 | 类型 | 说明 |
|---|---|---|
| errCode | number | 错误码 |
| errMsg | string | 错误说明 |
使用说明
使用前请确认目标 App 支持该界面能力。建议使用简短文字,并显式设置图标、显示时长和蒙层。成功回调表示提示调用成功,不表示提示已关闭。
示例
javascript
sud.showToast({
title: '保存成功',
icon: 'success',
duration: 2000,
mask: false,
fail(error) {
console.error('显示消息提示失败', error.errCode, error.errMsg);
}
});