You need to enable JavaScript to run this app. SwiftUI使用CalendarKit添加测试事件无法显示的问题求助
优惠活动
大模型
产品
解决方案
定价
更多

SwiftUI使用CalendarKit添加测试事件无法显示的问题求助

CalendarKit 事件不显示的问题定位与修复方案

核心问题根源

你当前的实现存在三个关键错误,直接导致事件无法正常渲染:

  • 误用非公开的渲染触发API:dayView.create(event:)是日历交互流程中用于创建可编辑临时草稿事件的内部方法,并非用于注册静态展示事件的接口,该调用不会将事件纳入日历的渲染队列
  • 缺失必须的数据源协议实现:CalendarKit 要求必须通过遵循EventDataSource协议的对象返回事件数组,你当前仅设置了代理,未配置数据源,日历没有获取事件的入口
  • 测试事件的时间边界设置不合理:将瞬时时间同时作为startDate、endDate且标记为全天事件,不符合CalendarKit对全天事件的时间计算规则,可能被判定为无效展示范围

分步修复方案

  1. 调整Coordinator的协议遵循关系,让它同时作为日历的数据源与代理:
    • 给Coordinator添加EventDataSource协议的遵循声明
    • 实现协议强制要求的eventsForDate(_:)方法,从内部事件列表中筛选对应展示日期的事件返回
  2. 修正控制器的配置逻辑
    • 为DayViewController同时设置delegate和dataSource属性,将两者都指向Coordinator实例
    • 删除所有对dayView.create(event:)的错误调用
  3. 修正测试事件的时间边界
    • 全天事件的startDate需对齐到当天的0点时刻,endDate对齐到次日的0点时刻,不要直接使用瞬时的当前时间作为时间边界
    • 构造完成的事件存入Coordinator持有的事件数组中
  4. 触发视图刷新
    • 事件配置完成后手动调用dayView.reloadData(),让日历重新从数据源拉取最新的事件列表
    • 可通过dayView.move(to: Date(), animated: false)将日历默认定位到当前日期,避免默认展示日期与事件日期不匹配导致的不可见

修正后的核心参考代码

struct TestingCalendarController: UIViewControllerRepresentable {
    @Binding var eventDates: [Date]
    
    func makeCoordinator() -> Coordinator {
        return Coordinator()
    }
    
    func makeUIViewController(context: Context) -> DayViewController {
        let dayView = DayViewController()
        // 同时绑定代理与数据源
        dayView.delegate = context.coordinator
        dayView.dataSource = context.coordinator
        
        // 原有样式配置保留
        var style = CalendarStyle()
        style.timeline.timeIndicator.color = .systemBlue
        style.header.daySelector.todayActiveTextColor = .white
        style.header.daySelector.selectedBackgroundColor = UIColor(.primary)
        style.header.daySelector.todayInactiveTextColor = .systemBlue
        style.header.daySelector.todayActiveBackgroundColor = .systemBlue
        style.header.swipeLabel.font = .systemFont(ofSize: 0.0)
        dayView.updateStyle(style)
        
        // 构造符合规则的测试事件
        let calendar = Calendar.current
        let todayStart = calendar.startOfDay(for: Date())
        let testEvent = Event()
        testEvent.startDate = todayStart
        testEvent.endDate = calendar.date(byAdding: .day, value: 1, to: todayStart)!
        testEvent.isAllDay = true
        testEvent.text = "Testing Event"
        // 存入Coordinator的事件列表
        context.coordinator.eventList = [testEvent]
        
        // 定位到当前日期并刷新渲染
        dayView.move(to: Date(), animated: false)
        dayView.reloadData()
        
        return dayView
    }
    
    func updateUIViewController(_ dayView: DayViewController, context: Context) {
        dayView.delegate = context.coordinator
        dayView.dataSource = context.coordinator
    }
    
    class Coordinator: NSObject, DayViewDelegate, EventDataSource {
        // 内部持有事件列表,避免SwiftUI重绘导致的内存问题
        var eventList: [EventDescriptor] = []
        
        // 实现EventDataSource要求的事件返回方法
        func eventsForDate(_ date: Date) -> [EventDescriptor] {
            // 筛选出与当前展示日期同天的事件返回
            return eventList.filter { event in
                Calendar.current.isDate(event.startDate, inSameDayAs: date)
            }
        }
        
        // 原有DayViewDelegate的方法保持不变
        func dayViewDidSelectEventView(_ eventView: EventView) { }
        func dayViewDidLongPressEventView(_ eventView: EventView) { }
        func dayView(dayView: DayViewController, didTapTimelineAt date: Date) { }
        func dayView(dayView: DayViewController, didLongPressTimelineAt date: Date) { }
        func dayViewDidBeginDragging(dayView: DayViewController) { }
        func dayViewDidTransitionCancel(dayView: DayViewController) { }
        func dayView(dayView: DayViewController, willMoveTo date: Date) {
            print("Date \(date)")
        }
        func dayView(dayView: DayViewController, didMoveTo date: Date) { }
        func dayView(dayView: DayViewController, didUpdate event: EventDescriptor) { }
    }
}

常见避坑提示

  • 不要在makeUIViewController的局部作用域内持有事件数组,否则SwiftUI触发视图更新时会导致事件列表被释放,出现事件消失的问题
  • 新增、修改、删除事件后必须调用reloadData(),否则日历不会主动感知数据源的变化
  • 检查事件的时间与日历当前展示的时间范围是否匹配,超出展示范围的事件不会被渲染

内容的提问来源于stack exchange,提问作者Carterman

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 06:45:02