Schedule-X 日历组件中实现每日重复事件的正确方式

在使用 Schedule-X 日历组件时，开发者可能会遇到一个常见问题：当尝试设置每日重复事件时，事件却意外显示为每周重复。本文将深入探讨这一问题的根源，并提供完整的解决方案。

问题现象

开发者在使用 Schedule-X 日历组件时，通过设置 RRULE:FREQ=DAILY;INTERVAL=1;COUNT=10 这样的规则来创建每日重复事件，但日历界面却错误地将其显示为每周重复事件。

问题根源

经过分析，这个问题源于重复规则(RRULE)的格式错误。Schedule-X 的重复事件插件在处理规则时，预期接收的是不带 RRULE: 前缀的规则字符串。直接使用完整的 RRULE 格式（包含前缀）会导致解析异常，从而回退到默认的每周重复设置。

正确实现方式

要正确实现每日重复事件，应该使用以下格式：

{
  id: 'event-id',
  start: '2024-06-10 09:00',
  end: '2024-06-10 10:00',
  title: '每日会议',
  rrule: 'FREQ=DAILY;INTERVAL=1;COUNT=10'
}

关键点在于：

1. rrule 属性值不应包含 RRULE: 前缀
2. 直接使用规则部分（FREQ=DAILY...）

完整配置示例

以下是一个完整的 Vue 组件配置示例，展示了如何正确设置每日重复事件：

const calendarApp = createCalendar({
  events: [
    {
      id: 'daily-meeting',
      start: '2024-06-10 09:00',
      end: '2024-06-10 10:00',
      title: '每日站会',
      rrule: 'FREQ=DAILY;INTERVAL=1;COUNT=5'
    }
  ],
  plugins: [createEventRecurrencePlugin()],
  // 其他配置...
});

进阶用法

除了基本的每日重复，Schedule-X 的重复事件插件还支持多种复杂规则：

1. 工作日重复：FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR
2. 每N天重复：FREQ=DAILY;INTERVAL=3（每3天）
3. 带结束日期的重复：FREQ=DAILY;UNTIL=20240630T090000
4. 带例外日期的重复：配合 exdate 属性使用

注意事项

1. 确保使用的 Schedule-X 各组件版本一致
2. 重复事件插件(@schedule-x/event-recurrence)必须正确注册
3. 对于复杂规则，建议先在 RRULE 验证工具中测试规则有效性
4. 时区处理：重复规则中的时间会遵循日历的时区设置

总结

通过避免在 rrule 属性值中添加 RRULE: 前缀，开发者可以正确实现 Schedule-X 中的每日重复事件功能。理解这一细微但关键的格式差异，能够帮助开发者充分利用 Schedule-X 强大的重复事件功能，构建更丰富的日历应用。