Features

Usage

letslider=MultiSlider()slider.minimumValue=1    // default is 0.0slider.maximumValue=5    // default is 1.0slider.value=[1,4.5,5]slider.addTarget(self, action: #selector(sliderChanged(_:)), for:.valueChanged) // continuous changesslider.addTarget(self, action: #selector(sliderDragEnded(_:)), for:. touchUpInside) // sent when drag ends

SwiftUI Usage

@StatevarvalueArray:[CGFloat]=[7,13]// ...MultiValueSlider(value: $valueArray, minimumValue:1, maximumValue:5)

MultiValueSlider(value: $valueArray, outerTrackColor:.lightGray).thumbTintColor(.blue)

Getting multiple thumb values

func sliderChanged(slider:MultiSlider){print("thumb\(slider.draggedThumbIndex) moved")print("now thumbs are at\(slider.value)") // e.g., [1.0, 4.5, 5.0]}

Range slider

slider.outerTrackColor=.lightGray // outside of first and last thumbs

Vertical / horizontal orientation

slider.orientation=.horizontal // default is .verticalslider.isVertical=false // same effect, but accessible from Interface Builder

Value labels

slider.valueLabelPosition=.left // .notAnAttribute = don't show labelsslider.valueLabelAlternatePosition=true // alternate left and right positions (false by default)slider.isValueLabelRelative=true // show differences between thumbs instead of absolute valuesslider.valueLabelFormatter.positiveSuffix=" 𝞵s"slider.valueLabelColor=.greenslider.valueLabelFont= someFont

slider.valueLabelTextForThumb={ thumbIndex, thumbValuein["Parasol","Umbrella"][thumbIndex]+"\(thumbValue)"}

Snap steps

slider.snapStepSize=0.5 // default is 0.0, i.e. don't snapslider.snapValues=[1,2,4,8] // specify specific snap values instead uniform stepsslider.isHapticSnap=false // default is true, i.e. generate haptic feedback when sliding over snap valuesslider.snapImage=UIImage(systemName:"circle.fill") // default: no image

Changing Appearance

slider.tintColor=.cyan // color of trackslider.thumbTintColor=.blue // color of thumbsslider.trackWidth=32slider.hasRoundTrackEnds=trueslider.showsThumbImageShadow=false // wide tracks look better without thumb shadowslider.centerThumbOnTrackEnd=true // when thumb value is minimum or maximum, align it's center with the track end instead of its edge

Images

// add images at the ends of the slider:slider.minimumImage=UIImage(named:"clown")slider.maximumImage=UIImage(named:"cloud")// change image for all thumbs:slider.thumbImage=UIImage(named:"balloon")// or let each thumb have a different image:slider.thumbViews[0].image=UIImage(named:"ball")slider.thumbViews[1].image=UIImage(named:"club")// expand drag area when using a small thumb image:slider.thumbTouchExpansionRadius=16

Distance/Overlap Between Thumbs

// allow thumbs to overlap:slider.keepsDistanceBetweenThumbs=false// make thumbs keep a greater distance from each other (default = half the thumb size):slider.distanceBetweenThumbs=3.14

Disabling/freezing thumbs

slider.disabledThumbIndices=[1,3]

Requirements

Installation

CocoaPods:

pod'MultiSlider'

Swift Package Manager:

dependencies:[.package(url:"https://github.com/yonat/MultiSlider", from:"2.2.1")]

Meta