PickerKit
PickerKit 是一个 iOS 框架,它简化了标准的 UIPicker,使其成为一个基于手势的、具有极简外观的用户界面,您可以从一系列条目中轻松选择东西(目前它仅支持颜色)。
特性
- 条目会根据容器(PickerView)的高度自动调整大小
- IBInspectable 属性
- 易于设置和定制以适应您的需求
- 基于泛型的条目 Collection View Cell,易于定制
要求
- Xcode 10 及以后版本
- iOS 10 及以后版本
- Swift 5 及以后版本
示例
示例应用程序是了解 PickerKit
操作的最佳方式。只需打开 PickerKit.xcodeproj
并运行 Example
方案。
安装
CocoaPods
PickerKit 通过 CocoaPods 提供。要安装它,只需将以下行添加到您的 Podfile
pod 'PickerKit'
Carthage
Carthage 是一个去中心化的依赖管理器,它构建您的依赖并提供二进制框架。
要使用 Carthage 将 PickerKit 集成到您的 Xcode 项目中,请在 Cartfile
中指定它
github "Alexandru Turcanu/PickerKit"
运行 carthage update
来构建框架,并将构建的 PickerKit.framework
拖入您的 Xcode 项目。
在您应用程序目标的“构建阶段”设置选项卡中,点击“+”图标,选择“新运行脚本阶段”,并添加在 Carthage 入门步骤 4、5 和 6 中提到的框架路径
Swift 包管理器
要使用 Apple 的 Swift 包管理器 进行集成,请将以下内容作为依赖项添加到您的 Package.swift
dependencies: [
.package(url: "https://github.com/Pondorasti/PickerKit.git", from: "1.0.0")
]
手动
如果您不想使用上述任何依赖管理器,可以手动将 PickerKit 集成到项目中。只需将 Sources
文件夹拖入您的 Xcode 项目即可。
用法
创建 PickerView
创建 PickerView 只需提供一个 UIColor 数组。视图内容、颜色条目将根据 PickerView 的高度相应调整。此视图需要从其父级推断其高度和宽度才能正常运行。
let colorPickerView = PickerView(
colorEntries: [UIColor.red, UIColor.blue, UIColor.purple, UIColor.orange, UIColor.green]
)
获取选择的颜色,此值在 selectedEntry 属性中可访问。将该值设置为颜色数组范围内的索引将自动动画滚动到该索引。
colorPickerView.selectedEntry = 2
自定义外观
一个布尔值,用于控制是否显示淡出渐变。默认值为真。
colorPickerView.shouldFadeOutView = true
一个浮点值,用于确定条目项与焦点环之间的半径差异。默认值为 10。
colorPickerView.focusRingRadiusDelta = 10
一个浮点值,用于确定每个条目视图之间的间距。默认值为 12。
colorPickerView.lineSpacing = 12
注释
目前,此框架不支持高度定制或深入访问控制,但任何功能请求都将受到欢迎。
贡献
感谢您对项目的兴趣!我们非常欢迎贡献。
在开始之前,请务必阅读这些指南
如果您在您的应用中使用 PickerKit,我很乐意知道并且在此展示您应用
作者
由 Alexandru Turcanu 撰写
许可证
PickerKit 是在 MIT 许可下可用的。有关更多信息,请参阅 LICENSE 文件。