NoticeBar 通知栏
uni-appH5微信小程序App
跨端通知提示条,支持信息、警告、危险类型和关闭操作。
何时使用
页面顶部的系统公告、维护通知、风险提示等需要持续展示的信息。
何时不使用
操作结果的即时反馈用 Toast;需要用户确认处理的用 Dialog。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
NoticeBar 通知栏 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
type | string:'info' | 'warning' | 'danger' | "info" | 类型,对应 soft 底色 + 类型色图标 |
closable | boolean | false | 显示关闭按钮,点击后隐藏并触发 close |
icon | boolean | true | 左侧类型图标(内联 SVG) |
scrollable | boolean | false | 文字超长时横向滚动(CSS marquee,hover 暂停) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
close | void | 点击关闭按钮时触发,随后组件隐藏 |
click | Event | 点击通告栏主体时触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 通知内容 |
示例
四种语义
vue
<Stack :gap="10">
<NoticeBar>系统将于今晚 23:00 维护。</NoticeBar>
<NoticeBar type="success">部署成功,全部健康检查通过。</NoticeBar>
<NoticeBar type="warning">证书将在 7 天后过期。</NoticeBar>
<NoticeBar type="danger">支付服务不可用。</NoticeBar>
</Stack>可关闭
vue
<NoticeBar closable type="warning">该公告可被关闭。</NoticeBar>无图标
vue
<NoticeBar :icon="false">纯文本公告,不带前置图标。</NoticeBar>超长滚动播报
vue
<NoticeBar scrollable type="warning">这是一条很长很长的公告,超出容器宽度后会自动横向滚动播放,鼠标悬停时暂停。</NoticeBar>