VerticalSteppedSlider

Introduction

VerticalSteppedSlider is a completely configurable slider for iOS written in Swift. Configure custom track widths, colors, or images, set the size of the step inrements as well as vertical orientation.

Demo

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

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

pod 'VerticalSteppedSlider'

Usage

Firstly, import VerticalSteppedSlider.

import VerticalSteppedSlider

Initialization

There are two ways to create a VSSlider:

• In the storyboard, change the class of a UIView to VSSlider and set the module to VerticalSteppedSlider.
• In code using an init(frame:CGRect)

Using Increments

The property increment determines where the marks will be drawn on the slider and will round the value to the nearest increment after sliding the slider.

For example, if the minimumValue is -1, maximumValue is 1, and increment is 0.5, the a mark will be drawn at -0.5, 0, and 0.5. Likewise, the slider will only allow the values -1, -0.5, 0, 0.5, and 1 when sliding the slider.

Customizing the Slider’s Appearance

If you want to change the colors of the track and thumb, you can set custom tint colors for both the track and the thumb of a slider, using the minimumTrackTintColor, maximumTrackTintColor, markColor, and thumbTintColor properties. You can also specify the thickness of the track with trackWidth and the weight of the increment marks with markWidth. By default, the minimum track tint color defers to the tint color of the slider control.

You can more finely control the appearance of the slider by specifying the images used to draw the thumb and the track.

The trackExtendsUnderThumb property determines the length of the track. By default, the slider tracks extend before the minimumValue and after the maximumValue in order to make the thumb align with the beginning and end of the slider. This matches the default behavior of Apple's UISlider To turn this off and view a more accurate slider, set trackExtendsUnderThumb to false.

Properties, Topic, Property, Description, Type, Default Value, -------, ---------------, ------------------------------, ------------, ----------------, Accessing the Slider’s Value, value, Current raw value of the slider, not rounded to the nearest the increment. See UISlider.value for more information., Float, 0, roundedValue, Computed property that returns the value rounded to the nearest increment., Float, Accessing the Slider’s Value Limits, minimumValue, See UISlider.minimumValue for more information., Float, 0, maximumValue, See UISliuder.maximumValue for more information., Float, 1, increment, The step increment for the slider. Set to 0 if the slider should be smooth and not round to the nearest increment., Float, 0.5, Modifying the Slider’s Behavior, isContinuous, A Boolean value indicating whether changes in the slider’s value generate continuous update events. See UISlider.isContinuous., Bool, true, Changing the Slider’s Appearance, vertical, If orientation of slider should be vertical or horizontal., Bool, true, ascending, Ascending is defined as: Min on the left and max on the right when horizontal in left-to-right localized layouts.Min on the right and max on the left when horizontal in right-to-left localized layouts.Min on top and max on the bottom when vertical, Bool, false, trackWidth, The thickness of the slider track in points., CGFloat, 2, trackExtendsUnderThumb, Defines if the track should be slightly wider than its min and max values to accomodate for the width of the slider thumb. The value "true" replicates the behavior of UISlider but the increment marks will appear as though there is more space between the first and last marks and the ends of the slider., Bool, true, markWidth, The thickness of the increment marks on the slider in points., CGFloat, 1, markColor, Color of the marks of the slider., UIColor, darkGray, minimumTrackTintColor, The color used to tint the default minimum track images. If minimumTrackImage is non-nil, this is ignored. See UISlider.minimumTrackTintColor for more information., UIColor?, nil, minimumTrackImage, Assigns a minimum track image to the specified control states. Setting this image, calls setMinimumTrackImage() on the internal UISlider for the .normal state. If non-nil, overrides minimumTrackTintColor. See Apple's Customizing the Slider’s Appearance for more information., UIImage?, nil, maximumTrackTintColor, The color used to tint the default maximum track images. If minimumTrackImage is non-nil, this is ignored. See UISlider.minimumTrackTintColor for more information., UIColor?, nil, maximumTrackImage, Assigns a maximum track image to the specified control states. Setting this image, calls setMaximumTrackImage() on the internal UISlider for the .normal state. If non-nil, overrides maximumTrackTintColor. See Apple's Customizing the Slider’s Appearance for more information., UIImage?, nil, thumbTintColor, The color used to tint the default thumb images. If thumbImage is non-nil, this is ignored. See UISlider.thumbTintColor for more information., UIColor?, nil, thumbImage, Assigns a thumb image to the specified control states. If non-nil, overrides thumbTintColor. See Apple's Customizing the Slider’s Appearance for more information., UIImage?, nil, ## License

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