NoticeBar 通告栏

引入

app.jsonindex.json中引入组件,详细介绍见快速上手

  1. "usingComponents": {
  2. "van-notice-bar": "@vant/weapp/notice-bar/index"
  3. }

代码演示

基础用法

  1. <van-notice-bar
  2. left-icon="volume-o"
  3. text="在代码阅读过程中人们说脏话的频率是衡量代码质量的唯一标准。"
  4. />

滚动播放

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

  1. <!-- 文字较短时,通过设置 scrollable 属性开启滚动播放 -->
  2. <van-notice-bar scrollable text="技术是开发它的人的共同灵魂。" />
  3. <!-- 文字较长时,通过禁用 scrollable 属性关闭滚动播放 -->
  4. <van-notice-bar
  5. scrollable="{{ false }}"
  6. text="在代码阅读过程中人们说脏话的频率是衡量代码质量的唯一标准。"
  7. />

多行展示

文字较长时,可以通过设置 wrapable 属性来开启多行展示。

  1. <van-notice-bar
  2. wrapable
  3. scrollable="{{ false }}"
  4. text="在代码阅读过程中人们说脏话的频率是衡量代码质量的唯一标准。"
  5. />

通知栏模式

通知栏支持 closeablelink 两种模式。

  1. <!-- closeable 模式,在右侧显示关闭按钮 -->
  2. <van-notice-bar mode="closeable" text="技术是开发它的人的共同灵魂。" />
  3. <!-- link 模式,在右侧显示链接箭头 -->
  4. <van-notice-bar mode="link" text="技术是开发它的人的共同灵魂。" />

自定义样式

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

  1. <van-notice-bar
  2. color="#1989fa"
  3. background="#ecf9ff"
  4. left-icon="info-o"
  5. text="技术是开发它的人的共同灵魂。"
  6. />

自定义滚动速率

使用speed属性控制滚动速率

  1. <van-notice-bar
  2. text="{{ text }}"
  3. speed="{{speedValue}}"
  4. left-icon="//img.yzcdn.cn/public_files/2017/8/10/6af5b7168eed548100d9041f07b7c616.png"
  5. />

API

Props

参数说明类型默认值
mode通告栏模式,可选值为 closeable linkstring‘’
text通知文本内容string‘’
color通知文本颜色string#ed6a0c
background滚动条背景string#fffbe8
left-icon左侧图标名称或图片链接string-
delay动画延迟时间 (s)number1
speed滚动速率 (px/s)number50
scrollable是否开启滚动播放,内容长度溢出时默认开启booleantrue
wrapable是否开启文本换行,只在禁用滚动时生效booleanfalse
open-type微信开放能力stringnavigate

Events

事件名说明参数
click点击通知栏时触发event: Event
close关闭通知栏时触发event: Event

Slot

名称说明
left-icon自定义左侧图标
right-icon自定义右侧图标

外部样式类

类名说明
custom-class根节点样式类

NoticeBar 通告栏 - 图1