跳到主要内容

Toast 轻提示 ​

WebH5

轻提示。桌面端为顶部居中的白底卡片(左侧彩色图标),移动端(≤767px)自动切换为深色半透明胶囊。推荐用 showToast 服务式调用:showToast('保存成功') 或 showToast({ message: '删除失败', type: 'error', duration: 3000 }),duration 为 0 时不自动关闭;closeAllToasts() 可关闭全部。

何时使用 ​

操作结果的轻量反馈:保存成功、网络异常、删除失败等,不打断用户流程。

何时不使用 ​

需要用户确认或处理的内容用 Dialog;常驻的状态提示用 Alert/Banner。

Props ​

名称类型默认值说明
messagestring""提示文案(必填)
typestring:'info' | 'success' | 'warning' | 'error'"info"类型,决定左侧图标与颜色
durationnumber2600自动关闭时长(毫秒),0 表示不自动关闭

Events ​

名称载荷说明
closevoidduration 到时后触发;showToast 内部据此卸载 DOM

示例 ​

服务式调用(推荐) ​

示例加载中…

关闭全部 ​

示例加载中…

组件式用法 ​

示例加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Toast 文档(含手机预览)。