Toast 轻提示
uni-appH5微信小程序App
跨端自动关闭轻提示,点击提示也可立即关闭。
何时使用
操作结果的轻量反馈:保存成功、网络异常、删除失败等,不打断用户流程。
何时不使用
需要用户确认或处理的内容用 Dialog;常驻的状态提示用 Alert/Banner。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
message | string | - | 提示文案(必填) |
type | string:'info' | 'success' | 'warning' | 'error' | "info" | 类型,决定左侧图标与颜色 |
duration | number | 2600 | 自动关闭时长(毫秒),0 表示不自动关闭 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
close | void | duration 到时后触发;showToast 内部据此卸载 DOM |
示例
成功提示
vue
<Button variant="primary" @click="show = true">保存</Button>
<Toast v-if="show" message="保存成功" type="success" @close="show = false" />错误提示
vue
<Button variant="danger" @click="show2 = true">提交</Button>
<Toast v-if="show2" message="网络异常,请稍后重试" type="error" @close="show2 = false" />普通信息
vue
<Button variant="secondary" @click="show3 = true">提示</Button>
<Toast v-if="show3" message="已复制到剪贴板" @close="show3 = false" />