Skip to content

3ph/RxSplitSlider

Repository files navigation

RxSplitSlider

CI Status Version License Platform Swift

Reactive extension for SplitSlider.

Customizable two way slider split in the middle. Left and right parts are independent, each can have different min, max, step, colors, etc.

Screenshot

Usage

Simply add as custom view to storyboard or create programatically. Don't forget to import SplitSlider as well.

let slider = SplitSlider()

Generic slider properties (affects both parts):

// Minimal slider value.
slider.min = 0
// Maximal slider value.
slider.max = 100
// Step value of the slider.
slider.step = 5
// Font of the value labels.
slider.labelFont = UIFont.systemFont(ofSize: 10)
// Font color of the value labels.
slider.labelTextColor = UIColor.black
// Size of the slider's thumb.
slider.thumbSize = 20
// Color of the thumb.
slider.thumbColor = UIColor.darkGray
// Track height.
slider.trackHeight = 0
// Track color.
slider.trackColor = = UIColor.lightGray
// Color of selected part of the track.
slider.trackHighlightColor = UIColor.gray
// Determines if thumb should be snapped to the closest step after the move.
slider.snapToStep = true

All above properties would affect both portions of the slider but can be set individually through either slider.left or slider.right portion.

Observing changes

// Slider portion selected - called when user selects (holds) portion of the slider. Return `nil` when no portion is being selected.
splitSlider
    .rx
    .portionSelected
    .asDriver(onErrorJustReturn: nil)
    .drive(onNext: { portion in
        let portionString = portion == self.splitSlider.left ? "left" : "right"
        NSLog("Selected part: \(portion == nil ? "none" : portionString)")
    }).disposed(by: disposeBag)
    
// Slider value changed for portion of slider.
splitSlider
    .rx
    .portionValueChanged
    .asDriver(onErrorJustReturn: (0, SplitSliderPortion()))
    .drive(onNext: { [unowned self] (value, portion) in
        let portionString = portion == self.splitSlider.left ? "left" : "right"
        NSLog("Current value: \(value) (portion: \(portionString))")
    }).disposed(by: disposeBag)

Example

To run the example project, run pod try.

Requirements

iOS 8+.

Installation

RxSplitSlider is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "RxSplitSlider"

Author

Tomas Friml, instantni.med@gmail.com

License

RxSplitSlider is available under the MIT license. See the LICENSE file for more info.

About

Reactive extensions for SplitSlider

Resources

License

Stars

Watchers

Forks

Packages

No packages published