Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SinaMoetakef/SMNumberWheel
SMNumberWheel is a subclass of UIControl written in Swift, which is ideal for picking numbers using a rotating wheel.
https://github.com/SinaMoetakef/SMNumberWheel
Last synced: 5 days ago
JSON representation
SMNumberWheel is a subclass of UIControl written in Swift, which is ideal for picking numbers using a rotating wheel.
- Host: GitHub
- URL: https://github.com/SinaMoetakef/SMNumberWheel
- Owner: SinaMoetakef
- License: mit
- Created: 2017-01-16T02:15:53.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-12-13T19:47:06.000Z (almost 7 years ago)
- Last Synced: 2024-11-17T10:03:37.582Z (25 days ago)
- Language: Swift
- Size: 1.91 MB
- Stars: 25
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - SMNumberWheel - A custom control written in Swift, which is ideal for picking numbers very fast but yet very accurate using a rotating wheel (UI / Stepper)
- awesome-ios-star - SMNumberWheel - A custom control written in Swift, which is ideal for picking numbers very fast but yet very accurate using a rotating wheel (UI / Stepper)
README
# SMNumberWheel
version: 1.0.3
[](https://travis-ci.org/Sina Moetakef/SMNumberWheel)
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/pods/SMNumberWheel)
[](http://cocoapods.org/pods/SMNumberWheel)
[](http://cocoapods.org/pods/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](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "SMNumberWheel"
```
### Carthage
[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.
You can install Carthage with [Homebrew](http://brew.sh/) using the following command:
```bash
$ brew update
$ brew install carthage
```
To integrate SMNumberWheel into your Xcode project using Carthage, specify it in your `Cartfile`:
```ogdl
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:
``` swift
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.
```swift
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.