FSCalendar高频问题全解today置空、头部透明度、reloadData等20个疑难杂症【免费下载链接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift项目地址: https://gitcode.com/gh_mirrors/fs/FSCalendarFSCalendar 是一款高度可定制的 iOS 日历控件兼容 Objective-C 与 Swift覆盖事件圆点、农历副标题、区间选择等场景是 iOS 日期选择器的主流选择。本文精选20 个 FSCalendar 高频问题从「today 置空」隐藏今日圆圈、头部透明度调节到reloadData刷新日历每条都给出可直接落地的解法与源码位置。 新手建议先浏览README.md安装与基础用法与 MOREUSAGE.md进阶用法与官方 QA。快速上手3 种方式安装 FSCalendar# CocoaPods pod FSCalendar// Swift Package Manager .package(url: https://github.com/WenchaoD/FSCalendar.git, from: 2.8.4)手动集成把 FSCalendar/ 目录下的全部源文件拖入工程即可。版本信息见 FSCalendar.podspec 与 Package.swift。速查表20 个 FSCalendar 疑难杂症一键定位#问题一行解法1隐藏「今天」圆圈today nil2「今天」高亮指定日期today 目标日期3今天日期显示偏移设置timeZone4头部透明度/溶解效果headerMinimumDissolvedAlpha5修改月份显示格式headerDateFormat6隐藏月份头部headerHeight 07隐藏星期行weekdayHeight 08刷新日历数据reloadData9限定可选日期范围minimumDate/maximumDate10隐藏上月/下月占位日期placeholderType None11日历纵向滚动scrollDirection Vertical12周模式只显示一周scope Week13手势切换月/周视图handleScopeGesture:14日历高度不自动更新实现boundingRectWillChange:15多日期选择allowsMultipleSelection YES16禁止选中某些日期shouldSelectDate:返回 NO17区间选择机票样式多选 自定义 Cell18批量更换日历颜色appearance属性组19日期改方形 / 隐藏分隔线borderRadius/clipsToBounds20副标题显示农历subtitleForDate:数据源一、今天圆圈today 置空与高亮定制1️⃣ 如何隐藏 FSCalendar 的「今天」圆圈只需将today属性置空见 FSCalendar.h#L261-L263calendar.today nil; // Hide the today circle官方示例 DIYExampleViewController.m#L56、RangePickerViewController.m#L65 都是这么写的Swift 示例见 DIYExampleViewController.swift#L43。2️⃣ 如何把「今天」高亮移动到别的日期today不只是读取系统当天可以直接赋值为任意日期圆圈标记就会跟随calendar.today [self.gregorian dateWithEra:1 year:2026 month:9 day:10 hour:0 minute:0 second:0 nanosecond:0];3️⃣ 为什么「今天」偏移了一天时区设置时区不一致会导致 today 标记或跨天判断偏差通过 timeZone 属性FSCalendar.h#L244-L248 指定calendar.timeZone [NSTimeZone timeZoneWithName:Asia/Shanghai];二、月份头部透明度、格式与隐藏4️⃣ FSCalendar 头部透明度怎么调溶解效果滚动时头部月份会半透明「溶解」这个最低不透明度由headerMinimumDissolvedAlpha控制FSCalendarAppearance.h#L127-L130// 0.0 完全透明 calendar.appearance.headerMinimumDissolvedAlpha 0.0;该问题源自官方 QAMOREUSAGE.md#L360-L365一行代码即可解决。5️⃣ 修改月份头部显示格式如带年份通过headerDateFormat自定义FSCalendarAppearance.h#L117-L120calendar.appearance.headerDateFormat yyyy年M月6️⃣ 完全隐藏月份头部 / 7️⃣ 隐藏星期行两个高度属性分别控制headerHeight 0隐藏月份头部FSCalendar.h#L335-L338weekdayHeight 0隐藏星期行RangePickerViewController.m#L61 在区间选择场景中即这样用calendar.headerHeight 0; // 隐藏「2026年9月」 calendar.weekdayHeight 0; // 隐藏「一二三四五六日」三、数据与刷新reloadData 和日期范围8️⃣ 网络请求后如何刷新 FSCalendar 日历和UITableView一样FSCalendar 提供reloadData方法FSCalendar.h#L410-L413// 数据回来后调用事件圆点、副标题等全部重绘 [self.calendar reloadData];⚠️ 小贴士避免在didSelectDate:回调里同步调用reloadData可能引起圆圈闪烁历史 issue #475见 CHANGELOG.md#L153。9️⃣ 限定 FSCalendar 可选日期范围在数据源中实现minimumDate/maximumDate两个方法FSCalendar.h#L81-L89- (NSDate *)minimumDateForCalendar:(FSCalendar *)calendar { return 起始日期; } - (NSDate *)maximumDateForCalendar:(FSCalendar *)calendar { return 截止日期; } 完整实例HidePlaceholderViewController.m#L127-L135。 隐藏上/下月的占位日期默认日历会用灰色日期补齐 6 行想彻底隐藏请设置placeholderTypeFSCalendar.h#L320-L328calendar.placeholderType FSCalendarPlaceholderTypeNone;配合adjustsBoundingRectWhenChangingMonths YES可让高度随月份行数自适应完整写法见 HidePlaceholderViewController.m#L61-L71。四、滚动与视图模式周视图与手势1️⃣1️⃣ FSCalendar 如何纵向滚动calendar.scrollDirection .vertical默认是横向按月翻页FSCalendar.h#L282-L288。1️⃣2️⃣ 切换到周模式Week Scopecalendar.scope FSCalendarScopeWeek; 周模式下高度会变矮务必实现下一节的boundingRectWillChange:否则 frame 不会自适应见 MOREUSAGE.md#L35-L55。1️⃣3️⃣ 手势上下滑动切换「月/周」视图UIPanGestureRecognizer *scopeGesture [[UIPanGestureRecognizer alloc] initWithTarget:calendar action:selector(handleScopeGesture:)]; [calendar addGestureRecognizer:scopeGesture];交互示例工程FSCalendarScopeExampleViewController.m 与 FSCalendarScopeViewController.swift。1️⃣4️⃣ 日历高度不更新 / 切换模式后布局错乱FSCalendar 不会自己改 frame需实现代理方法boundingRectWillChange:FSCalendar.h#L136-L139- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated { calendar.frame (CGRect){calendar.frame.origin, bounds.size}; [self.view layoutIfNeeded]; }Masonry / SnapKit 写法见 README.md 的 Warning 章节AutoLayout 中更新高度约束后调用layoutIfNeeded即可。五、选择行为多选、禁选与区间选择1️⃣5️⃣ FSCalendar 如何多日期选择calendar.allowsMultipleSelection YES;代码侧编程选中可用selectDate:scrollToDate:FSCalendar.h#L431-L436已选日期通过只读属性selectedDates读取。1️⃣6️⃣ 禁止选中某些日期如已约满实现代理方法并返回NOFSCalendar.h#L115-L118- (BOOL)calendar:(FSCalendar *)calendar shouldSelectDate:(NSDate *)date atMonthPosition:(FSCalendarMonthPosition)position { return ![self isBooked:date]; // 满房返回 NO }1️⃣7️⃣ 区间选择怎么做机票/酒店样式思路 多选 自定义 Cell 画背景条allowsMultipleSelection YES只保留首尾两个选中日注册自定义 cell[calendar registerClass:[RangePickerCell class] forCellReuseIdentifier:cell]。官方完整实现RangePickerViewController.m RangePickerCell.m。六、外观定制颜色、形状与农历副标题1️⃣8️⃣ 批量更换 FSCalendar 颜色选中/今天/边框全局颜色都挂在appearance对象上FSCalendarAppearance.h#L182-L205calendar.appearance.selectionColor [UIColor systemBlueColor]; // 选中填充 calendar.appearance.todayColor [UIColor orangeColor]; // 今天填充 calendar.appearance.todaySelectionColor [UIColor blackColor]; // 今天选中 calendar.appearance.weekdayTextColor [UIColor redColor]; // 星期文字 需要按日期差异化配色如已选不同色、周末不同色时改用代理协议FSCalendarDelegateAppearance逐日返回颜色接口清单见 FSCalendar.h#L153-L238。1️⃣9️⃣ 日期格子改方形 / 隐藏分隔线圆形 ↔ 方形borderRadius取值 1 为圆、0 为矩形FSCalendarAppearance.h#L206-L210calendar.appearance.borderRadius 0; // 方形日期格隐藏首尾越界线条calendar.clipsToBounds YES见 MOREUSAGE.md#L249-L263。2️⃣0️⃣ 副标题显示农历或其他文字在数据源实现subtitleForDate:FSCalendar.h#L71-L74用农历转换器产出文字- (NSString *)calendar:(FSCalendar *)calendar subtitleForDate:(NSDate *)date { return [self.lunarFormatter stringFromDate:date]; // 如「初一」「端午」 } 农历实现源码Objective-C 版 LunarFormatter.hSwift 版 LunarFormatter.swift。附赠3 个「顺手提」的高频点事件圆点数据源实现numberOfEventsForDate:返回圆点个数FSCalendar.h#L96-L103圆点颜色由eventDefaultColor/eventSelectionColor控制。日期格子放图片数据源实现imageForDate:FSCalendar.h#L76-L79。自定义 Cell 整体重绘继承FSCalendarCell注册后在cellForDate:atMonthPosition:中返回官方示例 DIYCalendarCell.m#L18 展示了自定义「今天」圆环的画法。延伸阅读FSCalendar 源码与示例导航文件说明FSCalendar/FSCalendar.h核心 APItoday、scope、reloadData、选中等FSCalendar/FSCalendarAppearance.h外观属性颜色、字体、圆角、头部格式FSCalendar/FSCalendarCell.h日期格子视图自定义 Cell 的基类MOREUSAGE.md官方进阶用法 QA 原始出处Example-Objc/Objective-C 全功能示例工程Example-Swift/Swift 示例工程FSCalendar/include/对外头文件与 modulemap✅ 记住三板斧改外观找appearance给数据找dataSource管交互找delegate。20 个问题对应到这三类接口基本都能 30 秒内定位解法。【免费下载链接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift项目地址: https://gitcode.com/gh_mirrors/fs/FSCalendar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考