更新记录
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 导入(推荐)
- 在插件市场下载本插件,选择“使用 HBuilderX 导入插件”。
- 选择你的 uni-app 项目,插件会被放入
uni_modules/wyk2024-notice-bar。 - 页面中直接使用
<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 插件市场
- 用 HBuilderX 打开本项目,先运行到浏览器或微信开发者工具,确认演示页正常。
- 在 HBuilderX 项目树中右键
uni_modules/wyk2024-notice-bar。 - 选择 发布到插件市场。
- 按提示填写插件介绍、分类、标签、联系方式,并上传预览图。
- 价格选择免费;隐私声明填写“不采集任何数据、无系统权限、无广告”。
- 提交审核。审核通过后,插件市场会使用
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 中显著标注;请勿将其作为原创商业插件宣传。

收藏人数:
下载插件并导入HBuilderX
赞赏(0)
下载 0
赞赏 0
下载 12778170
赞赏 1960
赞赏
京公网安备:11010802035340号