GoldKit 0.0.4

GoldKit 0.0.4

Steve Wight 维护。



GoldKit 0.0.4

  • 作者:
  • Steve Wight

GoldKit

什么?

这是一个开源框架,旨在帮助开发者或工程师(或任何其他人)构建漂亮的 UI。

为什么?

GoldKit 的创建是为了消除创建漂亮 UI 的难度。作为开发者,构建良好的 UI 往往被推迟到最后,有时甚至被完全忽视。 GoldKit 希望帮助您消除设计难度,并确保它得以实现。

如何?

我们使用黄金比例来计算创建一个多样和吸引人的界面所需的各种 UI 元素的尺寸。

Layout of GoldKit sizes

如上图所示,我们可以使用 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) 方法,传递预定义的 SizeElement 枚举。

...
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 许可发布。所以您可以按自己的意愿使用它。