跳到主要内容

NoticeBar 通知栏 ​

uni-appH5微信小程序App

跨端通知提示条,支持信息、警告、危险类型和关闭操作。

何时使用 ​

页面顶部的系统公告、维护通知、风险提示等需要持续展示的信息。

何时不使用 ​

操作结果的即时反馈用 Toast;需要用户确认处理的用 Dialog。

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

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

Props ​

名称类型默认值说明
typestring:'info' | 'warning' | 'danger'"info"类型,对应 soft 底色 + 类型色图标
closablebooleanfalse显示关闭按钮,点击后隐藏并触发 close
iconbooleantrue左侧类型图标(内联 SVG)
scrollablebooleanfalse文字超长时横向滚动(CSS marquee,hover 暂停)

Events ​

名称载荷说明
closevoid点击关闭按钮时触发,随后组件隐藏
clickEvent点击通告栏主体时触发

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>