Toast 轻提示
WebH5
轻提示。桌面端为顶部居中的白底卡片(左侧彩色图标),移动端(≤767px)自动切换为深色半透明胶囊。推荐用 showToast 服务式调用:showToast('保存成功') 或 showToast({ message: '删除失败', type: 'error', duration: 3000 }),duration 为 0 时不自动关闭;closeAllToasts() 可关闭全部。
何时使用
操作结果的轻量反馈:保存成功、网络异常、删除失败等,不打断用户流程。
何时不使用
需要用户确认或处理的内容用 Dialog;常驻的状态提示用 Alert/Banner。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
message | string | "" | 提示文案(必填) |
type | string:'info' | 'success' | 'warning' | 'error' | "info" | 类型,决定左侧图标与颜色 |
duration | number | 2600 | 自动关闭时长(毫秒),0 表示不自动关闭 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
close | void | duration 到时后触发;showToast 内部据此卸载 DOM |
示例
服务式调用(推荐)
示例加载中…
关闭全部
示例加载中…
组件式用法
示例加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Toast 文档(含手机预览)。