跳到主要内容

Notification 通知 ​

uni-appH5微信小程序App

uni-app 跨端通知提醒框。右上角滑入的白底卡片(左侧类型色图标 + 标题 + 正文),duration 后右滑出并触发 close,由外层卸载;duration 为 0 时不自动关闭。

何时使用 ​

系统级或异步任务的被动通知:任务完成、消息到达、后台失败等,需要标题+正文的较重组件反馈。

何时不使用 ​

一句话轻量反馈用 Toast;需要用户确认处理用 Dialog。

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

9:41
Notification 通知 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
titlestring""标题
messagestring""正文内容
typestring:'info' | 'success' | 'warning' | 'error'"info"类型,决定左侧图标与颜色
durationnumber4500自动关闭时长(毫秒),0 表示不自动关闭
closablebooleantrue是否显示右上角关闭按钮

Events ​

名称载荷说明
closevoid滑出动画结束后触发,外层据此移除组件

示例 ​

系统通知 ​

vue
<Button variant="primary" @click="show = true">触发通知</Button>
<Notification v-if="show" title="审核通过" message="你提交的组件已进入发布流程。" type="success" @close="show = false" />

警告通知 ​

vue
<Button variant="secondary" @click="show2 = true">警告通知</Button>
<Notification v-if="show2" title="存储即将耗尽" message="请在 24 小时内清理日志文件。" type="warning" @close="show2 = false" />

持久通知 ​

vue
<Button variant="ghost" @click="show3 = true">持久通知</Button>
<Notification v-if="show3" title="维护窗口" message="本通知不会自动关闭。" type="info" :duration="0" @close="show3 = false" />