barceloneta
增加/减少值的正确方式
barceloneta 是在 iOS 上通过简单手势增加/减少值的正确方式
特性
- 计时器和增量值的自定义
- 易于自定义
- 水平/垂直模式
- 值循环或不循环
- 可自定义的拖动限制
- 最小/最大值
- 完整文档
需求
- 自动布局
- iOS 9.0+
- Swift 3.0
- Xcode 8.0 或更高版
沟通
- 如果您 需要帮助,请使用 Stack Overflow。 (标记为 '#barceloneta')
- 如果您想要 提出一个一般性问题,请使用 Stack Overflow。
- 如果您 发现了一个错误,请开启一个问题。
- 如果您 有一个功能请求,请开启一个问题。
- 如果您 希望贡献,提交一个拉取请求。
- 如果您 使用此控件,请联系我在此页面提及您的应用。
安装
CocoaPods
Barceloneta 现已在 CocoaPods 上可用。只需将以下内容添加到您的项目 Podfile 中,即可正常使用。
use_frameworks!
pod 'barceloneta', '~> 1.1'
Carthage
即将推出
手动安装
您可以通过手动的方式将 barceloneta
集成到您的项目中。
源文件
只需将 Library/Barceloneta.swift
源文件直接添加到您的项目中。
用法
启用手势(简易!)
启用手势需要满足以下条件:
- 一个UIView对象
- 对视图应用了NSLayoutConstraint,用于设置视图的垂直位置
- 计时器/增量设置
- 一个委托(可选)
//Initialise the gesture
barcelonetaView.loops = true
barcelonetaView.minimumValue = 0.0
barcelonetaView.maximumValue = 50.0
let timerSettings = [
(range: 0..<70, timer: 0.3, increment: 1.0),
(range: 70..<120, timer: 0.2, increment: 2.0),
(range: 120..<500, timer: 0.1, increment: 3.0)
]
barcelonetaView.makeElastic(timerSettings: timerSettings,
constraint: myNSLayoutConstraint
axis: .vertical,
delegate: self)
配置
从这里开始有趣的部分。请注意,这个库的目标仅是管理值的增加。显示应由您自己管理。
值循环
确定值是否将在最小值/最大值上停止。
如果启用了循环,当达到最大值时,它将返回最小值。
反之亦然。
barcelonetaView.loops = true/false
最小/最大值
确定增加的界限
barcelonetaView.minimumValue = 0.0
barcelonetaView.maximumValue = 50.0
拖动限制
该值定义了barceloneta
对象的拖动限制。如果用户拖动视图超过此限制,则将应用弹性效果。视图的上升/下降速率将慢于您的手指。
barcelonetaView.draggingLimit = 50.0
计时器设置
定时器设置属性是一个对象数组,用于定义特定范围的计时器间隔和增量值。定时器设置至少需要包含一个对象。
根据百分比,将应用匹配的设置。
100%的拖动对应拖动限制。
(range:0..<70, timer: 0.3, increment: 1.0)
这个设置表示:
在0
到70%
之间,增加的计时器间隔为0.3秒
,增加的值为1.0
。
应用程序运行时崩溃?
如果您通过CocoaPods安装了barceloneta
并且与Storyboard/xib一起使用,您可能需要设置模块
待办事项
- UI测试
已知问题
请查看(GitHub issues)
常见问题解答
Barceloneta
?
为什么我应该使用您正在寻找一种创新的方法来递增/递减值
特别感谢
联系
创建者
许可
Barceloneta 是在 MIT 许可下发布的。详情请参阅 LICENSE 文件。