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.

mludowise / verticalsteppedslider Goto Github PK