跳到主要内容

Toast 轻提示 ​

uni-appH5微信小程序App

跨端自动关闭轻提示,点击提示也可立即关闭。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Toast 轻提示 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

名称载荷说明
closevoidduration 到时后触发;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" />