更新记录

1.0.0(2026-03-27) 下载此版本

首次发布

  • 实现内容超出时自动滚动,未超出时静止
  • 支持自定义滚动速度、延迟、间距
  • 无缝循环滚动,无视觉跳跃
  • 支持左侧图标、右侧关闭按钮
  • 支持点击跳转
  • 兼容 H5、微信小程序、App 端

平台兼容性

uni-app(3.7.2)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
-
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - -
# sea-scroll-notice 超越公告栏

## 特性

- ✅ **真正“超出才滚动”** – 文本宽度 ≤ 容器宽度时静止,超出时自动平滑滚动
- ✅ **循环无跳跃** – 无缝循环滚动,视觉连贯
- ✅ **无初始闪现** – 复制文本仅在需要滚动时渲染,切换内容时不闪烁
- ✅ **间距可控** – 支持自定义原始文本与复制文本之间的间距(rpx)
- ✅ **速度/延迟可调** – 滚动速度、启动延迟自由配置
- ✅ **鼠标悬停暂停** – H5 端支持悬停暂停,提升体验
- ✅ **左右插槽** – 支持自定义左侧图标、右侧关闭按钮
- ✅ **点击跳转** – 支持点击整个公告栏跳转页面
- ✅ **全端兼容** – 已测试 H5、微信小程序、App 端

## 安装

1. 在插件市场点击“下载”或“使用 HBuilderX 导入插件”
2. 在页面中直接引用组件

## 基本用法

```vue
<template>
  <view>
    <!-- 短文本:不滚动,无复制内容 -->
    <sea-scroll-notice text="系统通知" :showIcon="true" />

    <!-- 长文本:自动滚动,间距40rpx,速度8秒/圈 -->
    <sea-scroll-notice
      text="这是一条非常非常非常长的通知内容,超出宽度时会自动滚动显示。"
      :showIcon="true"
      :showClose="true"
      bgColor="#f5f5f5"
      padding="20rpx 30rpx"
      fontSize="28"
      color="#666"
      :speed="8"
      :delay="500"
      :gap="40"
      @click="handleClick"
      @close="handleClose"
    />
  </view>
</template>

<script>
import SeaScrollNotice from '@/components/sea-scroll-notice/sea-scroll-notice.vue'
export default {
  components: { SeaScrollNotice },
  methods: {
    handleClick() { console.log('点击公告') },
    handleClose() { console.log('关闭公告') }
  }
}
</script>

Props

参数 类型 默认值 说明
text String '' 滚动文本内容
showIcon Boolean false 是否显示左侧喇叭图标
showClose Boolean false 是否显示右侧关闭按钮
fontSize Number 28 字体大小(rpx)
color String '#333' 文字颜色
bgColor String 'transparent' 背景颜色
padding String '0' 内边距,如 '20rpx 30rpx'
speed Number 10 滚动一圈所需时间(秒)
gap Number 30 原始文本与复制文本之间的间距(rpx)
delay Number 1000 开始滚动前的延迟(毫秒)
autoplay Boolean true 是否自动播放
pauseOnHover Boolean true 鼠标悬停是否暂停(仅H5)
url String '' 点击跳转路径
linkType String 'navigateTo' 跳转方式(navigateTo / redirectTo / reLaunch / switchTab)

插槽

名称 说明
leftIcon 自定义左侧图标,传入后覆盖默认🔔
rightIcon 自定义右侧关闭按钮,传入后覆盖默认✕

事件

事件名 说明
click 点击通告栏时触发
close 点击关闭按钮时触发(需 showClose 为 true)

隐私、权限声明

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

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

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

许可协议

MIT License

Copyright (c) 2026 Sea

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.