festival-widget 是一套整合了法定节日配置与悬浮祝福渲染的网页组件源码，包含日期判断、卡片展示与调试接口，属于轻量前端工具类项目。
源码系统概览
文章正文
festival-widget 是一套纯原生 JavaScript 实现的网页节日漂浮挂件，覆盖 2026 至 2028 年全部法定节假日，版本口径 v2.0.0，来自本地源码包整理分发。
本程序单文件无依赖，引入后自动在页面右下角悬浮节日祝福卡片，节日过后自动隐藏，适合各类网站快速增添节日氛围。
源码简介
挂件通过 window.__festival.setState 暴露调试接口，可强制展示全部节日或模拟指定日期，方便上线前预览各节日效果。
节日数据以配置对象组织，按年月日区间定义起止日期与祝福文案，开发者可自行新增或修改节日条目。
挂件通过 window.__festival.setState 暴露调试接口，可强制展示全部节日或模拟指定日期，方便上线前预览各节日效果。
节日数据以配置对象组织，按年月日区间定义起止日期与祝福文案，开发者可自行新增或修改节日条目。
挂件以单文件 festival-widget.js 承载，内置节假日配置、悬浮样式与祝福文案，通过系统日期判断当前节日并渲染对应卡片。
支持多节日堆叠展示、金色描边与星光动画、手动关闭，并提供 testMode 与 simulate 调试接口，方便预览不同节日效果。
适用场景
各类网站可在底部引入本挂件，在法定节日自动展示祝福卡片，无需后台维护。
开发者可研究其日期判断与悬浮动画写法，作为轻量前端组件学习参考。
技术栈与运行环境
本项目未在 github.com 发布开源仓库，也未附带 MIT 或 Apache 许可证，作者未公开署名，仅供技术研究；版本口径 v2.0.0，最后更新 2026 年，包内未提供独立更新日志，请以本站发布信息为准。
语法: 原生 JavaScript
样式: 内联注入
引入: 页面底部 script 标签
语法: 原生 JavaScript
样式: 内联注入
引入: 页面底部 script 标签
前端: 原生 JavaScript 单文件
依赖: 零外部依赖
引入: script 标签即可
功能亮点
核心能力集中在。
覆盖 2026-2028 全部法定节假日
右下角自动悬浮展示
多节日自动堆叠不遮挡
金色描边加悬浮动画加星光效果
可手动关闭
支持模拟日期调试
对比 Confetti 等节日特效插件，本项目是零依赖单文件的轻量替代方案，和插件相比主要区别在体积与引入方式，插件生态更丰富但需额外引入库文件。
| 能力 | 本项目 | 节日插件 |
|---|---|---|
| 体积 | 单文件 | 较大 |
| 依赖 | 无 | 需引入 |
| 覆盖 | 2026-2028 | 可配置 |
技术架构与部署指南
安装与部署提示
将 festival-widget.js 上传到网站目录，在页面底部引入 script 标签即可生效，无需初始化代码。
调试可在控制台执行 window.__festival.setState 切换模式，收录信息以 2026.10.4 为口径。
截图与演示说明
首图展示挂件在网页右下角的悬浮效果，覆盖国庆、中秋、端午等多个节日的配色与祝福卡片，直观体现不同节日的展示形态。
配图还演示了测试模式与模拟日期调试的界面，便于理解部署后的实际表现，最终效果以真实网站环境为准。
首图展示挂件在网页右下角的悬浮效果，覆盖国庆、中秋、端午等多个节日的配色与祝福卡片，直观体现不同节日的展示形态。
配图还演示了测试模式与模拟日期调试的界面，便于理解部署后的实际表现，最终效果以真实网站环境为准。
配图展示挂件在网页右下角的节日卡片效果，覆盖国庆中秋端午等多节日配色与祝福文案。
常见问题
问. 需要依赖吗
不需要，纯原生 JS 单文件即可运行。
问. 节日会过期吗
节日过后自动隐藏，无需手动维护。
问. 怎么调试
用 setState 的 testMode 与 simulate 参数预览效果。
安全风险提示
审查结论为低风险，单文件无外部请求，无命令执行，仅含日期判断与悬浮渲染逻辑，可放心引入。
下载说明
下载包为单文件 JS，上传服务器后在页面底部引入 script 标签即可，无需额外依赖与初始化，适合任意网页快速部署。
下载包为单文件 JS，上传服务器后在页面底部引入 script 标签即可，无需额外依赖与初始化，适合任意网页快速部署。
下载包为单个 JS 文件，部署前核对节日配置，仅供研究与学习。