[Swift通天遁地]一、超级工具-(17)自定义的CVCalendar日历

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10176124.html 
➤如果链接不是山青咏芝的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

目录：[Swift]通天遁地Swift

本文将演示另一款第三方的日历类库。

首先确保在项目中已经安装了所需的第三方库。

点击【Podfile】,查看安装配置文件。

platform :ios, '12.0'
use_frameworks!

target 'DemoApp' do
    source 'https://github.com/CocoaPods/Specs.git'
    pod 'CVCalendar', '~> 1.4.0'
end

根据配置文件中的相关配置，安装第三方库。

然后点击打开【DemoApp.xcworkspace】项目文件。

在项目导航区，打开视图控制器的代码文件【ViewController.swift】

选择开始编写代码，创建一个日历控件。

import UIKit
//在当前类文件中，引入已经安装的第三方类库
import CVCalendar

class ViewController: UIViewController {

    //添加一个日历菜单视图变量，作为当前类的一个属性。
    //日历菜单将位于日历视图的上方，用来显示日历的星期。
    var menuView : CVCalendarMenuView!
    //添加一个日历视图变量，作为当前类的一个属性
    var calendarView : CVCalendarView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.
        
        //设置当前根视图的背景颜色
        self.view.backgroundColor = UIColor(red: 239.0/255, green: 239.0/255, blue: 239.0/255, alpha: 1.0)
        
        //对日历菜单视图，进行初始化操作，并设置其显示区域位于屏幕上方。
        self.menuView = CVCalendarMenuView(frame: CGRect(x: 20, y: 40,  280, height: 15))
        
        //对日历视图进行初始化操作，并设置其显示区域
        self.calendarView = CVCalendarView(frame: CGRect(x: 20, y: 60,  280, height: 320))
        
        //设置日历视图的外观代理为当前的视图控制器对象
        self.calendarView.calendarAppearanceDelegate = self
        //设置日历视图的日历代理为当前的视图控制器对象
        self.calendarView.calendarDelegate = self
        //设置日历视图的动画代理为当前的视图控制器对象
        self.calendarView.animatorDelegate = self

        //设置日历菜单视图的菜单代理为当前视图控制器对象
        self.menuView.menuViewDelegate = self
        
        //依次将两个视图添加到根视图中
        self.view.addSubview(menuView)
        self.view.addSubview(calendarView)
    }
    
    //添加一个方法，用来监听视图控制器对它的子视图进行布局的事件
    override func viewDidLayoutSubviews()
    {
        //当监听到该事件时
        super.viewDidLayoutSubviews()
        
        //依次提交对菜单视图和日历视图的刷新
        self.menuView.commitMenuViewUpdate()
        self.calendarView.commitCalendarViewUpdate()
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}

//添加一个针对视图控制器的扩展，
//并使其遵循日历视图协议和日历菜单视图协议。
extension ViewController: CVCalendarViewDelegate, CVCalendarMenuViewDelegate
{
    //添加一个代理方法，用来设置日历的模式
    func presentationMode() -> CalendarMode
    {
        //有月模式和周模式两种
        return .monthView
    }
    
    //添加一个代理方法
    func firstWeekday() -> Weekday {
        //将周日作为一个星期的开始
        return .sunday
    }
    
    //添加一个代理方法，设置在一个星期当中，每天的日期文字颜色
    func dayOfWeekTextColor(by weekday: Weekday) -> UIColor
    {
        //当该日为周日时，设置文字颜色为红色，否则设置文字颜色为黑色
        return weekday == .sunday ? UIColor.red : UIColor.black
    }
    
    //添加一个代理方法，用来设置允许突出显示某个日期
    func shouldShowWeekdaysOut() -> Bool
    {
        return true
    }
    
    //添加一个代理方法，用来允许以动态的方式进行尺寸的缩放
    func shouldAnimateResizing() -> Bool
    {
        return true
    }
    
    //添加一个代理方法，用来设置是否选中某个日期视图
    private func shouldSelectDayView(dayView: DayView) -> Bool
    {
        //此处使用随机的方式来决定是否选中
        return arc4random_uniform(3) == 0 ? true : false
    }
    
    //添加一个代理方法，用来响应某个日期被选中的事件，
    func didSelectDayView(_ dayView: CVCalendarDayView, animationDidFinish: Bool)
    {
        //在控制台输出选中的日期
        print("(dayView.date.commonDescription) is selected!")
    }
    
    //添加一个代理方法，用来设置是否允许在日期的上方，显示一个标识符
    func topMarker(shouldDisplayOnDayView dayView: CVCalendarDayView) -> Bool
    {
        return true
    }
    
    //添加一个代理方法，用来设置是否允许在日期的上方，显示一个点标识
    func dotMarker(shouldShowOnDayView dayView: CVCalendarDayView) -> Bool
    {
        //获得当前位置上的日期的天数
        let day = dayView.date.day
        //通过随机函数生成一个0到30之间的数字
        let randomDay = Int(arc4random_uniform(31))
        //假如当前位置上的日期的天数，和随机数字相同时，
        //则在日期的位置显示一个点标识
        if day == randomDay
        {
            return true
        }
        
        //其他的情况则不现实点标识
        return false
    }
    
    //添加一个代理方法，用来设置点标识的颜色
    func dotMarker(colorOnDayView dayView: CVCalendarDayView) -> [UIColor]
    {
        //通过随机函数生成一个随机的颜色
        let red = CGFloat(arc4random_uniform(600) / 255)
        let green = CGFloat(arc4random_uniform(600) / 255)
        let blue = CGFloat(arc4random_uniform(600) / 255)
        
        //初始化一个随机的颜色常量
        let color = UIColor(red: red, green: green, blue: blue, alpha: 1)
        
        //生成一个在1和3之间的随机整数
        let numberOfDots = Int(arc4random_uniform(3) + 1)
        //根据随机整数进行判断
        //根据随机整数的值，返回不同长度的颜色数组
        switch(numberOfDots)
        {
            case 2:
                return [color, color]
            case 3:
                return [color, color, color]
            default:
                return [color]
        }
    }
    
    //添加一个代理方法，设置是否在日期上显示高亮效果
    func dotMarker(shouldMoveOnHighlightingOnDayView dayView: CVCalendarDayView) -> Bool
    {
        return true
    }
    
    //添加一个代理方法，设置点标识的尺寸
    func dotMarker(sizeOnDayView dayView: DayView) -> CGFloat
    {
        return 13
    }
    
    //添加一个代理方法，设置星期的显示方式
    func weekdaySymbolType() -> WeekdaySymbolType
    {
        //有正常、缩写和超级缩写三种样式可以选择
        return .short
    }
    
    //添加一个代理方法，用来设置选区视图的贝塞尔路径
    func selectionViewPath() -> ((CGRect) -> (UIBezierPath))
    {
        //返回日期视图的显示区域，作为选区视图的路径
        return { UIBezierPath(rect: CGRect(x: 0, y: 0,  $0.width, height: $0.height)) }
    }
    
    //添加一个代理方法，不允许显示自定义的单独选区
    func shouldShowCustomSingleSelection() -> Bool
    {
        return false
    }
    
    //添加一个代理方法，用来设置显示在日期上的辅助视图
    func preliminaryView(viewOnDayView dayView: DayView) -> UIView
    {
        //初始化一个辅助视图，设置其显示区域和日期视图相同，并且形状为圆形。
        let circleView = CVAuxiliaryView(dayView: dayView, 
                                         rect: dayView.frame, 
                                         shape: CVShape.circle)
        //设置辅助视图的填充颜色为浅灰色
        circleView.fillColor = .colorFromCode(0xCCCCCC)
        //返回该辅助视图
        return circleView
    }
    
    //添加一个代理方法，用来设置是否允许在日期视图上，显示一个辅助视图
    func preliminaryView(shouldDisplayOnDayView dayView: DayView) -> Bool
    {
        //设置当日期视图中的日期为当日的天数时，显示辅助视图，否则不显示
        if (dayView.isCurrentDay)
        {
            return true
        }
        //否则不显示
        return false
    }
    
    //添加一个代理方法，用来设置补充视图。
    //该补充视图将被用来在所有属于星期五的天数位置，绘制一个圆环。
    func supplementaryView(viewOnDayView dayView: DayView) -> UIView
    {
        //初始化一个圆周率常数
        let π = M_PI
        
        //初始化一个浮点类型的常量，作为圆环的间距
        let ringSpacing: CGFloat = 3.0
        //初始化另一个浮点类型的常量，作为圆环的宽度
        let ringInsetWidth: CGFloat = 1.0
        //初始化另一个浮点类型的常量，作为圆环在垂直方向上的偏移距离
        let ringVerticalOffset: CGFloat = 1.0
        //创建一个图形层变量，用来绘制圆环
        var ringLayer: CAShapeLayer!
        //设置圆环路径的宽度为1
        let ringLineWidth: CGFloat = 1.0
        //设置圆环的线条颜色为紫色
        let ringLineColour: UIColor = UIColor.purple
        
        //在此创建一个和日期视图相比，
        //具有相同显示区域的视图对象。
        let newView = UIView(frame: dayView.bounds)
        
        //通过计算获得圆环的直径数据
        let diameter: CGFloat = (newView.bounds.width) - ringSpacing
        //通过直径算出半径的大小
        let radius: CGFloat = diameter / 2.0
        
        //从而创建一个矩形区域，用来绘制圆环形状
        let rect = CGRect(x: newView.frame.midX-radius, y: newView.frame.midY-radius-ringVerticalOffset,  diameter, height: diameter)
        
        //对图形层进行初始化操作，
        ringLayer = CAShapeLayer()
        //并将该层添加到新建视图的层中。
        newView.layer.addSublayer(ringLayer)
        
        //设置层的填充颜色为无色
        ringLayer.fillColor = nil
        //设置层的线条宽度
        ringLayer.lineWidth = ringLineWidth
        //设置层的描边属性
        ringLayer.strokeColor = ringLineColour.cgColor
        
        //初始化一个浮点常量，作为圆环的线宽嵌入值。
        let ringLineWidthInset: CGFloat = CGFloat(ringLineWidth/2.0) + ringInsetWidth
        //通过调用矩形区域对象的相关方法，获得该矩形区域具有相同中心点，但是更大的另一个矩形区域
        let ringRect: CGRect = rect.insetBy(dx: ringLineWidthInset, dy: ringLineWidthInset)
        //获得该区域的中心点坐标
        let centrePoint: CGPoint = CGPoint(x: ringRect.midX, y: ringRect.midY)
        //获得绘制圆环的起点角度
        let startAngle: CGFloat = CGFloat(-π/2.0)
        //生成绘制圆环的结束点角度
        let endAngle: CGFloat = CGFloat(π * 2.0) + startAngle
        //通过中心点、半径、起点角度、结束点角度以及是否顺时针等数据，
        //创建一个环形路径
        let ringPath: UIBezierPath = UIBezierPath(arcCenter: centrePoint, //中心点
                                                  radius: ringRect.width/2.0, //半径
                                                  startAngle: startAngle, //起点角度
                                                  endAngle: endAngle, //结束点角度
                                                  clockwise: true)//是否顺时针
        //设置层的路径为环形路径
        ringLayer.path = ringPath.cgPath
        //设置层的显示区域，和当前的日期层保持相同
        ringLayer.frame = newView.layer.bounds
        
        //最后返回设置好的附加视图
        return newView
    }
    
    //添加一个代理方法，用来设置在何种情况下，允许显示辅助视图。
    func supplementaryView(shouldDisplayOnDayView dayView: DayView) -> Bool
    {
        //当某处的日期的天数为周五时，在该日期位置显示一个辅助视图，
        //否则不会显示辅助视图。
        if (dayView.date.weekDay == Weekday.friday)
        {
            return true
        }
        
        return false
    }
    
    //设置星期文本的颜色为黑色
    func dayOfWeekTextColor() -> UIColor
    {
        return UIColor.black
    }
    
    //添加一个代理方法，设置星期文本的背景颜色为无色
    func dayOfWeekBackGroundColor() -> UIColor
    {
        return UIColor.clear
    }
}