barceloneta
The right way to increment/decrement values
barceloneta is the right way to increment/decrement values with a simple gesture on iOS
Features
- Customisation for timer and incremental values
- Easily customisable
- Horizontal/vertical mode
- Looping through values or not
- Customizable dragging limit
- Minimal/maximal values
- Complete Documentation
Requirements
- Autolayout
- iOS 9.0+
- Swift 3.0
- Xcode 8.0 or higher
Communication
- If you need help, use Stack Overflow. (Tag '#barceloneta')
- If you'd like to ask a general question, use Stack Overflow.
- If you found a bug, open an issue.
- If you have a feature request, open an issue.
- If you want to contribute, submit a pull request.
- If you use the control, contact me to mention your app on this page.
Installation
CocoaPods
Barceloneta is now available on CocoaPods. Simply add the following to your project Podfile, and you'll be good to go.
use_frameworks!
pod 'barceloneta', '~> 1.1'
Carthage
Coming soon
Manually
You can integrate barceloneta into your project manually.
Source File
Simply add the Library/Barceloneta.swift source file directly into your project.
Usage
Enabling the gesture (EASY !)
To enable the gesture, it is required to have :
- A UIView object
- A NSLayoutConstraint applied to the view, for the vertical position of the view
- Timer/Incremental settings
- A delegate (optional)
//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)
Configuration
That's where the fun begins. Keep in mind that the goal of this library is only to manage the incrementation of values. The display should be managed by you.
Looping of values
Determines if the values will stop on minimumValue/maximumValue.
If looping is enabled, when the maximum value is reached, it will go back to the mimimum value.
And vice-versa.
barcelonetaView.loops = true/false
Minimum/Maximum values
Determines the limits of the increment
barcelonetaView.minimumValue = 0.0
barcelonetaView.maximumValue = 50.0
Dragging limit
This value defines the dragging limit of your barceloneta object. If the user drags the view higher than this limit, a rubber effect will apply. The view will go up/down slower than your finger.
barcelonetaView.draggingLimit = 50.0
Timer Settings
The timerSettings property is an array of objects, defining the timer interval and incremental value for a specific range. It is required to have at least an object in the timer setting.
Depending on the percentage, the matching settings will be applied.
A drag of 100% corresponds to the draggingLimit.
(range:0..<70, timer: 0.3, increment: 1.0)
This setting says that :
Between 0 and 70%, the timer interval for incrementation is 0.3 seconds, and the value incremented is 1.0.
Crash when running the app ?
If you installed barceloneta via CocoaPods and use it with Storyboard/xib, you may need to set the module :
TODO
- UI Testing
Known issues
Check the (GitHub issues)
FAQ
Why should I use Barceloneta?
You're looking for an innovative way to increment/decrement values
Special thanks
Contact
Creator
License
Barceloneta is released under the MIT license. See LICENSE for details.
509 Dec 21, 2022
1.2k Dec 18, 2022
52 Dec 13, 2022
151 Nov 2, 2022
1 Apr 5, 2022
972 Dec 17, 2022
589 Dec 24, 2022
1.8k Dec 20, 2022
35 Dec 19, 2022
106 Dec 18, 2022
777 Nov 20, 2022
5.9k Dec 28, 2022
0 Nov 5, 2021
1.2k Dec 14, 2022
950 Oct 17, 2022
10 Dec 6, 2022
90 Apr 21, 2020
294 Dec 27, 2022
31 Dec 25, 2022
103 Nov 24, 2022
3 Aug 1, 2022
96 Nov 14, 2022
368 Nov 9, 2022
1.1k Jan 6, 2023
95 Nov 24, 2022
200 Dec 22, 2022
1 Nov 29, 2021