疑難雜癥)
FSCalendar高頻問題全解today置空、頭部透明度、reloadData等20個(gè)疑難雜癥【免費(fèi)下載鏈接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift項(xiàng)目地址: https://gitcode.com/gh_mirrors/fs/FSCalendarFSCalendar 是一款高度可定制的 iOS 日歷控件兼容 Objective-C 與 Swift覆蓋事件圓點(diǎn)、農(nóng)歷副標(biāo)題、區(qū)間選擇等場(chǎng)景是 iOS 日期選擇器的主流選擇。本文精選20 個(gè) FSCalendar 高頻問題從「today 置空」隱藏今日?qǐng)A圈、頭部透明度調(diào)節(jié)到reloadData刷新日歷每條都給出可直接落地的解法與源碼位置。 新手建議先瀏覽README.md安裝與基礎(chǔ)用法與 MOREUSAGE.md進(jìn)階用法與官方 QA。快速上手3 種方式安裝 FSCalendar# CocoaPods pod FSCalendar// Swift Package Manager .package(url: https://github.com/WenchaoD/FSCalendar.git, from: 2.8.4)手動(dòng)集成把 FSCalendar/ 目錄下的全部源文件拖入工程即可。版本信息見 FSCalendar.podspec 與 Package.swift。速查表20 個(gè) FSCalendar 疑難雜癥一鍵定位#問題一行解法1隱藏「今天」圓圈today nil2「今天」高亮指定日期today 目標(biāo)日期3今天日期顯示偏移設(shè)置timeZone4頭部透明度/溶解效果headerMinimumDissolvedAlpha5修改月份顯示格式headerDateFormat6隱藏月份頭部headerHeight 07隱藏星期行weekdayHeight 08刷新日歷數(shù)據(jù)reloadData9限定可選日期范圍minimumDate/maximumDate10隱藏上月/下月占位日期placeholderType None11日歷縱向滾動(dòng)scrollDirection Vertical12周模式只顯示一周scope Week13手勢(shì)切換月/周視圖handleScopeGesture:14日歷高度不自動(dòng)更新實(shí)現(xiàn)boundingRectWillChange:15多日期選擇allowsMultipleSelection YES16禁止選中某些日期shouldSelectDate:返回 NO17區(qū)間選擇機(jī)票樣式多選 自定義 Cell18批量更換日歷顏色appearance屬性組19日期改方形 / 隱藏分隔線borderRadius/clipsToBounds20副標(biāo)題顯示農(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?? 如何把「今天」高亮移動(dòng)到別的日期today不只是讀取系統(tǒng)當(dāng)天可以直接賦值為任意日期圓圈標(biāo)記就會(huì)跟隨calendar.today [self.gregorian dateWithEra:1 year:2026 month:9 day:10 hour:0 minute:0 second:0 nanosecond:0];3?? 為什么「今天」偏移了一天時(shí)區(qū)設(shè)置時(shí)區(qū)不一致會(huì)導(dǎo)致 today 標(biāo)記或跨天判斷偏差通過 timeZone 屬性FSCalendar.h#L244-L248 指定calendar.timeZone [NSTimeZone timeZoneWithName:Asia/Shanghai];二、月份頭部透明度、格式與隱藏4?? FSCalendar 頭部透明度怎么調(diào)溶解效果滾動(dòng)時(shí)頭部月份會(huì)半透明「溶解」這個(gè)最低不透明度由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?? 隱藏星期行兩個(gè)高度屬性分別控制headerHeight 0隱藏月份頭部FSCalendar.h#L335-L338weekdayHeight 0隱藏星期行RangePickerViewController.m#L61 在區(qū)間選擇場(chǎng)景中即這樣用calendar.headerHeight 0; // 隱藏「2026年9月」 calendar.weekdayHeight 0; // 隱藏「一二三四五六日」三、數(shù)據(jù)與刷新reloadData 和日期范圍8?? 網(wǎng)絡(luò)請(qǐng)求后如何刷新 FSCalendar 日歷和UITableView一樣FSCalendar 提供reloadData方法FSCalendar.h#L410-L413// 數(shù)據(jù)回來后調(diào)用事件圓點(diǎn)、副標(biāo)題等全部重繪 [self.calendar reloadData];?? 小貼士避免在didSelectDate:回調(diào)里同步調(diào)用reloadData可能引起圓圈閃爍歷史 issue #475見 CHANGELOG.md#L153。9?? 限定 FSCalendar 可選日期范圍在數(shù)據(jù)源中實(shí)現(xiàn)minimumDate/maximumDate兩個(gè)方法FSCalendar.h#L81-L89- (NSDate *)minimumDateForCalendar:(FSCalendar *)calendar { return 起始日期; } - (NSDate *)maximumDateForCalendar:(FSCalendar *)calendar { return 截止日期; } 完整實(shí)例HidePlaceholderViewController.m#L127-L135。 隱藏上/下月的占位日期默認(rèn)日歷會(huì)用灰色日期補(bǔ)齊 6 行想徹底隱藏請(qǐng)?jiān)O(shè)置placeholderTypeFSCalendar.h#L320-L328calendar.placeholderType FSCalendarPlaceholderTypeNone;配合adjustsBoundingRectWhenChangingMonths YES可讓高度隨月份行數(shù)自適應(yīng)完整寫法見 HidePlaceholderViewController.m#L61-L71。四、滾動(dòng)與視圖模式周視圖與手勢(shì)1??1?? FSCalendar 如何縱向滾動(dòng)calendar.scrollDirection .vertical默認(rèn)是橫向按月翻頁(yè)FSCalendar.h#L282-L288。1??2?? 切換到周模式Week Scopecalendar.scope FSCalendarScopeWeek; 周模式下高度會(huì)變矮務(wù)必實(shí)現(xiàn)下一節(jié)的boundingRectWillChange:否則 frame 不會(huì)自適應(yīng)見 MOREUSAGE.md#L35-L55。1??3?? 手勢(shì)上下滑動(dòng)切換「月/周」視圖UIPanGestureRecognizer *scopeGesture [[UIPanGestureRecognizer alloc] initWithTarget:calendar action:selector(handleScopeGesture:)]; [calendar addGestureRecognizer:scopeGesture];交互示例工程FSCalendarScopeExampleViewController.m 與 FSCalendarScopeViewController.swift。1??4?? 日歷高度不更新 / 切換模式后布局錯(cuò)亂FSCalendar 不會(huì)自己改 frame需實(shí)現(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?? 禁止選中某些日期如已約滿實(shí)現(xiàn)代理方法并返回NOFSCalendar.h#L115-L118- (BOOL)calendar:(FSCalendar *)calendar shouldSelectDate:(NSDate *)date atMonthPosition:(FSCalendarMonthPosition)position { return ![self isBooked:date]; // 滿房返回 NO }1??7?? 區(qū)間選擇怎么做機(jī)票/酒店樣式思路 多選 自定義 Cell 畫背景條allowsMultipleSelection YES只保留首尾兩個(gè)選中日注冊(cè)自定義 cell[calendar registerClass:[RangePickerCell class] forCellReuseIdentifier:cell]。官方完整實(shí)現(xiàn)RangePickerViewController.m RangePickerCell.m。六、外觀定制顏色、形狀與農(nóng)歷副標(biāo)題1??8?? 批量更換 FSCalendar 顏色選中/今天/邊框全局顏色都掛在appearance對(duì)象上FSCalendarAppearance.h#L182-L205calendar.appearance.selectionColor [UIColor systemBlueColor]; // 選中填充 calendar.appearance.todayColor [UIColor orangeColor]; // 今天填充 calendar.appearance.todaySelectionColor [UIColor blackColor]; // 今天選中 calendar.appearance.weekdayTextColor [UIColor redColor]; // 星期文字 需要按日期差異化配色如已選不同色、周末不同色時(shí)改用代理協(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?? 副標(biāo)題顯示農(nóng)歷或其他文字在數(shù)據(jù)源實(shí)現(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)歷實(shí)現(xiàn)源碼Objective-C 版 LunarFormatter.hSwift 版 LunarFormatter.swift。附贈(zèng)3 個(gè)「順手提」的高頻點(diǎn)事件圓點(diǎn)數(shù)據(jù)源實(shí)現(xiàn)numberOfEventsForDate:返回圓點(diǎn)個(gè)數(shù)FSCalendar.h#L96-L103圓點(diǎn)顏色由eventDefaultColor/eventSelectionColor控制。日期格子放圖片數(shù)據(jù)源實(shí)現(xiàn)imageForDate:FSCalendar.h#L76-L79。自定義 Cell 整體重繪繼承FSCalendarCell注冊(cè)后在cellForDate:atMonthPosition:中返回官方示例 DIYCalendarCell.m#L18 展示了自定義「今天」圓環(huán)的畫法。延伸閱讀FSCalendar 源碼與示例導(dǎo)航文件說明FSCalendar/FSCalendar.h核心 APItoday、scope、reloadData、選中等FSCalendar/FSCalendarAppearance.h外觀屬性顏色、字體、圓角、頭部格式FSCalendar/FSCalendarCell.h日期格子視圖自定義 Cell 的基類MOREUSAGE.md官方進(jìn)階用法 QA 原始出處Example-Objc/Objective-C 全功能示例工程Example-Swift/Swift 示例工程FSCalendar/include/對(duì)外頭文件與 modulemap? 記住三板斧改外觀找appearance給數(shù)據(jù)找dataSource管交互找delegate。20 個(gè)問題對(duì)應(yīng)到這三類接口基本都能 30 秒內(nèi)定位解法?！久赓M(fèi)下載鏈接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift項(xiàng)目地址: https://gitcode.com/gh_mirrors/fs/FSCalendar創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 FSCalendar高頻問題全解：today置空、頭部透明度、reloadData等20個(gè)疑難雜癥
FSCalendar高頻問題全解today置空、頭部透明度、reloadData等20個(gè)疑難雜癥【免費(fèi)下載鏈接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift項(xiàng)目地址: https://gitcode.com/gh_mirrors/fs/FSCalendarFSCalendar 是一款高度可定制的 iOS 日歷控件兼容 Objective-C 與 Swift覆蓋事件圓點(diǎn)、農(nóng)歷副標(biāo)題、區(qū)間選擇等場(chǎng)景是 iOS 日期選擇器的主流選擇。本文精選20 個(gè) FSCalendar 高頻問題從「today 置空」隱藏今日?qǐng)A圈、頭部透明度調(diào)節(jié)到reloadData刷新日歷每條都給出可直接落地的解法與源碼位置。 新手建議先瀏覽README.md安裝與基礎(chǔ)用法與 MOREUSAGE.md進(jìn)階用法與官方 QA。快速上手3 種方式安裝 FSCalendar# CocoaPods pod FSCalendar// Swift Package Manager .package(url: https://github.com/WenchaoD/FSCalendar.git, from: 2.8.4)手動(dòng)集成把 FSCalendar/ 目錄下的全部源文件拖入工程即可。版本信息見 FSCalendar.podspec 與 Package.swift。速查表20 個(gè) FSCalendar 疑難雜癥一鍵定位#問題一行解法1隱藏「今天」圓圈today nil2「今天」高亮指定日期today 目標(biāo)日期3今天日期顯示偏移設(shè)置timeZone4頭部透明度/溶解效果headerMinimumDissolvedAlpha5修改月份顯示格式headerDateFormat6隱藏月份頭部headerHeight 07隱藏星期行weekdayHeight 08刷新日歷數(shù)據(jù)reloadData9限定可選日期范圍minimumDate/maximumDate10隱藏上月/下月占位日期placeholderType None11日歷縱向滾動(dòng)scrollDirection Vertical12周模式只顯示一周scope Week13手勢(shì)切換月/周視圖handleScopeGesture:14日歷高度不自動(dòng)更新實(shí)現(xiàn)boundingRectWillChange:15多日期選擇allowsMultipleSelection YES16禁止選中某些日期shouldSelectDate:返回 NO17區(qū)間選擇機(jī)票樣式多選 自定義 Cell18批量更換日歷顏色appearance屬性組19日期改方形 / 隱藏分隔線borderRadius/clipsToBounds20副標(biāo)題顯示農(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?? 如何把「今天」高亮移動(dòng)到別的日期today不只是讀取系統(tǒng)當(dāng)天可以直接賦值為任意日期圓圈標(biāo)記就會(huì)跟隨calendar.today [self.gregorian dateWithEra:1 year:2026 month:9 day:10 hour:0 minute:0 second:0 nanosecond:0];3?? 為什么「今天」偏移了一天時(shí)區(qū)設(shè)置時(shí)區(qū)不一致會(huì)導(dǎo)致 today 標(biāo)記或跨天判斷偏差通過 timeZone 屬性FSCalendar.h#L244-L248 指定calendar.timeZone [NSTimeZone timeZoneWithName:Asia/Shanghai];二、月份頭部透明度、格式與隱藏4?? FSCalendar 頭部透明度怎么調(diào)溶解效果滾動(dòng)時(shí)頭部月份會(huì)半透明「溶解」這個(gè)最低不透明度由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?? 隱藏星期行兩個(gè)高度屬性分別控制headerHeight 0隱藏月份頭部FSCalendar.h#L335-L338weekdayHeight 0隱藏星期行RangePickerViewController.m#L61 在區(qū)間選擇場(chǎng)景中即這樣用calendar.headerHeight 0; // 隱藏「2026年9月」 calendar.weekdayHeight 0; // 隱藏「一二三四五六日」三、數(shù)據(jù)與刷新reloadData 和日期范圍8?? 網(wǎng)絡(luò)請(qǐng)求后如何刷新 FSCalendar 日歷和UITableView一樣FSCalendar 提供reloadData方法FSCalendar.h#L410-L413// 數(shù)據(jù)回來后調(diào)用事件圓點(diǎn)、副標(biāo)題等全部重繪 [self.calendar reloadData];?? 小貼士避免在didSelectDate:回調(diào)里同步調(diào)用reloadData可能引起圓圈閃爍歷史 issue #475見 CHANGELOG.md#L153。9?? 限定 FSCalendar 可選日期范圍在數(shù)據(jù)源中實(shí)現(xiàn)minimumDate/maximumDate兩個(gè)方法FSCalendar.h#L81-L89- (NSDate *)minimumDateForCalendar:(FSCalendar *)calendar { return 起始日期; } - (NSDate *)maximumDateForCalendar:(FSCalendar *)calendar { return 截止日期; } 完整實(shí)例HidePlaceholderViewController.m#L127-L135。 隱藏上/下月的占位日期默認(rèn)日歷會(huì)用灰色日期補(bǔ)齊 6 行想徹底隱藏請(qǐng)?jiān)O(shè)置placeholderTypeFSCalendar.h#L320-L328calendar.placeholderType FSCalendarPlaceholderTypeNone;配合adjustsBoundingRectWhenChangingMonths YES可讓高度隨月份行數(shù)自適應(yīng)完整寫法見 HidePlaceholderViewController.m#L61-L71。四、滾動(dòng)與視圖模式周視圖與手勢(shì)1??1?? FSCalendar 如何縱向滾動(dòng)calendar.scrollDirection .vertical默認(rèn)是橫向按月翻頁(yè)FSCalendar.h#L282-L288。1??2?? 切換到周模式Week Scopecalendar.scope FSCalendarScopeWeek; 周模式下高度會(huì)變矮務(wù)必實(shí)現(xiàn)下一節(jié)的boundingRectWillChange:否則 frame 不會(huì)自適應(yīng)見 MOREUSAGE.md#L35-L55。1??3?? 手勢(shì)上下滑動(dòng)切換「月/周」視圖UIPanGestureRecognizer *scopeGesture [[UIPanGestureRecognizer alloc] initWithTarget:calendar action:selector(handleScopeGesture:)]; [calendar addGestureRecognizer:scopeGesture];交互示例工程FSCalendarScopeExampleViewController.m 與 FSCalendarScopeViewController.swift。1??4?? 日歷高度不更新 / 切換模式后布局錯(cuò)亂FSCalendar 不會(huì)自己改 frame需實(shí)現(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?? 禁止選中某些日期如已約滿實(shí)現(xiàn)代理方法并返回NOFSCalendar.h#L115-L118- (BOOL)calendar:(FSCalendar *)calendar shouldSelectDate:(NSDate *)date atMonthPosition:(FSCalendarMonthPosition)position { return ![self isBooked:date]; // 滿房返回 NO }1??7?? 區(qū)間選擇怎么做機(jī)票/酒店樣式思路 多選 自定義 Cell 畫背景條allowsMultipleSelection YES只保留首尾兩個(gè)選中日注冊(cè)自定義 cell[calendar registerClass:[RangePickerCell class] forCellReuseIdentifier:cell]。官方完整實(shí)現(xiàn)RangePickerViewController.m RangePickerCell.m。六、外觀定制顏色、形狀與農(nóng)歷副標(biāo)題1??8?? 批量更換 FSCalendar 顏色選中/今天/邊框全局顏色都掛在appearance對(duì)象上FSCalendarAppearance.h#L182-L205calendar.appearance.selectionColor [UIColor systemBlueColor]; // 選中填充 calendar.appearance.todayColor [UIColor orangeColor]; // 今天填充 calendar.appearance.todaySelectionColor [UIColor blackColor]; // 今天選中 calendar.appearance.weekdayTextColor [UIColor redColor]; // 星期文字 需要按日期差異化配色如已選不同色、周末不同色時(shí)改用代理協(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?? 副標(biāo)題顯示農(nóng)歷或其他文字在數(shù)據(jù)源實(shí)現(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)歷實(shí)現(xiàn)源碼Objective-C 版 LunarFormatter.hSwift 版 LunarFormatter.swift。附贈(zèng)3 個(gè)「順手提」的高頻點(diǎn)事件圓點(diǎn)數(shù)據(jù)源實(shí)現(xiàn)numberOfEventsForDate:返回圓點(diǎn)個(gè)數(shù)FSCalendar.h#L96-L103圓點(diǎn)顏色由eventDefaultColor/eventSelectionColor控制。日期格子放圖片數(shù)據(jù)源實(shí)現(xiàn)imageForDate:FSCalendar.h#L76-L79。自定義 Cell 整體重繪繼承FSCalendarCell注冊(cè)后在cellForDate:atMonthPosition:中返回官方示例 DIYCalendarCell.m#L18 展示了自定義「今天」圓環(huán)的畫法。延伸閱讀FSCalendar 源碼與示例導(dǎo)航文件說明FSCalendar/FSCalendar.h核心 APItoday、scope、reloadData、選中等FSCalendar/FSCalendarAppearance.h外觀屬性顏色、字體、圓角、頭部格式FSCalendar/FSCalendarCell.h日期格子視圖自定義 Cell 的基類MOREUSAGE.md官方進(jìn)階用法 QA 原始出處Example-Objc/Objective-C 全功能示例工程Example-Swift/Swift 示例工程FSCalendar/include/對(duì)外頭文件與 modulemap? 記住三板斧改外觀找appearance給數(shù)據(jù)找dataSource管交互找delegate。20 個(gè)問題對(duì)應(yīng)到這三類接口基本都能 30 秒內(nèi)定位解法?！久赓M(fèi)下載鏈接】FSCalendarA fully customizable iOS calendar library, compatible with Objective-C and Swift項(xiàng)目地址: https://gitcode.com/gh_mirrors/fs/FSCalendar創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考