SMNumberWheel

version: 1.0.3

[](https://travis-ci.org/Sina Moetakef/SMNumberWheel)

Introduction

SMNumberWheel is a custom made control (subclass of UIControl) for iOS, written in Swift, which is ideal for picking numbers instead of typing them by software keyboards. The main idea is to be able to pick numbers very fast and and yet accurate. The wheel works with reading the angular speed of user's finger. The slower you spin the wheel, the more accurate values are changed (up to 4 fraction digits accurate). The more rotation speed results in exponentially faster value changes.

![alt tag] (https://github.com/SinaMoetakef/SMNumberWheel/blob/master/Example/SMNumberWheel/SMNumberWheel.png)

Features

• Highly customizable through properties which results in thousands of different designs.
• Renders in InterfaceBuilder, has customizable properties visible with Attributes Inspector (InterfaceBuilder).
• Supports sounds and haptic feedbacks (iPhone 7 and iPhone 7+)
• Built-in buttons: Stepper buttons and central reset button.
• supports iOS 9.0 and above

Installation

CocoaPods

SMNumberWheel is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "SMNumberWheel"

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate SMNumberWheel into your Xcode project using Carthage, specify it in your Cartfile:

github "SinaMoetakef/SMNumberWheel"

Run carthage update to build the framework and drag the built SMNumberWheel.framework into your Xcode project.

• don't forget the run-script!

Video links

• [Demonstration] (https://youtu.be/DIWpGOlDGOw)
• [Customizing the wheel] (https://youtu.be/NTEsCepLYBY)
• [Connecting to code] (https://youtu.be/r_eG3oPFMfk)

Usage

Adding from code

Sample code:

let wheel = SMNumberWheel(frame: CGRect(x: 100, y: 100, width: 180, height: 180))
wheel.majorIndicators = 4
wheel.majorIndicatorType = .diamond
wheel.minorIndicatorType = .none
wheel.ringColor = UIColor.red
wheel.strokeColor = UIColor.red
wheel.stepper = false
wheel.hapticFeedback = true
// continue setting up the properties ...
wheel.delegate = self
self.view.addSubview(wheel)

Adding from InterfaceBuilder

After installing the pod:

• Add a view to the ViewController's view hierarchy using InterfaceBuilder
• Setup constranits of the view
• Set the view's class to be SMNumberWheel
• set the ModuleName to be SMNumberWheel
• Wait for the InterfaceBuilder to render the wheel

Customizing the Wheel using InterfaceBuilder

• Have the view selected.
• Open Attributes Inspector section
• Change properties available for the wheel like sizes, colors, styles, ...
• The changes will be rendered in InterfaceBuilder.

Connecting to code and receive events

Like all other widgets, you can easily drag an outlet from the viewController to your code. In order to connect events, you can use either of the following methods:

• Drag a target action from the viewController to your code and choose Value Changed as event type
• implement the delegate methods to get more events.

extension viewController : SMNumberWheelDelegate {
    func SMNumberWheelDidResetToDefaultValue(_ numberWheel: SMNumberWheel) {
        // Happens when the central button is tapped and the wheel is set to it's initial value
    }
    func SMNumberWheelValueChanged(_ numberWheel: SMNumberWheel) {
        // Happens when the value of the wheel changes.
    }
    func SMNumberWheelReachedLimit(_ numberWheel: SMNumberWheel, stayedAtLimit: Bool) {
        // Notifies the developer that the value of the wheel has reached one of the limits.
    }
    func SMNumberWheelStepperKeyPressed(_ numberWheel: SMNumberWheel, rightKey: Bool) {
        // Notifies that a tap on one of the stepper keys is detected. 
        // rightKey == true -> tapped on right key, otherwise tapped on the left key.
    }
    func SMNumberWheelChangedAppearance(_ numberWheel: SMNumberWheel, minimized: Bool) {
        // Notifies the developer that the visual state of the wheel is changed (minimized or maximized).
    }
}

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Author

Sina Moetakef, [email protected]

License

SMNumberWheel is available under the MIT license. See the LICENSE file for more info.