Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vadymmarkov/MARKRangeSlider
A custom reusable slider control with 2 thumbs (range slider).
https://github.com/vadymmarkov/MARKRangeSlider
Last synced: 3 months ago
JSON representation
A custom reusable slider control with 2 thumbs (range slider).
- Host: GitHub
- URL: https://github.com/vadymmarkov/MARKRangeSlider
- Owner: vadymmarkov
- License: other
- Created: 2015-03-08T14:09:56.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2022-11-21T11:42:24.000Z (over 2 years ago)
- Last Synced: 2024-11-25T21:12:11.784Z (3 months ago)
- Language: Objective-C
- Homepage: https://github.com/vadymmarkov
- Size: 94.7 KB
- Stars: 185
- Watchers: 9
- Forks: 51
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-ios - MARKRangeSlider - A custom reusable slider control with 2 thumbs (range slider). (UI / Slider)
- awesome-ios-star - MARKRangeSlider - A custom reusable slider control with 2 thumbs (range slider). (UI / Slider)
README
# MARKRangeSlider
[](http://cocoadocs.org/docsets/MARKRangeSlider)
[](http://cocoadocs.org/docsets/MARKRangeSlider)
[](http://cocoadocs.org/docsets/MARKRangeSlider)
A custom reusable slider control with 2 thumbs (range slider). Values range is between `minimumValue` and `maximumValue` (from 0 to 1 by default). The left thumb isn't able to go on the right side of the right thumb, and vice versa. Control enables multitouch (to use 2 fingers at 2 thumbs at the same time).
Please check Demo project for a basic example on how to use MARKRangeSlider.
### Demo
### Available control properties
- `minimumValue` - the minimum value of the slider's range (readonly)
- `maximumValue` - the maximum value of the slider's range (readonly)
- `leftValue` - the value of the left thumb (readonly)
- `rightValue` - the value of the right thumb (readonly)
- `minimumDistance` - the distance between 2 thumbs (thumbs can't be closer to each other than this distance)
- `pushable` - allows the user to push both controls
- `disableOverlapping` - disables the overlaping of thumb controls
- `sendInstantUpdates` - allows the user to select between instant updates and after completing drag of thumb
### Available control methods
- `(void)setMinValue:(CGFloat)minValue maxValue:(CGFloat)maxValue`
- `(void)setLeftValue:(CGFloat)leftValue rightValue:(CGFloat)rightValue`
## Available styling properties
Images are customizable, default ones are used when no image is provided.
- `trackImage` - track background image
- `rangeImage` - range background image
- `leftThumbImage` - left thumb image
- `rightThumbImage` - right thumb image
## Usage
#### In your View Controller
```objc
- (void)viewDidLoad {
// ...
self.rangeSlider = [[MARKRangeSlider alloc] initWithFrame:CGRectZero];
[self.rangeSlider addTarget:self
action:@selector(rangeSliderValueDidChange:)
forControlEvents:UIControlEventValueChanged];
[self.rangeSlider setMinValue:0.0 maxValue:1.0];
[self.rangeSlider setLeftValue:0.2 rightValue:0.7];
self.rangeSlider.minimumDistance = 0.2;
[self.view addSubview:self.rangeSlider];
// ...
}
- (void)rangeSliderValueDidChange:(MARKRangeSlider *)slider {
NSLog(@"%0.2f - %0.2f", slider.leftValue, slider.rightValue);
}
```
## Installation
**MARKRangeSlider** is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
`pod 'MARKRangeSlider'`
## Author
Vadym Markov, [email protected]
## License
**MARKRangeSlider** is available under the MIT license. See the LICENSE file for more info.