Angular 11 中FullCalendar V5后端事件变更后如何重新渲染日历事件
Angular11 + @fullcalendar/angular@5.5.0 事件更新不渲染的解决方法
核心问题原因
直接给绑定在calendarOptions里的events数组赋值新值不生效,本质是@fullcalendar/angular 5.x的封装逻辑决定的:
- 组件仅在初始化时一次性读取
calendarOptions的全量配置,不会深度监听options对象内部的属性变更 - 普通数组的引用变更如果没被封装层的输入检测捕获,就不会同步到FullCalendar内核触发重渲染
- 网上很多通用方案是针对4.x或者6.x版本编写的,套在5.5.0版本上因为API差异完全不生效
生产环境推荐方案:手动调用日历内核API更新事件
这种方法不会触发日历全量重初始化,能完整保留用户当前的视图状态,没有DOM闪烁问题
实现步骤
- 组件ts文件内引入需要的依赖:
import { ViewChild, ChangeDetectorRef } from '@angular/core'; import { FullCalendarComponent } from '@fullcalendar/angular'; import { EventInput } from '@fullcalendar/core'; - 类内部注入依赖、定义日历组件引用:
export class CalendarComponent { // 注入变更检测服务 constructor(private cdr: ChangeDetectorRef) {} // 绑定模板里的#calendar引用 @ViewChild('calendar') calendarComponent!: FullCalendarComponent; // 原有空事件数组保持不变 events: EventInput[] = []; // 原有calendarOptions配置保持不变,不需要额外修改 calendarOptions = { /* 你已配置的头部工具栏、视图、交互规则等逻辑 */ } } - 替换原来的数据流订阅逻辑:
ngOnInit(): void { this._calendarService.onDataChanged.subscribe((newEvents: EventInput[]) => { // 等下一个变更周期确保日历实例完全初始化 this.cdr.detectChanges(); // 防御性判断,避免组件未挂载时报错 if (!this.calendarComponent) return; // 获取日历内核实例 const calendarApi = this.calendarComponent.getApi(); // 清除所有旧的已渲染事件 calendarApi.removeAllEvents(); // 批量加入新事件,自动触发增量重渲染 calendarApi.addEventSource(newEvents); }) }
轻量实现方案:拆分events为独立输入绑定
如果不想手动调用内核API,可以利用封装层自带的输入检测逻辑,只要把events配置从calendarOptions里抽出来就行:
- 修改模板代码,给
<full-calendar>组件单独加events输入绑定:<full-calendar #calendar [options]="calendarOptions" [events]="events" ></full-calendar> - 从原有
calendarOptions配置里删掉events: this.events这段配置,不要在options对象里定义事件源 - 原来的订阅逻辑可以保持不变,只要给
this.events赋值的时候替换整个数组的引用(不能直接修改原数组元素、不能直接push),封装层就会自动检测到变化,触发事件重载:// 正确写法:替换整个数组引用 this.events = newEvents; // 错误写法:修改原数组,引用没变,检测不到 // this.events.push(...newEvents)
常见踩坑提醒
- 不要通过替换整个
calendarOptions对象的方式更新事件,这种操作会触发FullCalendar全量初始化,丢失用户当前的视图状态(比如停留的月份、选中的日期等),体验很差 - 不要用
*ngIf强制销毁重建日历组件的方案,DOM闪烁问题明显 - 不要单独调用
calendarApi.render()方法,5.x版本中removeAllEvents和addEventSource本身就会触发对应的DOM增量更新,单独调用render反而可能造成视图闪烁 - 如果订阅的数据流在组件初始化阶段就会触发,一定要加日历实例存在性的判断,避免出现
Cannot read property 'getApi' of undefined的报错
内容的提问来源于stack exchange,提问作者Parth Developer
相关产品推荐
相关产品推荐

