什么?
这是一个开源框架,旨在帮助开发者或工程师(或任何其他人)构建漂亮的 UI。
为什么?
GoldKit 的创建是为了消除创建漂亮 UI 的难度。作为开发者,构建良好的 UI 往往被推迟到最后,有时甚至被完全忽视。 GoldKit 希望帮助您消除设计难度,并确保它得以实现。
如何?
我们使用黄金比例来计算创建一个多样和吸引人的界面所需的各种 UI 元素的尺寸。
如上图所示,我们可以使用 5 种不同的 Element
类型,它们由一个 enum
表示
public enum Element {
case view
case pad
case font
case line
case kern
...
}
.view
- 用于大型元素和容器元素.pad
- 用于填充和边距尺寸.font
- 用于字体大小.line
- 用于较小的大小,例如线条.kern
- 用于非常小的大小,例如字母间距
结合使用 Element
,我们可以使用 Size
enum
来定义我们将要使用哪个 Element
的大小
public enum Size: Int {
case xxSmall = 0
case xSmall = 1
case small = 2
case medium = 3
case large = 4
case xLarge = 5
case xxLarge = 6
...
}
以上的大小很直观,只需注意某些大小可能并不适用于所有用途。多试几次,不要害怕将多个大小组合在一起以获取您所需的大小。框不存在!
使用
访问 GoldKit
所有与 GoldKit 的交互都通过 GoldKit
单例类进行。我们不希望每次都重新计算大小,因此通过 main
实例访问 GoldKit
类。
let goldKit = GoldKit.main
重写基本尺寸
第一次访问单例实例时,我们进行计算。我们使用 baseSize = 12.0
来进行计算,这作为最小字体大小。您可以重写 baseSize
,但请记住调用 calculate()
方法。
...
goldKit.baseSize = 13.0
goldKit.calculate()
访问尺寸
要访问一个尺寸,只需调用 .size(_ size:Size, element:Element)
方法,传递预定义的 Size
和 Element
枚举。
...
let viewSize = goldKit.size(.large, element:.view)
// given the baseSize of 12.0, viewSize is 215.30...
UI 元素
GoldKit 提供了一组更高级的 API(更多信息即将提供),用于使用底层尺寸创建必要的 UI 元素。
let font = goldKit.font(.medium)
// this will create a UIFont instance w/size 19.41...
// (with the default font family)
安装
使用 GoldKit 最简单的方式是使用 CocoaPods。
使用 CocoaPods 安装
要将 GoldKit 集成到您的 Xcode 项目中,请在 Podfile
中指定它
platform :ios, '11.0'
target 'TargetName' do
pod 'GoldKit'
end
然后,运行以下命令
$ pod install
预发布版
这是 GoldKit 的预发布版,尽管它是稳定的,应该在上述所有情况下都能正常工作,但仍可能会添加、更改和可能破坏内容。
许可
GoldKit 根据 MIT 许可发布。所以您可以按自己的意愿使用它。