
本文详解 FullCalendar 6 中修改周数(Week Numbers)样式的方法,重点指出新版中 CSS 类名已变更,需使用 .fc-daygrid-week-number 替代旧版 .fc-week-number,并说明其仅适用于 dayGridMonth 视图。
本文详解 fullcalendar 6 中修改周数(week numbers)样式的方法,重点指出新版中 css 类名已变更,需使用 `.fc-daygrid-week-number` 替代旧版 `.fc-week-number`,并说明其仅适用于 `daygridmonth` 视图。
在 FullCalendar 6 中,启用周数显示需通过 weekNumbers: true 配置项(注意:首字母小写),但直接沿用旧版本(v3/v5)的 .fc-week-number 类选择器将无法生效——因为 v6 对视图组件进行了重构,周数单元格的 DOM 结构与 CSS 类名已全面更新。
✅ 正确做法是使用专用于 dayGridMonth 视图的类名:
.fc-daygrid-week-number {
background-color: #d32f2f !important; /* 深红色背景 */
color: #ffffff !important; /* 白色文字 */
font-weight: 600;
}
⚠️ 重要注意事项:
- 该样式仅对 dayGridMonth 视图生效(即月视图)。FullCalendar 6 中其他视图(如 timeGridWeek、listWeek)渲染周数的方式不同,对应类名也不同:
- timeGridWeek / timeGridDay:周数显示在左侧时间轴旁,使用 .fc-timegrid-week-number;
- listWeek:周数作为列表标题的一部分,需定位 .fc-list-week-number。
- !important 在多数场景下仍需保留,因 FullCalendar 内联样式优先级较高;若追求更优雅的覆盖方式,可考虑在初始化时通过 themeSystem: 'standard' 配合 CSS 自定义变量(需 v6.1+ 支持),但直接 CSS 覆盖仍是最快捷方案。
? 示例:完整初始化配置片段
const calendar = new FullCalendar.Calendar(calendarEl, {
weekNumbers: true,
initialView: 'dayGridMonth',
// 其他配置...
});
最后提醒:务必确认你使用的 FullCalendar 版本为 v6.x(可通过 console.log(FullCalendar.VERSION) 验证)。若误用 v5 的文档或类名,将导致样式失效。建议始终查阅 官方 v6 CSS Classes 文档 获取最新类名规范。










