Swift中无需修改FSCalendar源码自定义HeaderView与WeekDaysView方案

可行性结论 #

完全不需要修改FSCalendar源码，也无需掌握Objective-C语法，Swift环境下可以通过官方暴露的属性、代理结合自定义平级视图的方案实现需求，不需要在原有视图上叠加覆盖，方案符合最优实践。

FSCalendar未开放HeaderView的子类化入口，采用以下方案实现完全自定义：

• 先隐藏自带Header：将calendar.headerHeight设置为0，自带Header会完全不占用布局空间，无需额外处理隐藏逻辑
• 自行创建纯Swift编写的自定义HeaderView，添加到FSCalendar的父视图中，与FSCalendar垂直排列，布局在日历上方，可任意添加交互按钮、自定义文本样式
• 状态同步逻辑：
  • 实现FSCalendarDelegate的calendarCurrentPageDidChange(_:)代理方法，当用户滑动日历切换月份时，更新自定义Header的月份展示文本
  • 自定义Header的上月/下月按钮点击时，调用calendar.setCurrentPage(_:animated:)方法，即可同步日历的展示页，完全不会出现状态不一致的问题

分两种场景选择方案：

2.1 仅修改样式（如加边框、改文字样式） #

直接遍历自带WeekDaysView的子视图修改属性即可，Swift示例代码：

// 修改星期文字基础样式
calendar.appearance.weekdayTextColor = .darkGray
calendar.appearance.weekdayFont = UIFont.systemFont(ofSize: 14, weight: .medium)
// 给每个星期标签加边框
for subview in calendar.weekdayView.subviews {
    guard let weekdayLabel = subview as? UILabel else { continue }
    weekdayLabel.layer.borderWidth = 1
    weekdayLabel.layer.borderColor = UIColor.lightGray.cgColor
    weekdayLabel.layer.cornerRadius = 4
    weekdayLabel.clipsToBounds = true
    // 可任意修改内边距、背景色等其他属性
}

2.2 完全自定义布局/添加交互 #

和Header的实现逻辑一致：

• 将calendar.weekdayHeight设置为0，隐藏自带星期栏
• 自定义纯Swift的星期栏视图，布局在自定义Header与FSCalendar之间即可，所有逻辑完全自主控制

业内大部分定制化需求都是通过以下组合方案实现，无需修改源码：

• 日期单元格自定义：官方支持注册FSCalendarCell的子类，和UITableView自定义Cell的逻辑一致，可实现日期单元格的完全自定义
• Header、星期栏自定义：采用上述隐藏自带视图+添加平级自定义视图的方案实现，性能稳定无冲突
• 细节样式调整：通过FSCalendarAppearance提供的公开属性、或遍历子视图修改属性的方式实现小范围样式调整

内容的提问来源于stack exchange，提问作者ofun