NoticeBar 通知栏

引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

基础用法

通过 属性设置通知栏的内容，通过 left-icon 属性设置通知栏左侧的图标。

  1. <van-notice-bar
  2.   left-icon="volume-o"
  3.   text="无论我们能活多久，我们能够享受的只有无法分割的此刻，此外别无其他。"
  4. />

滚动播放

通知栏的内容长度溢出时会自动开启滚动播放，通过 scrollable 属性可以控制该行为。

  1. <!-- 文字较短时，通过设置 scrollable 属性开启滚动播放 -->
  2. <van-notice-bar scrollable text="米袋虽空——樱花开哉！" />
  4. <!-- 文字较长时，通过禁用 scrollable 属性关闭滚动播放 -->
  5. <van-notice-bar
  6.   :scrollable="false"
  7.   text="不会回头的东西有四件：说出口的话、离弦的箭、逝去的生活和失去的机会。"
  8. />

通知栏模式

通知栏支持 closeable 和 link 两种模式。

  1. <van-notice-bar mode="closeable">米袋虽空——樱花开哉！</van-notice-bar>
  3. <!-- link 模式，在右侧显示链接箭头 -->
  4. <van-notice-bar mode="link">米袋虽空——樱花开哉！</van-notice-bar>

自定义样式

通过 color 属性设置文本颜色，通过 background 属性设置背景色。

  1. <van-notice-bar color="#1989fa" background="#ecf9ff" left-icon="info-o">
  2.   米袋虽空——樱花开哉！
  3. </van-notice-bar>

垂直滚动

搭配 NoticeBar 和 Swipe 组件，可以实现垂直滚动的效果。

Events

方法

类型定义

组件导出以下类型定义：

  1. import type { NoticeBarMode, NoticeBarProps, NoticeBarInstance } from 'vant';

NoticeBarInstance 是组件实例的类型，用法如下：

  1. import { ref } from 'vue';
  2. import type { NoticeBarInstance } from 'vant';
  4. const noticeBarRef = ref<NoticeBarInstance>();

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。