ControlsKit
示例
要运行示例项目,请克隆存储库,打开工作空间并运行ControlsKitExample
。
需求
iOS 8.0
描述
这是一个多年来开发并于十几个项目中使用过的组件列表。它们旨在为现有控件提供更丰富的自定义,或者为现有控件提供额外的功能。
NibView
允许在xib文件中通过Interface Builder创建视图布局,然后可以像使用任何视图一样加载它。
PageControl
从头开始重新实现且可完全自定义的Page Control,只需几行代码即可完成原生Page Control可能需要数百行代码才能完成的操作(更不用说通常包含的脏覆盖了)。
- 指定您的自定义活动/非活动点图像(最左侧和最右侧可能不同)
- 指定点之间的间距(可动画化)
- 通过
完全相同的API 享受原生Page Control提供的所有其他可能性
PlaceholderTextView
UITextView
的一个子类,提供占位符文本。
Switch
原生UISwitch
的限制
导致开发人员通常需要实现自己的自定义子类。我们的Switch子类应该解决大多数常见问题。
- 无法设置
背景非颜色
以替换原生的灰色。
添加了新的offTintColor
属性(与原生的onTintColor
属性相对应)。
onImage
和offImage
(使用当前颜色)在设置或删除时逻辑不可靠。
优化了逻辑,当设置onImage
时,如果设置,onImage
将优先于onTintColor
:显示图像,不显示开启颜色。如果onImage
为空,则显示onTintColor
。相同的逻辑也适用于offTintColor
,所有组合均完全可自定义,始终可靠。
安装
通过 CocoaPods
ControlsKit 可通过 CocoaPods 获取。要安装它,只需将以下行添加到您的 Podfile 中
pod 'ControlsKit', '~> 1.0'
默认情况下,会获取库的 Swift 版本。如果只想使用 Objective-C 版本,只需在 Podfile 中添加以下行即可
pod 'ControlsKit/ObjC', '~> 1.0'
同样,如果您只想使用一个控件,可能不需要一次性的拉取所有控件。例如,如果您只想在项目中使用 PlaceholderTextView
,只需添加以下内容
pod 'ControlsKit/PlaceholderTextView/Swift', '~> 1.0'
(如果您想使用 Objective-C 版本,可以将 Swift
替换为 ObjC
)
通过 Carthage
ControlsKit 也可通过 Carthage 获取。要安装它,只需将以下行添加到您的 Cartfile 中
github "Acuta/ControlsKit" ~> 1.0
如果您使用 Carthage 生成依赖项,只需将 ControlsKit.framework
添加到目标的 "链接框架和库" 部分,并确保您已经包含了它们在 Carthage 框架复制构建阶段。
作者
许可证
ControlsKit 以 MIT 许可证提供。有关更多信息,请参阅 LICENSE 文件。