PickerKit 0.1.3

PickerKit 0.1.3

Pondorasti 维护。



PickerKit 0.1.3

  • Alexandru Turcanu

PickerKit

Swift 5.0 CI Status Version Platform Carthage Compatible SPM

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 撰写

Twitter Follow

Twitter Follow

许可证

PickerKit 是在 MIT 许可下可用的。有关更多信息,请参阅 LICENSE 文件。