[Swift通天遁地]一、超級工具-(16)使用JTAppleCalendar制作美觀的日歷

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公眾號：山青詠芝（shanqingyongzhi）
➤博客園地址：山青詠芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10173424.html 
➤如果鏈接不是山青詠芝的博客園地址，則可能是爬取作者的文章。
➤原文已修改更新！強烈建議點擊原文地址閱讀！支持作者！支持原創！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

目錄：[Swift]通天遁地Swift

本文將演示使用JTAppleCalendar制作美觀的日歷。

首先確保在項目中已經安裝了所需的第三方庫。

點擊【Podfile】,查看安裝配置文件。

platform :ios, '12.0'
use_frameworks!

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

根據配置文件中的相關配置，安裝第三方庫

然后點擊打開【DemoApp.xcworkspace】項目文件。

在項目文件夾【DemoApp】上鼠標右鍵，彈出右鍵菜單：

【New File】->【Cocoa Touch Class】->【Next】->
【Class】：CellView ,類名。

【Subclass of】：JTAppleCalendar ，父類

【Language】：Swift

->【Next】->【Create】

在項目導航區，打開剛剛創建的代碼文件【CellView.swift】

//引入第三方類庫
import JTAppleCalendar

class CellView: JTAppleDayCellView {
    
    @IBOutlet var dayLabel: UILabel!

    @IBOutlet var selectedView: UIView!
}

在項目文件夾【DemoApp】上鼠標右鍵，彈出右鍵菜單：

【New File】->【View】視圖->【Next】->【Save As】：CellView ->【Create】

點擊【CellView.xib】，設置相關屬性

<?xml version="1.0" encoding="UTF-8"?>
<document type="com.apple.InterfaceBuilder3.CocoaTouch.XIB" version="3.0" toolsVersion="11201" systemVersion="16B2657" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" colorMatched="YES">
    <dependencies>
        <deployment identifier="iOS"/>
        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="11161"/>
        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
    </dependencies>
    <objects>
        <placeholder placeholderIdentifier="IBFilesOwner" id="-1" userLabel="File's Owner"/>
        <placeholder placeholderIdentifier="IBFirstResponder" id="-2" customClass="UIResponder"/>
        <view contentMode="scaleToFill" id="iN0-l3-epB" customClass="CellView" customModule="DemoApp" customModuleProvider="target">
            <rect key="frame" x="0.0" y="0.0" width="160" height="160"/>
            <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
            <subviews>
                <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="WDR-tm-CCJ">
                    <color key="backgroundColor" red="0.80000000000000004" green="0.59999999999999998" blue="0.0" alpha="1" colorSpace="calibratedRGB"/>
                    <constraints>
                        <constraint firstAttribute="width" constant="40" id="6XG-r3-HC7"/>
                        <constraint firstAttribute="height" constant="40" id="JOI-ha-pr3"/>
                    </constraints>
                </view>
                <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="Label" textAlignment="center" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="qQL-PP-1hg">
                    <fontDescription key="fontDescription" type="system" pointSize="14"/>
                    <color key="textColor" white="1" alpha="1" colorSpace="calibratedWhite"/>
                    <nil key="highlightedColor"/>
                </label>
            </subviews>
            <color key="backgroundColor" red="0.2274509804" green="0.15686274510000001" blue="0.29803921570000003" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
            <constraints>
                <constraint firstItem="qQL-PP-1hg" firstAttribute="centerX" secondItem="iN0-l3-epB" secondAttribute="centerX" id="1dS-Ke-SwV"/>
                <constraint firstItem="qQL-PP-1hg" firstAttribute="centerY" secondItem="iN0-l3-epB" secondAttribute="centerY" id="8zP-vN-Rfy"/>
                <constraint firstItem="WDR-tm-CCJ" firstAttribute="centerX" secondItem="iN0-l3-epB" secondAttribute="centerX" id="aIf-16-vU3"/>
                <constraint firstItem="WDR-tm-CCJ" firstAttribute="centerY" secondItem="iN0-l3-epB" secondAttribute="centerY" id="mhp-tS-eFs"/>
            </constraints>
            <freeformSimulatedSizeMetrics key="simulatedDestinationMetrics"/>
            <connections>
                <outlet property="dayLabel" destination="qQL-PP-1hg" id="EzH-lh-Czg"/>
                <outlet property="selectedView" destination="WDR-tm-CCJ" id="RxZ-fx-mpA"/>
            </connections>
            <point key="canvasLocation" x="-87" y="-205"/>
        </view>
    </objects>
</document>

 在項目導航區，打開視圖控制器的代碼文件【ViewController.swift】

import UIKit
//在當前的類文件中，引入已經安裝的第三方類庫
import JTAppleCalendar

//添加需要使用到的相關協議
class ViewController: UIViewController, JTAppleCalendarViewDataSource, JTAppleCalendarViewDelegate {
    
    @IBOutlet var calendarView: JTAppleCalendarView!
    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.
        
        //設置數據源為當前的視圖控制器對象
        calendarView.dataSource = self
        //設置代理對象為當前的視圖控制器對象
        calendarView.delegate = self
        //要使用自定義的日歷視圖，需要注冊日歷中的日期數字單元格的故事版文件
        calendarView.registerCellViewXib(file: "CellView")
        //設置日期數字單元格的間距
        calendarView.cellInset = CGPoint(x: 0, y: 0)
        
        //在日歷中允許選擇多個日期
        calendarView.allowsMultipleSelection  = true
        //允許進行日期區域的選擇
        calendarView.rangeSelectionWillBeUsed = true
        
        //將日歷視圖添加到當前視圖控制器的根視圖
        self.view.addSubview(calendarView)
    }
    
    //添加一個代理方法，用來監聽日歷中的數據單元格即將顯示的事件
    func calendar(_ calendar: JTAppleCalendarView, willDisplayCell cell: JTAppleDayCellView, date: Date, cellState: CellState)
    {
        //獲得即將顯示的單元格對象，並轉換成自定義的單元格類
        let myCustomCell = cell as! CellView
        //設置單元格中的標簽的文字內容
        myCustomCell.dayLabel.text = cellState.text
        
        //當日歷顯示的日期為當前月份時
        if cellState.dateBelongsTo == .thisMonth
        {
            //設置數字標簽的字體顏色為淺灰色
            myCustomCell.dayLabel.textColor = UIColor(red: 236/255,
                                                      green: 234/255, 
                                                      blue: 237/255, 
                                                      alpha: 1.0)
        }
        else
        {
            //不是當前的月份時，設置另外一種顏色
            myCustomCell.dayLabel.textColor = UIColor(red: 87/255, 
                                                      green: 72/255,
                                                      blue: 101/255,
                                                      alpha: 1.0)
        }
        
        //處理日期單元格被選擇的事件
        handleCellSelection(view: cell, cellState: cellState)
    }
    
    //添加一個方法，用來響應日期數字單元格被選擇的事件
    func handleCellSelection(view: JTAppleDayCellView?, cellState: CellState)
    {
        //獲得被選擇的日期數字單元格
        guard let myCustomCell = view as? CellView  else
        {
            return
        }
        //當單元格被選擇時
        if cellState.isSelected
        {
            //設置單元格的選擇標識視圖的圓角半徑為20
            myCustomCell.selectedView.layer.cornerRadius =  20
            //並設置視圖的顯示狀態為真
            myCustomCell.selectedView.isHidden = false
        }
        else
        {
            //當單元格不處選擇狀態時，隱藏該單元格的標識視圖
            myCustomCell.selectedView.isHidden = true
        }
        //同時在控制台輸出單元格的日期
        print("Date:\(cellState.date)")
    }
    
    //添加一個代理方法，用來配置日歷的相關參數
    func configureCalendar(_ calendar: JTAppleCalendarView) -> ConfigurationParameters
    {
        //初始化一個日期格式對象
        let formatter = DateFormatter()
        //設置日期的格式
        formatter.dateFormat = "yyyy MM dd"
        
        //初始化兩個日期對象
        //分別標識日歷的起始日期
        let startDate = formatter.date(from: "2018 12 26")!
        //分別標識日歷的結束日期
        let endDate = Date()
        
        //初始化一個配置參數對象
        let parameters = ConfigurationParameters(startDate: startDate,//起始日期
                                                 endDate: endDate,//結束日期
                                                 numberOfRows: 6,//日歷行數
                                                 calendar: Calendar.current,//日歷類別
                                                 generateInDates: .forAllMonths,//過去日期
                                                 generateOutDates: .tillEndOfGrid,//將來日期
                                                 firstDayOfWeek: .sunday)//每周第一天
        //返回的日歷配置參數對象
        return parameters
    }
    
    //添加一個代理方法，用來監聽某個日期被選擇時的事件
    func calendar(_ calendar: JTAppleCalendarView, didSelectDate date: Date, cell: JTAppleDayCellView?, cellState: CellState)
    {
        handleCellSelection(view: cell, cellState: cellState)
    }
    
    //添加一個代理方法，用來監聽某個日期取消選擇時的事件
    func calendar(_ calendar: JTAppleCalendarView, didDeselectDate date: Date, cell: JTAppleDayCellView?, cellState: CellState)
    {
        handleCellSelection(view: cell, cellState: cellState)
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}