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: about 2 months ago
JSON representation

A custom reusable slider control with 2 thumbs (range slider).

Lists

README

        

# MARKRangeSlider

[![Version](https://img.shields.io/cocoapods/v/MARKRangeSlider.svg?style=flat)](http://cocoadocs.org/docsets/MARKRangeSlider)
[![License](https://img.shields.io/cocoapods/l/MARKRangeSlider.svg?style=flat)](http://cocoadocs.org/docsets/MARKRangeSlider)
[![Platform](https://img.shields.io/cocoapods/p/MARKRangeSlider.svg?style=flat)](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
![Alt text](https://cloud.githubusercontent.com/assets/10529867/6666031/88515f20-cbe0-11e4-83d7-a8bca824ab67.gif "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.