barceloneta1.1

barceloneta1.1

测试已测试
Lang语言 SwiftSwift
许可证 MIT
发布最后发布2018年8月
SPM支持 SPM

Arnaud Schloune 维护。




barceloneta

CocoaPods Compatible Awesome PRs Welcome

增加/减少值的正确方式

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)

这个设置表示:

070%之间,增加的计时器间隔为0.3秒,增加的值为1.0

应用程序运行时崩溃?

如果您通过CocoaPods安装了barceloneta并且与Storyboard/xib一起使用,您可能需要设置模块

待办事项

  • UI测试

已知问题

请查看(GitHub issues

常见问题解答

为什么我应该使用Barceloneta

您正在寻找一种创新的方法来递增/递减值

特别感谢

RuberBandEffect

联系

创建者

许可

Barceloneta 是在 MIT 许可下发布的。详情请参阅 LICENSE 文件。