更新记录

1.0.0(2026-11-19) 下载此版本

课程“插件修改作业”首个提交版本。

作业要求对应修改

  • ① 文案修改
    • 默认通知改为“教务处选课通知”完整文案。
    • 左侧标识由“通知”改为“教务”。
    • 右侧操作由“查看详情”改为“查看安排”。
  • ② CSS 样式修改
    • 新增校园蓝渐变背景 #EAF2FF → #F7FAFF。
    • 默认圆角改为 24rpx,支持 0–48rpx 动态调节。
    • 新增左侧强调色条、徽标、阴影、关闭淡出动画。
    • 新增 mint、sunset、night 三套主题。
  • ③ 插件信息修改
    • id:wyk2024-notice-bar。
    • displayName:wyk2024 校园通知栏。
  • ④ README 重写
    • 重写简介,增加作业声明、修改对照、安装、API、主题、兼容性与发布说明。

功能新增

  • 双份文本无缝滚动,自动测量文本宽度。
  • 文本较短时自动静态省略,不强行滚动。
  • 触摸暂停 / 松开继续。
  • click、more、close 事件。
  • open() 方法,可通过 ref 重新显示。
  • autoClose 自动关闭。
  • 自定义 bgColor、textColor、accentColor、borderColor。

兼容性

  • 支持 H5、App(app-vue)、主流小程序。
  • 不支持 app-nvue(需要 DOM 节点测量)。
  • 支持 Vue2 / Vue3(Options API)。

平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ √ √ √ × - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ √ √ √ √ √ - √ √ - × ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × √ ×

wyk2024 校园通知栏(课程修改作业版)

本插件是本次课程“插件修改作业”的提交作品。

选题来源:DCloud 插件市场中的简易前端组件——通知栏 / 公告栏(Notice Bar)类组件。 选题参考:wht-notice-bar 通知栏(参考其 “左侧标识 + 滚动文字 + 右侧操作”的功能形态)。 本次作业在这一交互形态基础上完成了二次设计与代码实现,并按课程要求修改了 文案、CSS 样式、插件 ID / 显示名称、README 四项内容,同时对滚动、主题、关闭动画等能力做了扩展。 组件为纯前端 Vue 组件,不包含原生插件、不申请系统权限、不采集任何数据。

作业信息 内容
课程名称 请填写(例如:uni-app 插件开发)
作业名称 插件修改作业
插件 ID wyk2024-notice-bar
显示名称 wyk2024 校园通知栏
当前版本 1.0.0
作者 / 学号 请在这里填写你的姓名和学号
完成日期 2026-11-19

一、本次作业的四项修改(对照老师要求)

序号 作业要求 修改前(基线) 修改后(本插件) 位置
① 修改组件内文字文案 默认文案:这是一条通知消息;按钮:查看详情;标识:通知 默认文案改为完整的教务处选课通知;按钮改为查看安排;标识改为教务 组件 props.text / moreText / badgeText,模板中有【作业修改①】注释
② 修改 CSS 样式(背景色、圆角任选其一) 浅黄色纯色背景、直角、无阴影 校园蓝渐变背景 + 默认 24rpx 圆角,并新增左侧强调色条、徽标、柔和阴影、关闭淡出动画 组件 <style> 中有【作业修改②】注释
③ 修改 package.json 的插件 ID 和显示名称,ID 前缀为 wyk2024 demo-notice-bar / 通知栏组件 wyk2024-notice-bar / wyk2024 校园通知栏 package.json
④ 重写 readme.md,标注是本次课程修改作业 通用组件说明 即本文件:重写简介、作业信息、修改对照、使用文档和发布说明 readme.md

说明:插件 ID 不能包含 + 号,因此作业要求中的“wyk+2024”在 ID 中规范写为 wyk2024- 前缀, 例如本插件 ID 为 wyk2024-notice-bar,与示例 zs2024-xxx 的写法一致。

1. 文案修改(要求①)

基线组件只有一句“这是一条通知消息”。本插件把组件内所有可见文案都替换为校园场景文案:

  • 默认通知:【教务处】关于 2024-2025 学年第二学期选课的通知:请同学们于本周五 18:00 前登录教务系统完成选课,逾期系统将自动关闭。
  • 左侧徽标:通知 → 教务
  • 右侧操作:查看详情 → 查看安排
  • 关闭按钮:保留 ×,但新增了 220ms 淡出缩小动画

以上文案均可在页面中通过属性覆盖,不是写死在模板里的。

2. 样式修改(要求②)

  • 背景:由单一浅黄色改为 linear-gradient(135deg, #EAF2FF 0%, #F7FAFF 100%) 校园蓝渐变, 同时保留 background-color 作为不支持渐变时的降级。
  • 圆角:默认 24rpx,并支持通过 radius 属性在 0–48rpx 之间调节(演示页有滑杆)。
  • 新增:左侧 8rpx 强调色条、圆角徽标、轻阴影、夜间主题、关闭淡出。
  • 这些改动在组件 <style> 中都有 【作业修改②】 注释,不是只改一个颜色值。

3. 插件信息修改(要求③)

{
  "id": "wyk2024-notice-bar",
  "displayName": "wyk2024 校园通知栏",
  "version": "1.0.0"
}

4. README 重写(要求④)

本文件已整体重写,包含作业声明、四项修改对照、安装方式、API、主题、兼容性和发布步骤。 改造前的基线代码保留在项目 docs/baseline/NoticeBarBaseline.vue,方便老师对照检查改动。


二、组件功能

  • 无缝滚动:双份文本 + CSS translateX(-50%),循环时没有明显跳变。
  • 自动判断:先测量文本宽度;文字比容器短时自动改为单行省略,不强行滚动。
  • 触摸暂停:手指按住滚动区域时暂停,松开继续。
  • 四套主题:campus(校园蓝)、mint(薄荷绿)、sunset(暖阳橙)、night(夜间)。
  • 圆角可调:radius 支持数字(单位 rpx)或字符串(如 "20px"、"50%")。
  • 关闭动画:关闭时先淡出缩小,再隐藏;支持通过 ref 调用 open() 重新显示。
  • 事件完整:click、more、close 三个事件,便于接入页面跳转或埋点。
  • 零依赖:不依赖 uni-icons 等第三方组件,复制即可用。
  • 纯前端:Vue 组件,不含原生插件、UTS、云函数。

三、目录结构

wyk2024-notice-bar-homework/
├── App.vue
├── main.js
├── manifest.json
├── pages.json
├── pages/
│   └── index/index.vue                 # 演示页:主题、圆角、速度、滚动开关
├── uni_modules/
│   └── wyk2024-notice-bar/             # 可直接发布的插件目录
│       ├── package.json                # 作业修改③
│       ├── readme.md                   # 作业修改④
│       ├── changelog.md
│       ├── license.md
│       ├── LICENSE
│       └── components/
│           └── wyk2024-notice-bar/
│               └── wyk2024-notice-bar.vue   # 组件源码(作业修改①②)
└── docs/
    ├── CHANGES.md                      # 详细改动说明 + 发布步骤
    └── baseline/NoticeBarBaseline.vue  # 改造前基线(仅对照,不参与编译)

四、安装

方式 A:HBuilderX 导入(推荐)

  1. 在插件市场下载本插件,选择“使用 HBuilderX 导入插件”。
  2. 选择你的 uni-app 项目,插件会被放入 uni_modules/wyk2024-notice-bar。
  3. 页面中直接使用 <wyk2024-notice-bar>(uni_modules 支持 easycom 自动引入)。

方式 B:手动复制

把 uni_modules/wyk2024-notice-bar 整个目录复制到你的项目 uni_modules 下,然后重新运行项目。

五、基础用法

<template>
  <view class="page">
    <wyk2024-notice-bar
      text="【教务处】关于 2024-2025 学年第二学期选课的通知:请同学们于本周五 18:00 前登录教务系统完成选课。"
      theme="campus"
      :radius="24"
      more-text="查看安排"
      @more="goCourse"
      @close="onClose"
    />
  </view>
</template>

<script>
export default {
  methods: {
    goCourse() {
      uni.navigateTo({ url: '/pages/course/course' })
    },
    onClose() {
      uni.showToast({ title: '通知已关闭', icon: 'none' })
    }
  }
}
</script>

如果项目没有开启 easycom,也可以显式引入:

import Wyk2024NoticeBar from '@/uni_modules/wyk2024-notice-bar/components/wyk2024-notice-bar/wyk2024-notice-bar.vue'

export default {
  components: { Wyk2024NoticeBar }
}

六、属性(Props)

属性 类型 默认值 说明
text String 教务处选课通知 通知正文
theme String campus 主题:campus / mint / sunset / night
radius Number / String 24 圆角;数字单位 rpx,也可传 "20px"、"50%"
speed Number 70 滚动速度,单位 px/s,最小按 10 处理
scrollable Boolean true 是否允许滚动;文字不够长时仍会静态显示
showIcon Boolean true 是否显示左侧徽标
badgeText String 教务 徽标文字
showMore Boolean true 是否显示右侧操作
moreText String 查看安排 右侧操作文字
closable Boolean true 是否显示关闭按钮
paused Boolean false 外部控制暂停滚动
autoClose Number 0 自动关闭时间(毫秒),0 表示不自动关闭
bgColor String '' 自定义背景色/背景,传入后覆盖主题背景
textColor String '' 自定义文字颜色
accentColor String '' 自定义强调色(色条、徽标、操作文字)
borderColor String '' 自定义边框颜色

七、事件与方法

名称 类型 说明
click 事件 点击通知主体时触发
more 事件 点击右侧“查看安排”时触发
close 事件 点击关闭按钮时触发(先触发事件,再执行 220ms 动画)
open() 方法 通过 ref 调用,重新显示已关闭的通知栏
<wyk2024-notice-bar ref="notice" @more="onMore" />

<script>
export default {
  methods: {
    onMore() {
      this.$refs.notice.open()
    }
  }
}
</script>

八、主题色

主题 背景 强调色 适用场景
campus 蓝白渐变 #EAF2FF → #F7FAFF #2F6BFF 默认、校园通知
mint 薄荷渐变 #E9FBF3 → #F7FFFB #12A36D 成功、活动提醒
sunset 暖橙渐变 #FFF0E6 → #FFF9F4 #F26B38 紧急、截止提醒
night 深蓝渐变 #1B2436 → #243149 #7FB2FF 深色页面、夜间模式

九、平台兼容性

平台 支持情况 说明
H5(移动端 / PC) ✅ 推荐用于课程演示
App(app-vue) ✅ 使用 Vue 页面
微信 / 支付宝 / 抖音 / 百度 / QQ / 快手等小程序 ✅ 使用 CSS 动画,无原生依赖
App(app-nvue) ❌ 本组件使用 DOM 节点测量,暂不支持 nvue
Vue 2 / Vue 3 ✅ 组件使用 Options API,Vue2 会走 beforeDestroy 清理定时器

演示工程按 Vue3 配置(main.js 使用 createSSRApp);组件本体不依赖 Vue3 专有语法, 也可以复制到 Vue2 的 uni-app 项目中使用。

十、发布到 DCloud 插件市场

  1. 用 HBuilderX 打开本项目,先运行到浏览器或微信开发者工具,确认演示页正常。
  2. 在 HBuilderX 项目树中右键 uni_modules/wyk2024-notice-bar。
  3. 选择 发布到插件市场。
  4. 按提示填写插件介绍、分类、标签、联系方式,并上传预览图。
  5. 价格选择免费;隐私声明填写“不采集任何数据、无系统权限、无广告”。
  6. 提交审核。审核通过后,插件市场会使用 readme.md 作为详情页文档。

发布前请把 package.json 中 dcloudext.contact.qq 改成自己的 QQ, 并把本文“作业信息”表中的姓名、学号补全。

十一、常见问题

Q1:页面上没有出现滚动动画? 先确认 scrollable 为 true,且文本宽度大于容器宽度。文本较短时会自动静态显示;可把窗口调窄或换成长通知再试。

Q2:小程序里第一次进入不滚动,过一下才滚动? 组件在 mounted 后测量文本宽度,部分小程序首帧拿不到节点尺寸,因此会延迟 120ms 再测一次,属于正常现象。

Q3:为什么插件 ID 不是 wyk+2024-xxx? DCloud 插件 ID 只允许英文、数字和连字符,不能包含 +。作业要求的含义是“wyk + 2024”前缀,因此规范写成 wyk2024-xxx。

Q4:可以改成自己的主题色吗? 可以。优先传 bgColor、textColor、accentColor;如果要长期增加主题,在组件 THEMES 对象中新增一组配色即可。

十二、更新日志

详见 changelog.md。

十三、许可协议

本项目使用 MIT License,仅用于课程学习与演示。


再次声明:本插件为本次课程“插件修改作业”的提交作品,已在 README 中显著标注;请勿将其作为原创商业插件宣传。

隐私、权限声明

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

无

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

插件不采集任何数据

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

无

许可协议

MIT License

Copyright (c) 2026 wyk2024

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.

暂无用户评论。