PriceView 0.2.0

PriceView 0.2.0

测试已测试
Lang语言 SwiftSwift
许可 MIT
发布上次发布2017年11月
SwiftSwift 版本4.0
SPM支持 SPM

Thomas SIVILAY 维护。



PriceView 0.2.0

priceview-ios

CocoaPods
Build Status

一个用户友好的 UI 视图,用于显示价格或金额

demo

为什么?

我们在我们的应用程序中到处展示价格,并且我同意 @frankrausch 的观点,用户阅读起来很困难。那么为什么不能有一个可以轻松为我们渲染的组件,进行格式化、样式化和布局,只需几个属性即可?

哦,一个小贴士,您可以使用/与设计师在示例 playground 中调整样式,使其正好如您所愿。

要求

  • iOS 9.0+
  • Swift 4.0+

安装

CocoaPods

要使用 CocoaPods 将 PriceView 集成到您的 Xcode 项目中,请在 Podfile 中指定它

target '<Your Target Name>' do
    pod 'PriceView'
end

然后,运行以下命令
$ pod install

Carthage

我计划很快将 PriceView 提供给 Carthage。

用法

快速开始

默认

import PriceView

final class ViewController: UIViewController {
	private lazy var priceView = UIPriceView()
	
	override func viewDidLoad() {
		super.viewDidLoad()
		priceView.price = 12.34
	}
}

自定义

如果您不喜欢 PriceView 的默认行为,没关系,它仍然很容易使用。

这是可自定义的项目列表

  • 布局

    • 垂直对齐:视图内文本的垂直对齐
    • 水平对齐:视图内文本对齐
    • 货币间距:货币符号和价格之间的间距
    • 小数分隔符间距:小数分隔符前后的间距。
  • 选项

    • 地区:用于定义货币符号、千位分隔符和小数分隔符的地区
    • 小数位数:显示的小数位数。
  • 默认文本样式

    • 当使用带可变参数的初始化器(请参阅 TextStyles)声明 Style 时使用的回退文本样式
  • TextStyles

    • 一组特定的文本样式,供整数部分、小数部分、货币符号和小数分隔符使用。如果集合不完整(缺少每一个中的一个),将应用默认文本样式。
  • TextStyle

    • 字体:用于自定义控制或 preferredFontSize
    • 大小和粗细:不建议设置定义的大小,但仍然可用
    • 字距
    • 垂直对齐
示例

包含可变文本样式的样式

let style = Style(
            defaultTextStyle: TextStyle(size: 15, color: .gray, verticalAlignment: .bottom(0)),
            textStyles: .integer(TextStyle(size: 32, color: .black, verticalAlignment: .bottom(0)))
        )

样式

let style = Style(
            integerTextStyle: 
            TextStyle(size: 32, color: .black, verticalAlignment: .bottom(0)),
            decimalTextStyle:
            TextStyle(size: 15, color: .gray, verticalAlignment: .bottom(0)),
            decimalSeparatorTextStyle:
            TextStyle(size: 15, color: .gray, verticalAlignment: .bottom(0)),
            currencyTextStyle:
            TextStyle(size: 15, color: .gray, verticalAlignment: .bottom(0))
        )

鸣谢

UIKonf 2017 – Frank Rausch – Good Typography, Better Apps

许可

PriceView 在 MIT 许可下发布。有关详细信息,请参阅 LICENSE