Skip to content
This repository has been archived by the owner on Dec 19, 2023. It is now read-only.
/ barceloneta Public archive

The right way to increment/decrement values with a simple gesture on iOS.

License

Notifications You must be signed in to change notification settings

zigzagg16/barceloneta

Repository files navigation

barceloneta

CocoaPods Compatible Awesome PRs Welcome

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

RuberBandEffect

Contact

Creator

License

Barceloneta is released under the MIT license. See LICENSE for details.