更新记录

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(常规问题,群友互助,作者可能在线)
  • ***(很少在线)
  • 插件市场评论区:回复不及时,仅适合不着急的留言反馈

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者:

支付宝赞助 微信赞助

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。