更新记录
1.0.0(2026-11-17) 下载此版本
新增
- 首次发布
- 通用公告栏组件(uni-app x / uvue 版):跑马灯
roll/ 纵向轮播carousel/ 静态换行static三种形态 mode='auto'自动推导:多条公告→纵向轮播,单条→跑马灯(文本不超出容器则自动静态展示)- 灵活数据源:
text单条 或list多条(string 数组或{text}对象数组,可混合) - 跑马灯采用 JS 定时驱动 translateX + transition 线性平滑,复位帧关闭过渡实现无缝循环(uvue 不支持 @keyframes)
color/bgColor直接配置文字与背景色(默认琥珀色警示配色)- 左侧「公告」标签可显隐、文字可改(
icon插槽完全自定义) - 右侧「更多」链接与关闭按钮可配,事件
@click/@more/@close
平台兼容性
uni-app x(5.0)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ |
ry-notice-x 通用公告栏(uni-app x)
通用公告栏组件(uni-app x / uvue 版):跑马灯 / 纵向轮播 / 静态换行三种形态,mode='auto' 时根据数据自动推导。通过 color / bgColor 自由配色,左侧公告标签、右侧更多/关闭按钮全部可配,一套 API 覆盖首页公告、活动通知、系统消息等场景。
需要 uni-app(Vue3)版本请使用 ry-notice。
安装
三种方式任选其一。
方式一:uni_modules 导入(推荐)
通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-notice-x/components/ry-notice/ 下,easycom 自动注册,无需 import。
方式二:源码放到 components 目录
下载源码后,把组件放到项目的 components/ry-notice/ry-notice.uvue,保持该目录结构,即符合 easycom 默认规则,uni-app x 自动注册。
方式三:手动导入
组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):
import ryNotice from '@/components/ry-notice/ry-notice.uvue'
使用示例
<template>
<!-- 1. 最简用法:单条公告,超出容器自动跑马灯 -->
<ry-notice text="红逸组件库 v1.0.0 发布啦~"></ry-notice>
<!-- 2. 多条公告:自动纵向轮播 -->
<ry-notice :list="['恭喜占用成功!', '今日签到送 50 积分~', '会员日全场 8 折']"></ry-notice>
<!-- 3. 强制跑马灯 / 轮播 / 静态 -->
<ry-notice :list="list" mode="roll"></ry-notice>
<ry-notice :list="list" mode="carousel"></ry-notice>
<ry-notice :list="list" mode="static"></ry-notice>
<!-- 4. 自定义配色 -->
<ry-notice text="系统维护中,请稍后再试" color="#f56c6c" bg-color="#fef0f0"></ry-notice>
<ry-notice text="下单成功,快去发货吧" color="#67c23a" bg-color="#f0f9eb"></ry-notice>
<ry-notice text="自定义配色" bg-color="#fff7e6" color="#d46b08"></ry-notice>
<!-- 5. 关闭按钮 + 更多链接 -->
<ry-notice v-if="showBar" text="新版本已发布" color="#409eff" bg-color="#ecf5ff" :closeable="true" @close="showBar = false"></ry-notice>
<ry-notice text="双 11 大促预热中" more-text="详情" @more="goDetail"></ry-notice>
<!-- 6. 自定义左侧图标(插槽) -->
<ry-notice text="公告内容">
<template #icon>
<text style="margin-right: 12rpx;">📢</text>
</template>
</ry-notice>
</template>
<script setup>
import { ref } from 'vue'
const showBar = ref(true)
const list = ref(['公告一', '公告二', '公告三'])
const goDetail = () => {
uni.showToast({ title: '跳转详情', icon: 'none' })
}
</script>
API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| text | String | '' | 单条公告文本(list 为空时生效) |
| list | any[] | [] | 多条公告:string 数组或 { text } 对象数组,可混合 |
| mode | String | 'auto' | 形态:auto 自动 / roll 跑马灯 / carousel 纵向轮播 / static 静态 |
| speed | Number | 50 | 跑马灯速度(px/秒) |
| interval | Number | 4000 | 轮播间隔(ms) |
| duration | Number | 500 | 轮播动画时长(ms) |
| color | String | '#e6a23c' | 文字颜色 |
| bgColor | String | '#fdf6ec' | 背景颜色 |
| size | Number | 28 | 文字字号(rpx) |
| radius | Number | 8 | 圆角(rpx) |
| showIcon | Boolean | true | 是否显示左侧公告标签 |
| iconText | String | '公告' | 左侧标签文字 |
| closeable | Boolean | false | 是否显示右侧关闭按钮 |
| moreText | String | '' | 右侧更多文字(空则不显示) |
Slots
| 名称 | 说明 |
|---|---|
| icon | 自定义左侧图标区(替换默认「公告」标签) |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
| click | { index, text } |
点击公告内容(轮播为所点条目) |
| more | - | 点击右侧「更多」 |
| close | - | 点击右侧关闭按钮(关闭由外部 v-if 控制) |
形态说明
- auto(默认):多条公告自动纵向轮播;单条自动跑马灯,且文本未超出容器时自动静态展示,不空转
- roll:单行跑马灯,多条公告用「;」拼接滚动,速度由
speed控制 - carousel:纵向轮播,间隔与动画时长由
interval/duration控制 - static:静态展示,长文本自动换行,多条平铺
实现说明
uvue App 端不支持 CSS Animation / @keyframes,跑马灯通过 createSelectorQuery 测量文本与容器宽度后,由 JS 定时器驱动 translateX,配合 transition 线性过渡平滑滚动;文本完全移出后关闭过渡瞬间复位到右侧入场位,实现无缝循环。
技术支持
- 微信:howe1144(一定在线,紧急问题首选)
- QQ 群:415367029(常规问题,群友互助,作者可能在线)
- ***(很少在线)
- 插件市场评论区:回复不及时,仅适合不着急的留言反馈
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

收藏人数:
下载插件并导入HBuilderX
赞赏(0)


下载 3
赞赏 0
下载 12771028
赞赏 1959
赞赏
京公网安备:11010802035340号