SwiftyPickerPopover 倒计时选择器CountdownPickerPopover 完整使用指南【免费下载链接】SwiftyPickerPopoverA more convenient way to display a popover with a built-in picker, on iPhone/iPad of iOS9.项目地址: https://gitcode.com/gh_mirrors/sw/SwiftyPickerPopover在 iOS 开发中倒计时选择器CountdownPickerPopover是计时器、番茄钟、闹钟类 App 里最常见的交互组件。SwiftyPickerPopover 是一款支持 iOS 9 的 Swift 弹窗选择器库它把系统 UIDatePicker 的 countDownTimer 模式封装进自带导航栏的 Popover 弹窗中让你用几行代码就能在 iPhone 和 iPad 上弹出漂亮的倒计时选择器。本文将从零开始带你完整掌握 CountdownPickerPopover 的配置、回调与自定义技巧。为什么选择 SwiftyPickerPopover 的倒计时组件相比手写 UIPopoverPresentationControllerSwiftyPickerPopover 的核心优势非常明显极简 API无需处理代理回调链式调用一气呵成全平台适配iPhone、iPad 通用自动处理 Popover 尺寸与箭头方向自带导航栏Done、Cancel、Clear 三个按钮开箱即用Swift 5 原生支持 Xcode 11底层彻底告别 UIPopoverController。一分钟快速集成安装首先通过 CocoaPods 安装在 Podfile 中加入platform :ios, 9.0 use_frameworks! target YourApp do pod SwiftyPickerPopover end执行pod install后在需要使用的 Swift 文件顶部导入模块import SwiftyPickerPopover项目同时支持 Carthage 集成版本号为 6.6.6见 SwiftyPickerPopover.podspec你也可以通过git clone https://gitcode.com/gh_mirrors/sw/SwiftyPickerPopover拉取源码直接拖入工程。倒计时选择器最简使用示例CountdownPickerPopover 的用法极其直观。以下代码在点击按钮时弹出倒计时弹窗并在点击 Done 后打印所选时长单位秒IBAction func countdownButton(_ sender: UIButton) { CountdownPickerPopover(title: CountdownPicker) .setSelectedTimeInterval(TimeInterval()) .setDoneButton(action: { popover, timeInterval in print(timeInterval \(timeInterval)) }) .setCancelButton(action: { _, _ in print(cancel) }) .appear(originView: sender, baseViewController: self) }这段示例来自官方 Demo 的 SampleViewController.swift。可以看到创建弹窗 → 设置按钮 → 弹出三步完成全程不需要任何 delegate。核心 API 逐项拆解初始化与默认时长setSelectedTimeInterval倒计时选择器的类型别名是TimeInterval即秒数。setSelectedTimeInterval()用于设置弹窗打开时滚轮默认停留的时长CountdownPickerPopover(title: 定时器) .setSelectedTimeInterval(25 * 60) // 默认 25 分钟三个按钮的完整定制Done / Cancel / ClearsetDoneButton(title:font:color:action:)确认按钮action 会带回最终选中的TimeIntervalsetCancelButton(...)取消按钮setClearButton(...)重置按钮适合一键清零场景。三者都支持自定义标题、字体和颜色未设置时自动使用本地化的 Done / Cancel 文案定义见 CountdownPickerPopover.swift。实时监听滚动setValueChange想要在用户拨动滚轮时实时拿到数值只需添加.setValueChange(action: { _, timeInterval in print(current interval \(timeInterval)) })该回调在每次滚轮变化时触发常用于边选边预览的场景底层实现在 CountdownPickerPopoverViewController.swift。倒计时弹窗的高级自定义技巧重置时长并刷新弹窗Clear 按钮最常见的用法是配合reload()把滚轮拨回零值.setClearButton(action: { popover, timeInterval in popover.setSelectedTimeInterval(TimeInterval()).reload() })reload()是 AbstractPopover.swift 提供的通用刷新方法能立即让弹窗 UI 同步最新属性。控制弹出位置与箭头方向CountdownPickerPopover 继承自抽象基类AbstractPopover因此自动获得全套通用配置setPermittedArrowDirections(.down)限制箭头只朝下setArrowColor(.white)修改箭头与背景色setSize(width: 280)自定义弹窗宽高默认 300x300setCornerRadius(12)圆角美化setOutsideTapDismissing(allowed: false)禁止点击外部关闭setDimmedBackgroundView(enabled: true)弹窗背后加一层半透明遮罩聚焦当前操作。这些公共 API 的完整列表可参考 AbstractPopover.swift。自动消失与延迟关闭适合引导类提示场景让弹窗 3 秒后自动收起let p CountdownPickerPopover(title: 倒计时) p.appear(originView: sender, baseViewController: self) p.disappearAutomatically(after: 3.0)底层通过 DispatchQueueExtension.swift 的可取消延时任务实现用户一旦操作滚轮还会自动重新计时体验非常贴心。常见问题 FAQQ1返回的 timeInterval 单位是什么秒TimeInterval。比如用户选了 1小时30分回调得到5400.0自行转换即可。Q2如何让弹窗从 UIBarButtonItem 弹出调用appear(barButtonItem:baseViewController:)重载方法即可无需手动取 view。Q3storyboard 如何定制把 CountdownPickerPopover.storyboard 复制进你的工程主 Bundle不要改名在 Xcode 中取消 Inherit From Target 并指定 Module 为SwiftyPickerPopover即可自由修改布局。结语SwiftyPickerPopover 的 CountdownPickerPopover 把系统倒计时滚轮、导航栏按钮和 Popover 弹窗三者优雅地封装在一起对新手友好、对老手高效。无论是简单的定时器还是复杂的多阶段倒计时流程它都能帮你把选择器交互从痛苦造轮子变成三行搞定。现在就动手在下一个 App 里加上它吧【免费下载链接】SwiftyPickerPopoverA more convenient way to display a popover with a built-in picker, on iPhone/iPad of iOS9.项目地址: https://gitcode.com/gh_mirrors/sw/SwiftyPickerPopover创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考