Drupal 10中FullCalendar模块渲染完成后如何更新日历配置选项？

嘿，我之前在Drupal 10上用FullCalendar模块的时候，也琢磨过怎么在日历渲染完成后动态更新配置选项，踩了几个坑后总结出两个实用的方法，分享给你：

方法一：通过Drupal行为+FullCalendar原生API动态修改 #

FullCalendar本身提供了setOption和setOptions方法来修改已初始化日历的配置，结合Drupal的行为系统（Behaviors），我们可以安全地在日历渲染完成后获取实例并更新配置：

1. 在你的自定义主题或模块中创建一个JS文件（比如js/custom-fullcalendar.js），写入以下代码：

Drupal.behaviors.customFullCalendarConfigUpdate = {
  attach: function (context, settings) {
    // 使用once确保每个日历元素只处理一次
    once('custom-fc-config-update', '.fc', context).forEach(function(calendarElement) {
      // 获取已渲染的FullCalendar实例
      const calendarInstance = FullCalendar.getCalendar(calendarElement);
      if (calendarInstance) {
        // 示例1：修改单个配置项，比如隐藏周末
        calendarInstance.setOption('weekends', false);
        
        // 示例2：批量修改多个配置项
        calendarInstance.setOptions({
          firstDay: 1, // 把周一设为每周第一天
          slotDuration: '01:00:00', // 时间槽间隔改为1小时
          headerToolbar: {
            left: 'prev,next today',
            center: 'title',
            right: 'dayGridMonth,timeGridWeek'
          }
        });
        
        // 必要时调用render方法让配置生效
        calendarInstance.render();
      }
    });
  }
};

2. 让这个JS文件正确加载：在主题的[your-theme].libraries.yml中添加依赖配置，确保它在FullCalendar的JS之后加载：

custom_fullcalendar_config:
  js:
    js/custom-fullcalendar.js: {}
  dependencies:
    - fullcalendar/fullcalendar
    - core/drupal
    - core/once

方法二：通过PHP钩子提前调整初始配置（适合非动态场景） #

如果你的配置修改不需要完全动态，只是想在渲染前调整初始参数，可以用Drupal的钩子来修改FullCalendar的视图配置。比如在自定义模块中实现hook_fullcalendar_view_alter：

/**
 * Implements hook_fullcalendar_view_alter().
 */
function mymodule_fullcalendar_view_alter(array &$build, \Drupal\Core\Form\FormStateInterface $form_state) {
  // 针对特定视图和显示调整配置
  if ($build['#view_id'] === 'your_calendar_view' && $build['#display_id'] === 'fullcalendar') {
    // 修改初始配置项
    $build['#fullcalendar_settings']['weekends'] = FALSE;
    $build['#fullcalendar_settings']['firstDay'] = 1;
  }
}

注意事项 #

• 永远不要直接修改FullCalendar模块的核心代码，否则模块更新时你的修改会全部丢失，一定要用自定义主题或模块来扩展。
• 确保你使用的FullCalendar版本支持setOption/setOptions方法（Drupal 10对应的FullCalendar版本都是支持的）。

内容来源于stack exchange