NoticeBar 通知栏
使用指南
在导航栏下方,一般用作系统提醒、活动提醒等通知。
规则
- 需要引起用户关注时使用,重要级别低于 Modal ,高于 Toast。
代码演示
与h3-mobile-vue组件的区别以及迁移
将跑马灯组件抽离成基础组件,新增4种状态
若要做迁移请参考
- 弃用的props:
onClick
marqueeProps
- 替换的props:
- 新增的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 还是尾部forwards ,prop: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 | 启动跑马灯,存在内容不同但长度一致时会出现不滚动情况时可以手动调用启动滚动 | - |