FSCalendar使用
FSCalendar使用
在项目中经常有使用到日历，大部分使用场景都需要自定义日历，FSCalendar能适应大部分场景
参考如下的使用文档：
- More usage
- FSCalendar使用介绍(一) - Hello World
- FSCalendar使用介绍(二) - 农历、事件
- FSCalendar使用介绍(三) - 订制外观
FSCalendar大概由如下的几部分组成：
FSCalendarHeaderTouchDeliver- 为FSCalendarHeaderView和FSCalendarWeekdayView组合成的部分
外观定制
Scope
scope分为month和week，通过scope来设置
typedef NS_ENUM(NSUInteger, FSCalendarScope) { //范围
FSCalendarScopeMonth,
FSCalendarScopeWeek
};
@property (assign, nonatomic) FSCalendarScope scope;
改变scope后，会触发内在的frame发生变化，可在如下方法中做出调整：
- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated;
例如，通过如下的代码做出动态的调节：
- (IBAction)toggleClicked:(id)sender
{
if (self.calendar.scope == FSCalendarScopeMonth) {
[self.calendar setScope:FSCalendarScopeWeek animated:_animationSwitch.on];
} else {
[self.calendar setScope:FSCalendarScopeMonth animated:_animationSwitch.on];
}
}
placeholderType
typedef NS_ENUM(NSUInteger, FSCalendarPlaceholderType) {
FSCalendarPlaceholderTypeNone = 0,
FSCalendarPlaceholderTypeFillHeadTail = 1, //填满头部和尾部
FSCalendarPlaceholderTypeFillSixRows = 2 //6行
};
FSCalendarPlaceholderTypeFillSixRows
FSCalendarPlaceholderTypeFillHeadTail
FSCalendarPlaceholderTypeNone
中文
calendar.locale = [NSLocale localeWithLocaleIdentifier:@"zh_cn"];//中文
设置caseOptions
calendar的appearance属性为FSCalendarAppearance类型，其有个caseOptions属性
如果设置为如下的属性：
calendar.appearance.caseOptions = FSCalendarCaseOptionsHeaderUsesUpperCase|FSCalendarCaseOptionsWeekdayUsesUpperCase;
如果设置为
calendar.appearance.caseOptions = FSCalendarCaseOptionsHeaderUsesUpperCase|FSCalendarCaseOptionsWeekdayUsesSingleUpperCase;
颜色
颜色可通过appearance相关的属性来设置，也可通过代理来实现
FSCalendarAppearance
FSCalendarDelegateAppearance
@protocol FSCalendarDelegateAppearance <FSCalendarDelegate>
字体
单元格中的字体大小默认是自适应的，需要先关闭自适应。否则字体尺寸不会发生改变。
calendar.appearance.adjustsFontSizeToFitContentSize = NO; // 关闭文字尺寸自适应
背景、边框、事件圆点
同样可以通过属性和代理来设置
FSCalendarAppearance
FSCalendarDelegateAppearance
圆角
默认情况下today和选中的标识都是圆圈
通过calendar.appearance.borderRadius = 0，可设置为方形
其它设置
firstWeekday
通过firstWeekday属性可以设置calendar的第一天是星期几，如果设置2，则表示第一个是Mon星期一
scrollDirection
scrollDirection设置滚动的方向，可选值如下：
typedef NS_ENUM(NSUInteger, FSCalendarScrollDirection) {//滚动方向
FSCalendarScrollDirectionVertical,
FSCalendarScrollDirectionHorizontal
};
设置不显示today的圆圈
默认情况下，today的显示效果类似如下：
如果设置self.calendar.today = nil;，则显示效果如下：
设置日期范围
// FSCalendarDataSource
- (NSDate *)minimumDateForCalendar:(FSCalendar *)calendar
{
return yourMinimumDate;
}
- (NSDate *)maximumDateForCalendar:(FSCalendar *)calendar
{
return yourMaximumDate;
}
设置日期可以使用如下的方法：
self.gregorian = [NSCalendar calendarWithIdentifier:NSCalendarIdentifierGregorian];
......
- (NSDate *)maximumDateForCalendar:(FSCalendar *)calendar
{
return [self.gregorian dateByAddingUnit:NSCalendarUnitMonth value:5 toDate:[NSDate date] options:0];
}
FSCalendarCell
FSCalendarCell大概由如下的几个部分组成：
- titleLabel - 显示日期
- subtitleLabel - 显示副标题
- shapeLayer - 表示标识
- imageView
- FSCalendarEventIndicator - 表示事件event的view
可继承FSCalendarCell，自定义cell，达到自定义UI的目的
先注册，再使用
[calendar registerClass:[DIYCalendarCell class] forCellReuseIdentifier:@"cell"];
- (FSCalendarCell *)calendar:(FSCalendar *)calendar cellForDate:(NSDate *)date atMonthPosition:(FSCalendarMonthPosition)monthPosition
{
DIYCalendarCell *cell = [calendar dequeueReusableCellWithIdentifier:@"cell" forDate:date atMonthPosition:monthPosition];
return cell;
}