Skip to content

NoticeBar 滚动通知组件

该组件用于滚动通告场景,有多种模式可供选择

温馨提示

本项目参考了 uView-Plus 开源项目的组件开发方式,基于 Vue 3 和 TypeScript 实现了自定义组件。目前该组件仍处于测试阶段。
感谢 uView-Plus 开源项目及其团队成员的贡献,他们的组件开发思路为本项目提供了宝贵地参考。如果需要了解更多组件开发细节,可以参考uView-Plus的 noticeBar组件 的代码实现。

平台差异说明

APP(vue)H5微信小程序

基本使用示例

html
<!-- 全局使用 -->
<hy-notice-bar text="欢迎使用华悦组件库"></hy-notice-bar>
<!-- 单个组件引入 -->
<HyNoticeBar text="欢迎使用华悦组件库"></HyNoticeBar>
ts
import { HyNoticeBar } from "hy-app"

可关闭

html
<template>
    <hy-notice-bar text="欢迎使用华悦组件库"></hy-notice-bar>
</template>

滚动速度

  • speed可配置横向滚动速度
html
<template>
    <hy-notice-bar text="欢迎使用华悦组件库" speed="250"></hy-notice-bar>
</template>

跳转页面

  • 通过配置url跳转到指定页面
  • 通过配置modeline右边出现向右箭头 :::tips 注意 必须urlmode都设置了才能跳转 :::
html
<template>
    <hy-notice-bar text="欢迎使用华悦组件库" url="/pages/components/tag/tag" mode="line"></hy-notice-bar>
</template>

滚动方式

html
<template>
    <!--横向-->
    <hy-notice-bar text="欢迎使用华悦组件库" direction="row"></hy-notice-bar>
    <!--横向轮播模式-->
    <hy-notice-bar text="欢迎使用华悦组件库" direction="row" step></hy-notice-bar>
    <!--纵向-->
    <hy-notice-bar text="欢迎使用华悦组件库" direction="columns"></hy-notice-bar>
</template>

API

参数说明类型默认值
text显示的内容,direction为column时要求为数组array | string-
direction通告滚动模式,row-横向滚动,column-竖向滚动row | columnrow
stepdirection = row时,是否使用步进形式滚动booleanfalse
icon是否显示左侧的音量图标stringIconConfig.NOTIFICATION_FILL
mode通告模式,link-显示右箭头,closable-显示右侧关闭图标link | closable-
color文字颜色string#f9ae3d
bgColor背景颜色string#fdf6ec
speed水平滚动时的滚动速度,即每秒滚动多少px(rpx),这有利于控制文字无论多少时,都能有一个恒定的速度string | number80
fontSize字体大小string | number14
duration滚动一个周期的时间长,单位msnumber2000
disableTouch是否禁止用手滑动切换booleantrue
url跳转的页面路径string-
linkType页面跳转的类型stringnavigateTo
justifyContent文字水平布局类型flex-start|center|flex-endflex-start

Events

事件名说明回调参数
click点击通告文字触发index: 点击的text的索引
close点击右侧关闭图标触发-
00:46