Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kronik/ScalePicker
Generic scale and a handy float-value picker for any iOS app.
https://github.com/kronik/ScalePicker
Last synced: 3 months ago
JSON representation
Generic scale and a handy float-value picker for any iOS app.
- Host: GitHub
- URL: https://github.com/kronik/ScalePicker
- Owner: kronik
- License: mit
- Created: 2016-03-14T06:37:45.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-02-10T07:42:50.000Z (over 7 years ago)
- Last Synced: 2024-02-19T21:10:26.898Z (4 months ago)
- Language: Objective-C
- Homepage: https://github.com/kronik/ScalePicker
- Size: 15.5 MB
- Stars: 166
- Watchers: 6
- Forks: 25
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-ios-ui - ScalePicker - Generic scale and a handy float-value picker for any iOS app (UI)
- awesome-ios2 - ScalePicker - Generic scale and a handy float-value picker for any iOS app. (UI / Other free courses)
- awesome-ios - ScalePicker - Generic scale and a handy float-value picker for any iOS app. (UI / Other free courses)
- awesome-ios - ScalePicker - Generic scale and a handy float-value picker for any iOS app. (UI / Other free courses)
- awesome-xamarin-forms - ScalePicker - Generic scale and a handy float-value picker for any iOS app (UI)
- awesome-ios - ScalePicker - Generic scale and a handy float-value picker for any iOS app. (UI / Other free courses)
- learn.awesome-iOS - ScalePicker - Generic scale and a handy float-value picker for any iOS app. (UI)
- learn.awesome.ios - ScalePicker - Generic scale and a handy float-value picker for any iOS app. (UI / Other Testing)
README
# ScalePicker
Generic scale and a handy float-value picker for any iOS app.
## Preview
## Installation
### With source code
[Download repository](https://github.com/kronik/ScalePicker/archive/master.zip), then add [ScalePicker directory](https://github.com/kronik/ScalePicker/blob/master/ScalePicker/) to your project.
### With CocoaPods
CocoaPods is a dependency manager for Objective-C/Swift, which automates and simplifies the process of using 3rd-party libraries in your projects. To install with cocoaPods, follow the "Get Started" section on [CocoaPods](https://cocoapods.org/).
#### Podfile
```ruby
platform :ios, '8.0'
use_frameworks!
pod 'ScalePicker'
```
### With Carthage
Carthage is a lightweight dependency manager for Swift and Objective-C. It leverages CocoaTouch modules and is less invasive than CocoaPods. To install with carthage, follow the instruction on [Carthage](https://github.com/Carthage/Carthage/).
You can install Carthage with [Homebrew](http://brew.sh/) using the following command:
```bash
$ brew update
$ brew install carthage
```
To integrate ScalePicker into your Xcode project using Carthage, specify it in your `Cartfile`:
```ogdl
github "kronik/ScalePicker"
```
## Usage
### Initialisation
Instantiate scale view with preferred frame:
```swift
let screenWidth = UIScreen.mainScreen().bounds.size.width
let scaleView = ScalePicker(frame: CGRectMake(0, 0, screenWidth, 50))
view.addSubview(scaleView)
```
### Properties
####Set minimum value
```swift
scaleView.minValue = -3.0
```
####Set maximum value
```swift
scaleView.maxValue = 3.0
```
####Set number of ticks between values value
```swift
scaleView.numberOfTicksBetweenValues = 2
```
####Set space between ticks
```swift
scaleView.spaceBetweenTicks = 20.0
```
####Set tick label visibility
```swift
scaleView.showTickLabels = true
```
####Set a delegate
```swift
scaleView.delegate = self
```
####Set ability to snap to the nearest value
```swift
scaleView.snapEnabled = true
```
####Set bounces value
```swift
scaleView.bounces = false
```
####Set tick (and center/arrow view) color
```swift
scaleView.tickColor = UIColor.whiteColor()
```
####Set center/arrow image
```swift
scaleView.centerArrowImage = UIImage(named: "arrowPointer")
```
### Control actions
#### Increase current value
```swift
scaleView.increaseValue()
```
#### Decrease current value
```swift
scaleView.decreaseValue()
```
#### Reset current value
```swift
scaleView.reset()
```
#### Gestures
In addition to increase/decrease/reset actions ScaleView allows you to double tap to trigger reset action
### More
For more details try Xcode [Demo project](https://github.com/kronik/ScalePicker/blob/master/Demo)
# Etc.
* Contributions are very welcome.
* Attribution is appreciated (let's spread the word!), but not mandatory.
## Use it? Love/hate it?
Tweet the author [@dklimkin](http://twitter.com/dklimkin), and check out Dmitry's portfolio: http://dmitry-klimkin.com
## License
ScalePicker is released under the MIT license. See [LICENSE](https://raw.githubusercontent.com/kronik/ScalePicker/master/LICENSE) for details.