讲师中心 微信公众号
AI工具推荐 视频效率加速

Layui日期插件laydate如何显示节日提示

浅芳酱_3705

浅芳酱_3705

发布时间:2026-06-15 12:38:07

|

205人浏览过

|

来源于php中文网

原创

laydate 的 festival 参数必须设为 true 才能显示节日,启用后自动识别中国法定及传统节日并在日期右上角加红点;自定义节日需用 mark,业务规则(放/调休)则用 holidays。

laydate 的 festival 参数必须设为 true 才能显示节日

默认情况下,laydate.render() 不会渲染任何节日信息,哪怕你引入的是最新版(v2.9.9+)。关键开关就是 festival: true 这个布尔值。它不是可选增强项,而是硬性前提。

常见错误是只配了 format 或 range,却漏掉这一项,结果面板里干干净净,连春节、国庆都看不到提示。

  • festival: true 启用后,laydate 会自动识别中国法定节假日(如春节、五一、国庆)和传统节日(如端午、中秋),并在日期单元格右上角加一个小红点
  • 该功能不依赖外部数据源,所有节日规则已内置在 laydate 源码中,无需手动维护日期列表
  • 注意:仅支持公历节日;农历节日(如腊八、小年)不会自动标注,需配合 cellRender 自定义实现

节日样式不可直接通过 CSS 类名覆盖,得用 theme 或皮肤机制

很多人想用 .layui-laydate-festival 这类选择器改样式,但实际 DOM 中并不存在这个类——laydate 是用伪元素 ::after 绘制节日标记点的,且没有暴露可配置的 class 名。

如果你需要调整红点大小、颜色或位置,有两个可行路径:

  • 使用 theme 配置项加载自定义皮肤(例如 theme: 'molv'),再在对应皮肤 CSS 文件里修改 .layui-laydate-header .layui-icon-festival::after
  • 直接在全局 CSS 中覆盖伪元素,例如:
    .layui-laydate-main .layui-this::after { content: "节"; font-size: 10px; color: #ff5722; }
    (注意:这种写法在 v2.8+ 中生效,但可能被后续版本内部结构调整影响)
  • 避免用 !important 硬顶,容易和 laydate 内部优先级冲突

自定义节日(如公司周年庆)不能靠 festival,得用 mark

festival: true 只响应内置节日库,对非标日期(比如“2026-04-21 公司成立日”)完全无效。这时候要用 mark 参数做手工标记。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

mark 接收一个对象,key 是 YYYY-MM-DD 格式字符串,value 是任意字符串,会作为 tooltip 显示:

laydate.render({
  elem: '#test',
  festival: true,
  mark: {
    '2026-04-21': '公司成立日',
    '2026-05-20': '产品上线'
  }
});
  • mark 和 festival 可共存,互不影响;节日红点照常显示,自定义标记以 tooltip 形式悬浮出现
  • value 值支持 HTML 字符串(如 '<b>重点</b>上线'),但需确保内容可信,避免 XSS
  • 注意:如果 key 日期恰好也是内置节日(如 '2026-10-01'),mark 的 tooltip 会覆盖节日默认提示文字

v2.7.3+ 版本的 holidays 不用于显示节日提示,而是控制日期禁用逻辑

看到文档里有 holidays 数组,别误以为它是用来“显示”节日的。它的作用恰恰相反:告诉 laydate 哪些日期要标为“节假日可选”,哪些是“补班日需禁用”。

比如你传入:

holidays: [
  ['2026-04-04', '2026-04-05'], // 清明节放假,允许选择
  ['2026-04-06']                // 补班日,自动禁用该日期
]
  • 这组配置不会让“清明节”三个字出现在面板上,也不会加红点;它只影响点击交互(是否可选、是否灰显)
  • 若你同时开了 festival: true,那 '2026-04-04' 依然会显示节日红点——这是两套独立机制
  • 真正容易混淆的点在于:holidays 里的日期,哪怕没进内置节日库,也不会触发 festival 的视觉提示
节日提示这事看着简单,实际卡点都在配置组合和机制边界上。最常踩的坑是把 holidays 当成 mark 用,或者以为开了 festival 就能标出所有你想标的日子。记住:内置节日靠 festival,自定义文案靠 mark,业务规则(放/调休)靠 holidays——三者各管一摊,混用就失效。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

3791

2023.10.23

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

6388

2024.03.06

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

774

2025.12.30

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

674

2025.12.30

html5空格代码怎么写
html5空格代码怎么写

在HTML5中,空格不能直接通过键盘空格键实现,需使用特定代码。本合集详解常用空格写法:&nbsp;(不间断空格)、&ensp;(半个中文空格)、&emsp;(一个中文空格)及CSS的white-space属性等方法,帮助开发者精准控制页面排版,避免因空格失效导致布局错乱,适用于新手入门与实战参考。

353

2025.12.30

html5怎么做网站教程
html5怎么做网站教程

想从零开始学做网站?这份《HTML5怎么做网站教程》合集专为新手打造!涵盖HTML5基础语法、页面结构搭建、表单与多媒体嵌入、响应式布局及与CSS3/JavaScript协同开发等核心内容。无需编程基础,手把手教你用纯HTML5创建美观、兼容、移动端友好的现代网页。附实战案例+代码模板,快速上手,轻松迈出Web开发第一步!

501

2025.12.31

HTML5建模教程
HTML5建模教程

想快速掌握HTML5模板搭建?本合集汇集实用HTML5建模教程,从零基础入门到实战开发全覆盖!内容涵盖响应式布局、语义化标签、Canvas绘图、表单验证及移动端适配等核心技能,提供可直接复用的模板结构与代码示例。无需复杂配置,助你高效构建现代网页,轻松上手前端开发!

318

2025.12.31

html5怎么使用
html5怎么使用

想快速上手HTML5开发?本合集为你整理最实用的HTML5使用指南!涵盖HTML5基础语法、主流框架(如Bootstrap、Vue、React)集成方法,以及无需安装、直接在线编辑运行的平台推荐(如CodePen、JSFiddle)。无论你是新手还是进阶开发者,都能轻松掌握HTML5网页制作、响应式布局与交互功能开发,零配置开启高效前端编程之旅!

561

2025.12.31

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.7万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 10.9万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn