Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/farshidce/RKMultiUnitRuler
Simple customizable ruler control that supports multiple units
https://github.com/farshidce/RKMultiUnitRuler
Last synced: 3 months ago
JSON representation
Simple customizable ruler control that supports multiple units
- Host: GitHub
- URL: https://github.com/farshidce/RKMultiUnitRuler
- Owner: farshidce
- License: mit
- Created: 2017-01-08T02:47:20.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-08-01T21:10:51.000Z (almost 5 years ago)
- Last Synced: 2024-03-13T14:12:52.063Z (3 months ago)
- Language: Swift
- Homepage:
- Size: 48.8 KB
- Stars: 61
- Watchers: 4
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-ios2 - RKMultiUnitRuler - Simple customizable ruler control that supports multiple units. (UI / Other free courses)
README
# RKMultiUnitRuler
[](https://travis-ci.org/farshidce/RKMultiUnitRuler)
[](http://cocoapods.org/pods/RKMultiUnitRuler)
[](http://cocoapods.org/pods/RKMultiUnitRuler)
[](http://cocoapods.org/pods/RKMultiUnitRuler)
## RKMultiUnitRuler - Customizable Ruler Control for iOS
A cocoa pod that simplifies process of setting and reading values for different units. This control let the user
specify multiple units ( e.g Kilograms and Pound) and specify markers for each unit and then let the user
modify the value via scrolling or updating the textfield.
## Requirements
* iOS 10 or higher
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Installation
RKMultiUnitRuler is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```
pod "RKMultiUnitRuler"
```
and run pod install in terminal.
Usage
## RKMultiUnitRuler
### Compatibility
iOS 10+
xCode 8.0+
Swift 3.0
####You can use storyboard to create a control element.
### Features
- Extremely simple and easy to use
- Customizable interface
- Compatible with iOS 10.0 NSUnit Framework
- Supports multiple units
- Customize marker colors based on type or their value
- Customize the width, length and number of markers of the ruler
- Customize the unit formatter
## How to use
```swift
class ViewController: UIViewController, RKMultiUnitRulerDataSource, RKMultiUnitRulerDelegate {
}
```
Set the ruler direction to horizontal
```swift
ruler.direction = .horizontal
```
```swift
ruler.direction = .vertical
```
Specify how many units the ruler will display
```swift
var numberOfSegments: Int {
get {
return 2.0
}
}
```
Define multiple units (Pounds and Kilograms).
In the example below we are creating two markers for Kilogram unit at 0.1 and 1.0 scale but we are creating one marker for Pounds.
For instance if the range is between 10-12 the "Kgs" ruler will have markers for 10.0,10.1,10.2...11.0,11.1...12.0
and the "lbs" ruler will display markers at 3.0, 4.0,...,26.0.
```swift
func unitForSegmentAtIndex(index: Int) -> RKSegmentUnit {
return segments[index]
let formatter = MeasurementFormatter()
formatter.unitStyle = .medium
formatter.unitOptions = .providedUnit
let kgSegment = RKSegmentUnit(name: "Kilograms", unit: UnitMass.kilograms, formatter: formatter)
kgSegment.markerTypes = [
RKRangeMarkerType(color: UIColor.white, size: CGSize(width: 1.0, height: 35.0), scale: 0.1),
RKRangeMarkerType(color: UIColor.white, size: CGSize(width: 1.0, height: 50.0), scale: 1.0)]
let lbsSegment = RKSegmentUnit(name: "Pounds", unit: UnitMass.pounds, formatter: formatter)
lbsSegment.markerTypes = [
RKRangeMarkerType(color: UIColor.white, size: CGSize(width: 1.0, height: 35.0), scale: 1.0)]
kgSegment.markerTypes.last?.labelVisible = true
lbsSegment.markerTypes.last?.labelVisible = true
return [lbsSegment, kgSegment]
}
```
The ruler will display markers between 30.0 and 130. kgs. rangeForUnit function needs
to be implemented for returning the range for the given unit. Please note that
ceilf method is used in order to round the float numbers to the closest int.
```swift
var rangeStart = Measurement(value: 30.0, unit: UnitMass.kilograms)
var rangeLength = Measurement(value: Double(130), unit: UnitMass.kilograms)
func rangeForUnit(_ unit: Dimension) -> RKRange {
let locationConverted = rangeStart.converted(to: unit as! UnitMass)
let lengthConverted = rangeLength.converted(to: unit as! UnitMass)
return RKRange(location: ceilf(Float(locationConverted.value)),
length: ceilf(Float(lengthConverted.value)))
}
```
Customize the style and font used for markers and the scroll views
```swift
let style: RKSegmentUnitControlStyle = RKSegmentUnitControlStyle()
style.scrollViewBackgroundColor = UIColor.blue
style.textFieldBackgroundColor = UIColor.red
style.textFieldBackgroundColor = UIColor.clear
style.textFieldTextColor = UIColor.white
return style
```
In order to apply multiple colors to the ruler for each unit you can set the colorOverrides property as shown below
```swift
style.colorOverrides = [
RKRange(location: range.location, length: 0.1 * (range.length)): UIColor.red,
RKRange(location: range.location + 0.4 * (range.length), length: 0.2 * (range.length)): UIColor.green]
```
Implement RKMultiUnitRulerDataSource protocol in order to customize units, range and the style used for drawing the markers
```swift
func unitForSegmentAtIndex(index: Int) -> RKSegmentUnit
func rangeForUnit(_ unit: Dimension) -> RKRange
var numberOfSegments: Int { get set }
func styleForUnit(_ unit: Dimension) -> RKSegmentUnitControlStyle
```
To get the latest value that the user has picked, implement RKMultiUnitRulerDelegate.
```swift
func valueChanged(measurement: NSMeasurement) {
print("value changed to \(measurement.doubleValue)")
}
```
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Support
If you have any other questions regarding the use of this library, please contact us for support at [email protected] (email subject: "CRRulerControl. Support request.")
## Author
[Farshid Ghods]([email protected])
## Special Thanks
[CRRulerControl](https://github.com/Cleveroad/CRRulerControl)
[VitPilot Concept Design](https://www.behance.net/gallery/42058853/VitPilot-(Mobile-App))
## Todos
- create a version that works with iOS 8,9
- add a circular slider/ruler
- add a rating 1-5 ruler
## License
The MIT License (MIT)
Copyright (c) 2016 Rekovery Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.