近期要寫一個互動細節頗多的日曆控件,具體交互這裡略過不提。不過再複雜的控件,也是由基礎零件組裝起來的,這裡最基本的零件就是「月曆」。
先看成果:

從圖上可以看出,日曆本質上就是一堆小方塊:每行七個,分別對應週日到週六。因此只要給定一個月份,算出「這個月要佔幾行」,版面就定了。
@interface NSDate (WQCalendarLogic)
- (NSUInteger)numberOfDaysInCurrentMonth {
// 頻繁建立 NSCalendar 有效能成本,實務上可考慮快取單例
return [[NSCalendar currentCalendar] rangeOfUnit:NSDayCalendarUnit
inUnit:NSMonthCalendarUnit
forDate:self].length;
}
知道第一天是週幾,就能推算出第一週只佔了幾格。
- (NSDate *)firstDayOfCurrentMonth {
NSDate *startDate = nil;
BOOL ok = [[NSCalendar currentCalendar] rangeOfUnit:NSMonthCalendarUnit
startDate:&startDate
interval:NULL
forDate:self];
NSAssert1(ok, @"Failed to calculate the first day of the month based on %@", self);
return startDate;
}
- (NSUInteger)weeklyOrdinality {
return [[NSCalendar currentCalendar] ordinalityOfUnit:NSDayCalendarUnit
inUnit:NSWeekCalendarUnit
forDate:self];
}
- (NSUInteger)numberOfWeeksInCurrentMonth {
NSUInteger weekday = [[self firstDayOfCurrentMonth] weeklyOrdinality];
NSUInteger days = [self numberOfDaysInCurrentMonth];
NSUInteger weeks = 0;
if (weekday > 1) {
weeks += 1;
days -= (7 - weekday + 1); // 扣掉第一週已被佔用的部分
}
weeks += days / 7;
weeks += (days % 7 > 0) ? 1 : 0; // 餘數還要再佔一行
return weeks;
}
有了行數,就能算出總共需要多少個小方塊來呈現:
@interface WQCalendarTileView : UIView
這些小方塊由一個大方塊承載:
@interface WQCalendarGridView : UIView @property (nonatomic, weak) id<WQCalendarGridViewDataSource> dataSource; @property (nonatomic, weak) id<WQCalendarGridViewDelegate> delegate; - (void)reloadData; @end
當外部呼叫 reloadData 時,WQCalendarGridView 開始進行布局,而布局所需的資訊由 dataSource 與 delegate 提供:
@class WQCalendarGridView;
@protocol WQCalendarGridViewDataSource <NSObject>
@required
- (NSUInteger)numberOfRowsInGridView:(WQCalendarGridView *)gridView;
- (WQCalendarTileView *)gridView:(WQCalendarGridView *)gridView
tileViewForRow:(NSUInteger)row
column:(NSUInteger)column;
@optional
- (CGFloat)heightForRowInGridView:(WQCalendarGridView *)gridView;
@end
@protocol WQCalendarGridViewDelegate <NSObject>
- (void)gridView:(WQCalendarGridView *)gridView
didSelectAtRow:(NSUInteger)row
column:(NSUInteger)column;
@end
每一列的高度由 dataSource 提供,這個分工方式與 UITableView 一致,也是我最傾向的做法。
第一個 dataSource 方法上面已經能算了。第二個方法需要為每個 tile 做配置,例如「非本月日期以灰色顯示」,因此必須知道當月視圖中還包含了上月的尾巴與下月的開頭:
#pragma mark - 計算前月、當月、次月的日期
// 上月殘留部分
- (void)calculateDaysInPreviousMonthWithDate:(NSDate *)date {
NSUInteger weeklyOrdinality = [[date firstDayOfCurrentMonth] weeklyOrdinality];
NSDate *dayInThePreviousMonth = [date dayInThePreviousMonth];
NSUInteger daysCount = [dayInThePreviousMonth numberOfDaysInCurrentMonth];
NSUInteger partialDaysCount = weeklyOrdinality - 1;
NSDateComponents *components = [dayInThePreviousMonth YMDComponents];
self.daysInPreviousMonth = [NSMutableArray arrayWithCapacity:partialDaysCount];
for (int i = daysCount - partialDaysCount + 1; i < daysCount + 1; ++i) {
WQCalendarDay *calendarDay = [WQCalendarDay calendarDayWithYear:components.year
month:components.month
day:i];
[self.daysInPreviousMonth addObject:calendarDay];
[self.calendarDays addObject:calendarDay];
}
}
// 當月全部日期
- (void)calculateDaysInCurrentMonthWithDate:(NSDate *)date {
NSUInteger daysCount = [date numberOfDaysInCurrentMonth];
NSDateComponents *components = [date YMDComponents];
self.daysInCurrentMonth = [NSMutableArray arrayWithCapacity:daysCount];
for (int i = 1; i < daysCount + 1; ++i) {
WQCalendarDay *calendarDay = [WQCalendarDay calendarDayWithYear:components.year
month:components.month
day:i];
[self.daysInCurrentMonth addObject:calendarDay];
[self.calendarDays addObject:calendarDay];
}
}
// 次月開頭部分
- (void)calculateDaysInFollowingMonthWithDate:(NSDate *)date {
NSUInteger weeklyOrdinality = [[date lastDayOfCurrentMonth] weeklyOrdinality];
if (weeklyOrdinality == 7) return; // 剛好補滿最後一列
NSUInteger partialDaysCount = 7 - weeklyOrdinality;
NSDateComponents *components = [[date dayInTheFollowingMonth] YMDComponents];
self.daysInFollowingMonth = [NSMutableArray arrayWithCapacity:partialDaysCount];
for (int i = 1; i < partialDaysCount + 1; ++i) {
WQCalendarDay *calendarDay = [WQCalendarDay calendarDayWithYear:components.year
month:components.month
day:i];
[self.daysInFollowingMonth addObject:calendarDay];
[self.calendarDays addObject:calendarDay];
}
}
做到這裡,就能穩定地把任一個月份的日曆呈現出來了。
1、把 calendarDays 作為渲染順序的來源。程式碼中每次都把新建立的 WQCalendarDay 一併加入 self.calendarDays,這個陣列的順序就是畫面上的排列順序,配置 tile 時直接依序取出即可,不必再做二次計算。
2、NSCalendar 值得快取。註解裡提到的效能問題是真的,在快速滾動或連續切月的情境下,反覆建立 NSCalendar 會有明顯開銷。
3、週起始日要可配置。台灣與中國大陸習慣週日或週一開頭,中東地區則常從週六開始。把 firstWeekday 抽成參數,能省下後續不少改動。