# NoticeBar 通知栏

# 使用指南

在导航栏下方,一般用作系统提醒、活动提醒等通知。

# 规则

  • 需要引起用户关注时使用,重要级别低于 Modal ,高于 Toast。

# 代码演示

查看代码

# 与h3-mobile-vue组件的区别以及迁移

将跑马灯组件抽离成基础组件,新增4种状态

若要做迁移请参考

  1. 弃用的props:onClick marqueeProps
  2. 替换的props:
    • mode => action
  3. 新增的props:text loop leading trailing fps type gpuAcceleration final

# API

# Prop

属性 说明 类型 默认值
visible 是否呈现,v-model绑定值,默认呈现 boolean true
action 提示类型,可选close,link,若slot:action被使用则不显示默认图标,值为close点击将隐藏并触发事件event:toggle, 值为 link 点击触发事件event:link string ''
icon 在开始位置设置图标,若slot:icon被使用则不显示默认图标 string ''
type 通知栏类型 可选default primary warning error success string default
text 通知栏文本,若slot:default被使用则不显示 string ''
marquee 是否启用走马灯效果显示 boolean false
loop marquee: true时生效,是否循环滚动 boolean false
leading marquee: true时生效,首次及循环时首部文本停留时间,单位ms,最少1000ms number 1000
trailing marquee: true时生效,循环时尾部文本停留时间,单位ms,最少1000ms number 1000
final marquee: true时生效,结束滚动时文本显示首部backwards还是尾部forwardsprop:loop=true时不生效 string forwards
gpuAcceleration marquee: true时生效,是否启用gpu加速 boolean true
fps marquee: true时生效,每秒帧数 number 60

# Slot

属性 说明 参数
icon 导航栏首部插槽 -
default 默认插槽,导航栏内容 -
action 导航栏尾部插槽 -

# Event

事件名称 说明 回调参数
toggle v-model绑定事件 (visible:boolean)
show 显示时回调 -
hide 关闭时回调 -
click 点击事件 (evt: event)
link 点击prop:action="link" 触发事件 -
finish 滚动到尾部且过了尾部文本停留时间时触发完成一次滚动事件 -

# Function

  • 实例方法
方法名 说明 参数
run 启动跑马灯,存在内容不同但长度一致时会出现不滚动情况时可以手动调用启动滚动 -