企业官网建设流程全解析

THCalendarDatePicker 选择模式解析：单选、多选与范围选择的完整教程

【免费下载链接】THCalendarDatePickerA DatePicker based on a custom calendar view项目地址: https://gitcode.com/gh_mirrors/th/THCalendarDatePicker

THCalendarDatePicker 是一款基于自定义日历视图的 iOS 日期选择器组件，核心功能是让 App 以优雅的日历弹窗形式完成日期选择。很多开发者初次接触时，都会被它的单选、多选与范围选择三种模式搞糊涂。这篇 THCalendarDatePicker 教程将带你彻底理清三种日期选择模式的区别、适用场景与切换技巧，新手也能快速上手。

THCalendarDatePicker 的三种选择模式是什么

THCalendarDatePicker 通过枚举THDatePickerSelectionType定义三种模式，源码位于 THDatePickerViewController.h：

• 单选模式（Single）：一次只能选中一个日期，类似系统日历。
• 多选模式（Multi）：可点选多个互不相邻的日期，常用于"标记打卡日"等场景。
• 范围选择模式（Range）：先选起点再选终点，自动高亮中间所有日期，适合预订酒店、机票。

默认模式是单选，无需额外配置即可使用。

单选模式：最常用的日期选择方式

单选模式下，点击任意日期即完成选择，配合setAutoCloseOnSelectDate:可让日历在选择后自动收起，交互一气呵成。Swift 初始化代码如下：

let picker = THDatePickerViewController.datePicker() picker.delegate = self picker.date = Date() picker.setAutoCloseOnSelectDate(true) picker.setAllowSelectionOfSelectedDate(true)

单选模式的完整写法可参考演示项目 ViewController.swift，其中还展示了圆点标记回调setDateHasItemsCallback的用法。

多选模式：轻松选中多个日期

调用setSelectionType(.multi)即可开启多选。点击日期会加入选中集合并触发代理回调datePicker:selectedDate:，再次点击已选日期则取消并触发datePicker:deselectedDate:。所有已选日期存放在selectedDates数组中，方便统一读取。

多选模式适合做"本月打卡记录""多日排期"这类需求，选中的日期会以selectedBackgroundColor高亮展示。

范围选择模式：一步选中起止区间

范围选择模式是 THCalendarDatePicker 的招牌功能：setSelectionType(.range)后，点击第一个日期设起点，再点第二个日期设终点，中间的日期会全部自动高亮。代码示例：

picker.setSelectionType(.range) picker.setDateRangeFrom(fromDate, to: toDate)

搭配setDateRangeFrom:toDate:可以限制可选区间，官方提供了专门的"起止日期"示例项目 ViewController.swift，预订类 App 可以直接参考。

选择模式切换的 3 个易踩坑点

源码 THDatePickerViewController.m 揭示了几个关键细节，新手务必注意：

1. 设置单选模式时，会自动强制开启"选择后自动关闭"。
2. 如果你先调用了setAutoCloseOnSelectDate:，再切换为多选或范围模式，组件会自动降级回单选，顺序很重要！
3. 范围模式下再次点击新日期会清空旧区间重新选择，而不是追加。

让日历更好用的自定义技巧

除了选择模式，THCalendarDatePicker 还提供丰富的定制接口，都在 THDatePickerViewController.h 中：

• 🎨配色：selectedBackgroundColor、currentDateColor、currentDateColorSelected可自由调整选中、今日颜色。
• 📅限制范围：setDisableHistorySelection:、setDisableFutureSelection:或按天数限制setDaysInHistorySelection:、setDaysInFutureSelection:。
• 🏷️标题与圆点：setDateTitle:设置标题，setDateHasItemsCallback:标记特殊日期。

如何快速集成 THCalendarDatePicker

最简单的方式是使用 CocoaPods，在 Podfile 中添加：

platform :ios, '8.0' use_frameworks! pod 'THCalendarDatePicker', '~> 1.2.9'

也可以直接 clone 仓库（https://gitcode.com/gh_mirrors/th/THCalendarDatePicker）把THCalendarDatePicker/目录复制进工程，参考官方提供的中英文示例工程快速跑通。

结语

THCalendarDatePicker 用一套简洁的枚举就覆盖了日历选择的全部常见场景：单选够轻量、多选够灵活、范围选择直击预订类需求。只要记住"先设置选择模式、再配置自动关闭"的顺序，就能避开 90% 的坑。建议从官方示例工程入手，动手体验三种模式的差异，很快你就能在项目里熟练驾驭这个日期选择器了。

【免费下载链接】THCalendarDatePickerA DatePicker based on a custom calendar view项目地址: https://gitcode.com/gh_mirrors/th/THCalendarDatePicker