RangeSeekSlider

Overview

RangeSeekSlider

Demo

You can try on Appetize.io

or

Build Xcode project.

1. Open RangeSeekSlider.xcodeproj.
2. Change Scheme to

   RangeSeekSliderDemo

3. Run

Usage

Add the RangeSeekSlider like you would with any other UIControl. Either: - Add a view in your storyboard/xib and change its

Class

Module

RangeSeekSlider

or

• Create the

  RangeSeekSlider

  in code using

  RangeSeekSlider()

  then add it as a subview to your code and set the relevant autolayout properties or frame.

The default slider ranges from 0.0 -> 100.0 and has 10.0 preselected as the minimum, and 90.0 as the maximum.

Values that the user has selected are exposed using the

selectedMinValue

selectedMaxValue

Other customisation of the control is done using the following properties:

tintColor

The tintColor property (which you can also set in Interface Builder) sets the overall color of the control, including the color of the line, the two handles, and the labels.

It is safe to change the

tintColor

minValue

The minimum possible value to select in the range

maxValue

The maximum possible value to select in the range

selectedMinValue

The preselected minumum value (note: This should be less than the selectedMaxValue)

selectedMaxValue

The preselected maximum value (note: This should be greater than the selectedMinValue)

minLabelFont

The font of the minimum value text label. If not set, the default is system font size

12.0

maxLabelFont

The font of the maximum value text label. If not set, the default is system font size

12.0

numberFormatter

Each handle in the slider has a label above it showing the current selected value. If you change number format, update each properties of

NumberFormatter

hideLabels

When set to

true

false

labelsFixed

Fixes the labels above the slider controls. If

true

false

minDistance

The minimum distance the two selected slider values must be apart. Default is

0.0

maxDistance

The maximum distance the two selected slider values must be apart. Default is

CGFloat.greatestFiniteMagnitude

minLabelColor

The color of the minimum value text label. If not set, the default is the tintColor.

maxLabelColor

The color of the maximum value text label. If not set, the default is the tintColor.

handleColor

If set it will update the color of the handles. Default is

tintColor

colorBetweenHandles

The colorBetweenHandles property sets the color of the line between the two handles.

handleBorderColor

If set it will update the color of the handle borders. Default is

tintColor

initialColor

The color of the entire slider when the handle is set to the minimum value and the maximum value. Default is nil.

disableRange

If

true

In this case, the selectedMinValue will be not functional anymore. Use selectedMaxValue instead to determine the value the user has selected.

enableStep

If

true

step

step

If

enableStep

true

enableStep

handleImage

If set the image passed will be used for the handles.

handleDiameter

If set it will update the size of the handles. Default is

16.0

selectedHandleDiameterMultiplier

If set it update the scaling factor of the handle when selected. Default is

1.7

1.0

lineHeight

Set the height of the line. It will automatically round the corners. If not specified, the default value will be

1.0

handleBorderWidth

If set it will update the size of the handle borders. Default is

0.0

labelPadding

If set it will update the size of the padding between label and handle. Default is

8.0

minLabelAccessibilityLabel

The label displayed in accessibility mode for minimum value handler. If not set, the default is empty String.

maxLabelAccessibilityLabel

The label displayed in accessibility mode for maximum value handler. If not set, the default is empty String.

minLabelAccessibilityHint

The brief description displayed in accessibility mode for minimum value handler. If not set, the default is empty String.

maxLabelAccessibilityHint

The brief description displayed in accessibility mode for maximum value handler. If not set, the default is empty String.

func setupStyle()

When subclassing

RangeSeekSlider

setupStyle()

Requirements

• Swift 3.0+
• iOS 9.0+

Installation

Carthage

RangeSeekSlider is available through Carthage. To install it, simply add the following line to your Cartfile:

github "WorldDownTown/RangeSeekSlider"

⚠️Warning⚠️

When installed with Carthage,

@IBDesignable

@IBDesignable

RangeSeekSlider

@IBDesignable class CustomRangeSeekSlider: RangeSeekSlider {}

CocoaPods

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

pod 'RangeSeekSlider'

Manually

Download and drop

RangeSeekSlider/Sources

Author

WorldDownTown, [email protected]

License

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