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覆蓋事件圓點、農(nóng)歷副標題、區(qū)間選擇等場景是 iOS 日期選擇器的主流選擇。本文精選20 個 FSCalendar 高頻問題從「today 置空」隱藏今日圓圈、頭部透明度調(diào)節(jié)到reloadData刷新日歷每條都給出可直接落地的解法與源碼位置。 新手建議先瀏覽README.md安裝與基礎(chǔ)用法與 MOREUSAGE.md進階用法與官方 QA?？焖偕鲜? 種方式安裝 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今天日期顯示偏移設(shè)置timeZone4頭部透明度/溶解效果headerMinimumDissolvedAlpha5修改月份顯示格式headerDateFormat6隱藏月份頭部headerHeight 07隱藏星期行weekdayHeight 08刷新日歷數(shù)據(jù)reloadData9限定可選日期范圍minimumDate/maximumDate10隱藏上月/下月占位日期placeholderType None11日歷縱向滾動scrollDirection Vertical12周模式只顯示一周scope Week13手勢切換月/周視圖handleScopeGesture:14日歷高度不自動更新實現(xiàn)boundingRectWillChange:15多日期選擇allowsMultipleSelection YES16禁止選中某些日期shouldSelectDate:返回 NO17區(qū)間選擇機票樣式多選 自定義 Cell18批量更換日歷顏色appearance屬性組19日期改方形 / 隱藏分隔線borderRadius/clipsToBounds20副標題顯示農(nóng)歷subtitleForDate:數(shù)據(jù)源一、今天圓圈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不只是讀取系統(tǒng)當天可以直接賦值為任意日期圓圈標記就會跟隨calendar.today [self.gregorian dateWithEra:1 year:2026 month:9 day:10 hour:0 minute:0 second:0 nanosecond:0];3?? 為什么「今天」偏移了一天時區(qū)設(shè)置時區(qū)不一致會導致 today 標記或跨天判斷偏差通過 timeZone 屬性FSCalendar.h#L244-L248 指定calendar.timeZone [NSTimeZone timeZoneWithName:Asia/Shanghai];二、月份頭部透明度、格式與隱藏4?? FSCalendar 頭部透明度怎么調(diào)溶解效果滾動時頭部月份會半透明「溶解」這個最低不透明度由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 在區(qū)間選擇場景中即這樣用calendar.headerHeight 0; // 隱藏「2026年9月」 calendar.weekdayHeight 0; // 隱藏「一二三四五六日」三、數(shù)據(jù)與刷新reloadData 和日期范圍8?? 網(wǎng)絡請求后如何刷新 FSCalendar 日歷和UITableView一樣FSCalendar 提供reloadData方法FSCalendar.h#L410-L413// 數(shù)據(jù)回來后調(diào)用事件圓點、副標題等全部重繪 [self.calendar reloadData];?? 小貼士避免在didSelectDate:回調(diào)里同步調(diào)用reloadData可能引起圓圈閃爍歷史 issue #475見 CHANGELOG.md#L153。9?? 限定 FSCalendar 可選日期范圍在數(shù)據(jù)源中實現(xiàn)minimumDate/maximumDate兩個方法FSCalendar.h#L81-L89- (NSDate *)minimumDateForCalendar:(FSCalendar *)calendar { return 起始日期; } - (NSDate *)maximumDateForCalendar:(FSCalendar *)calendar { return 截止日期; } 完整實例HidePlaceholderViewController.m#L127-L135。 隱藏上/下月的占位日期默認日歷會用灰色日期補齊 6 行想徹底隱藏請設(shè)置placeholderTypeFSCalendar.h#L320-L328calendar.placeholderType FSCalendarPlaceholderTypeNone;配合adjustsBoundingRectWhenChangingMonths YES可讓高度隨月份行數(shù)自適應完整寫法見 HidePlaceholderViewController.m#L61-L71。四、滾動與視圖模式周視圖與手勢1??1?? FSCalendar 如何縱向滾動calendar.scrollDirection .vertical默認是橫向按月翻頁FSCalendar.h#L282-L288。1??2?? 切換到周模式Week Scopecalendar.scope FSCalendarScopeWeek; 周模式下高度會變矮務必實現(xiàn)下一節(jié)的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需實現(xiàn)代理方法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 章節(jié)AutoLayout 中更新高度約束后調(diào)用layoutIfNeeded即可。五、選擇行為多選、禁選與區(qū)間選擇1??5?? FSCalendar 如何多日期選擇calendar.allowsMultipleSelection YES;代碼側(cè)編程選中可用selectDate:scrollToDate:FSCalendar.h#L431-L436已選日期通過只讀屬性selectedDates讀取。1??6?? 禁止選中某些日期如已約滿實現(xiàn)代理方法并返回NOFSCalendar.h#L115-L118- (BOOL)calendar:(FSCalendar *)calendar shouldSelectDate:(NSDate *)date atMonthPosition:(FSCalendarMonthPosition)position { return ![self isBooked:date]; // 滿房返回 NO }1??7?? 區(qū)間選擇怎么做機票/酒店樣式思路 多選 自定義 Cell 畫背景條allowsMultipleSelection YES只保留首尾兩個選中日注冊自定義 cell[calendar registerClass:[RangePickerCell class] forCellReuseIdentifier:cell]。官方完整實現(xiàn)RangePickerViewController.m RangePickerCell.m。六、外觀定制顏色、形狀與農(nóng)歷副標題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]; // 星期文字 需要按日期差異化配色如已選不同色、周末不同色時改用代理協(xié)議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?? 副標題顯示農(nóng)歷或其他文字在數(shù)據(jù)源實現(xiàn)subtitleForDate:FSCalendar.h#L71-L74用農(nóng)歷轉(zhuǎn)換器產(chǎn)出文字- (NSString *)calendar:(FSCalendar *)calendar subtitleForDate:(NSDate *)date { return [self.lunarFormatter stringFromDate:date]; // 如「初一」「端午」 } 農(nóng)歷實現(xiàn)源碼Objective-C 版 LunarFormatter.hSwift 版 LunarFormatter.swift。附贈3 個「順手提」的高頻點事件圓點數(shù)據(jù)源實現(xiàn)numberOfEventsForDate:返回圓點個數(shù)FSCalendar.h#L96-L103圓點顏色由eventDefaultColor/eventSelectionColor控制。日期格子放圖片數(shù)據(jù)源實現(xiàn)imageForDate:FSCalendar.h#L76-L79。自定義 Cell 整體重繪繼承FSCalendarCell注冊后在cellForDate:atMonthPosition:中返回官方示例 DIYCalendarCell.m#L18 展示了自定義「今天」圓環(huán)的畫法。延伸閱讀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給數(shù)據(jù)找dataSource管交互找delegate。20 個問題對應到這三類接口基本都能 30 秒內(nèi)定位解法。【免費下載鏈接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift項目地址: https://gitcode.com/gh_mirrors/fs/FSCalendar創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 FSCalendar高頻問題全解：today置空、頭部透明度、reloadData等20個疑難雜癥
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覆蓋事件圓點、農(nóng)歷副標題、區(qū)間選擇等場景是 iOS 日期選擇器的主流選擇。本文精選20 個 FSCalendar 高頻問題從「today 置空」隱藏今日圓圈、頭部透明度調(diào)節(jié)到reloadData刷新日歷每條都給出可直接落地的解法與源碼位置。 新手建議先瀏覽README.md安裝與基礎(chǔ)用法與 MOREUSAGE.md進階用法與官方 QA?？焖偕鲜? 種方式安裝 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今天日期顯示偏移設(shè)置timeZone4頭部透明度/溶解效果headerMinimumDissolvedAlpha5修改月份顯示格式headerDateFormat6隱藏月份頭部headerHeight 07隱藏星期行weekdayHeight 08刷新日歷數(shù)據(jù)reloadData9限定可選日期范圍minimumDate/maximumDate10隱藏上月/下月占位日期placeholderType None11日歷縱向滾動scrollDirection Vertical12周模式只顯示一周scope Week13手勢切換月/周視圖handleScopeGesture:14日歷高度不自動更新實現(xiàn)boundingRectWillChange:15多日期選擇allowsMultipleSelection YES16禁止選中某些日期shouldSelectDate:返回 NO17區(qū)間選擇機票樣式多選 自定義 Cell18批量更換日歷顏色appearance屬性組19日期改方形 / 隱藏分隔線borderRadius/clipsToBounds20副標題顯示農(nóng)歷subtitleForDate:數(shù)據(jù)源一、今天圓圈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不只是讀取系統(tǒng)當天可以直接賦值為任意日期圓圈標記就會跟隨calendar.today [self.gregorian dateWithEra:1 year:2026 month:9 day:10 hour:0 minute:0 second:0 nanosecond:0];3?? 為什么「今天」偏移了一天時區(qū)設(shè)置時區(qū)不一致會導致 today 標記或跨天判斷偏差通過 timeZone 屬性FSCalendar.h#L244-L248 指定calendar.timeZone [NSTimeZone timeZoneWithName:Asia/Shanghai];二、月份頭部透明度、格式與隱藏4?? FSCalendar 頭部透明度怎么調(diào)溶解效果滾動時頭部月份會半透明「溶解」這個最低不透明度由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 在區(qū)間選擇場景中即這樣用calendar.headerHeight 0; // 隱藏「2026年9月」 calendar.weekdayHeight 0; // 隱藏「一二三四五六日」三、數(shù)據(jù)與刷新reloadData 和日期范圍8?? 網(wǎng)絡請求后如何刷新 FSCalendar 日歷和UITableView一樣FSCalendar 提供reloadData方法FSCalendar.h#L410-L413// 數(shù)據(jù)回來后調(diào)用事件圓點、副標題等全部重繪 [self.calendar reloadData];?? 小貼士避免在didSelectDate:回調(diào)里同步調(diào)用reloadData可能引起圓圈閃爍歷史 issue #475見 CHANGELOG.md#L153。9?? 限定 FSCalendar 可選日期范圍在數(shù)據(jù)源中實現(xiàn)minimumDate/maximumDate兩個方法FSCalendar.h#L81-L89- (NSDate *)minimumDateForCalendar:(FSCalendar *)calendar { return 起始日期; } - (NSDate *)maximumDateForCalendar:(FSCalendar *)calendar { return 截止日期; } 完整實例HidePlaceholderViewController.m#L127-L135。 隱藏上/下月的占位日期默認日歷會用灰色日期補齊 6 行想徹底隱藏請設(shè)置placeholderTypeFSCalendar.h#L320-L328calendar.placeholderType FSCalendarPlaceholderTypeNone;配合adjustsBoundingRectWhenChangingMonths YES可讓高度隨月份行數(shù)自適應完整寫法見 HidePlaceholderViewController.m#L61-L71。四、滾動與視圖模式周視圖與手勢1??1?? FSCalendar 如何縱向滾動calendar.scrollDirection .vertical默認是橫向按月翻頁FSCalendar.h#L282-L288。1??2?? 切換到周模式Week Scopecalendar.scope FSCalendarScopeWeek; 周模式下高度會變矮務必實現(xiàn)下一節(jié)的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需實現(xiàn)代理方法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 章節(jié)AutoLayout 中更新高度約束后調(diào)用layoutIfNeeded即可。五、選擇行為多選、禁選與區(qū)間選擇1??5?? FSCalendar 如何多日期選擇calendar.allowsMultipleSelection YES;代碼側(cè)編程選中可用selectDate:scrollToDate:FSCalendar.h#L431-L436已選日期通過只讀屬性selectedDates讀取。1??6?? 禁止選中某些日期如已約滿實現(xiàn)代理方法并返回NOFSCalendar.h#L115-L118- (BOOL)calendar:(FSCalendar *)calendar shouldSelectDate:(NSDate *)date atMonthPosition:(FSCalendarMonthPosition)position { return ![self isBooked:date]; // 滿房返回 NO }1??7?? 區(qū)間選擇怎么做機票/酒店樣式思路 多選 自定義 Cell 畫背景條allowsMultipleSelection YES只保留首尾兩個選中日注冊自定義 cell[calendar registerClass:[RangePickerCell class] forCellReuseIdentifier:cell]。官方完整實現(xiàn)RangePickerViewController.m RangePickerCell.m。六、外觀定制顏色、形狀與農(nóng)歷副標題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]; // 星期文字 需要按日期差異化配色如已選不同色、周末不同色時改用代理協(xié)議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?? 副標題顯示農(nóng)歷或其他文字在數(shù)據(jù)源實現(xiàn)subtitleForDate:FSCalendar.h#L71-L74用農(nóng)歷轉(zhuǎn)換器產(chǎn)出文字- (NSString *)calendar:(FSCalendar *)calendar subtitleForDate:(NSDate *)date { return [self.lunarFormatter stringFromDate:date]; // 如「初一」「端午」 } 農(nóng)歷實現(xiàn)源碼Objective-C 版 LunarFormatter.hSwift 版 LunarFormatter.swift。附贈3 個「順手提」的高頻點事件圓點數(shù)據(jù)源實現(xiàn)numberOfEventsForDate:返回圓點個數(shù)FSCalendar.h#L96-L103圓點顏色由eventDefaultColor/eventSelectionColor控制。日期格子放圖片數(shù)據(jù)源實現(xiàn)imageForDate:FSCalendar.h#L76-L79。自定義 Cell 整體重繪繼承FSCalendarCell注冊后在cellForDate:atMonthPosition:中返回官方示例 DIYCalendarCell.m#L18 展示了自定義「今天」圓環(huán)的畫法。延伸閱讀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給數(shù)據(jù)找dataSource管交互找delegate。20 個問題對應到這三類接口基本都能 30 秒內(nèi)定位解法。【免費下載鏈接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift項目地址: https://gitcode.com/gh_mirrors/fs/FSCalendar創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考