Swiftpack.co - daprice/iOS-Tactile-Slider as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by daprice.
daprice/iOS-Tactile-Slider 3.0.0
UIControl slider that can be dragged from any point within its bounds, similar to those in Control Center and Home.app
⭐️ 205
🕓 44 weeks ago
iOS
.package(url: "https://github.com/daprice/iOS-Tactile-Slider.git", from: "3.0.0")

TactileSlider

CI Status Swift Package Manager compatible Version Carthage compatible License Platform

A slider control designed to be easy to grab and use because it can be dragged or tapped from anywhere along its track, similar to the sliders in Control Center and HomeKit. Because this type of slider graphically represents direct manipulation of a value, it should be used for live adjustment of values whose changes can be directly observed in real time (such as audio volume or the brightness of a light).

Animation of TactileSliders in various orientations being clicked and dragged in the iOS simulator, followed by a transition from light to dark appearance

Features

  • Can be dragged or (optionally) tapped to set a value
  • Supports horizontal and vertical orientation in either direction
  • IBDesignable – colors, values, rounded corners, and behavior can be customized in Interface Builder or programatically
  • Supports light & dark appearance using semantic system colors with borders that can automatically appear in low contrast situations (iOS 13+)
  • Adjustable haptic feedback (iOS 10+)
  • VoiceOver support
  • Supports pointer (e.g. trackpad or mouse) based scrolling on iPadOS (iOS 13.4+)

Example

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

Requirements

iOS 9.0+

  • iOS 10.0+ required for haptic feedback
  • iPadOS 13.4+ required for pointer use

Installation

TactileSlider is available as a Swift package or through CocoaPods.

To install it using CocoaPods, simply add the following line to your Podfile:

pod 'TactileSlider'

Usage

For the full documentation using Xcode 13 or later, add TactileSlider as a dependency or download a local copy, then choose Product > Build Documentation. In previous versions of Xcode, symbol documentation will appear in Quick Help.

let slider = TactileSlider(frame: someRect)

slider.minimumValue = 1
slider.maximumValue = 10

slider.setValue(3.8, animated: true)

Setting orientation and direction

slider.vertical = true
slider.reverseValueAxis = true

Adjusting behavior

slider.isContinuous = false // send events only at end of gesture vs continuously
slider.enableTapping = false // allow or disallow tapping anywhere on the slider track to instantly set a value
slider.feedbackStyle = .medium // customize haptic feedback when the slider reaches the end
slider.isScrollingEnabled = false // allow or disallow scrolling to adjust the slider using a connected pointing device on iPadOS
slider.precisionRampUpDistance = 10 // enable finer adjustment when moving the slider by amounts smaller than this distance (in screen points)

Changing colors and appearance

slider.trackBackground = UIColor.black.withAlpha(0.8) // use translucent black for the slider track
slider.tintColor = UIColor.systemGreen // use dynamic green for the slider thumb

slider.outlineColor = UIColor.gray // color of outline around slider and thumb (if unset, will be determined automatically based on contrast between tintColor and current system appearance)
slider.outlineColorProvider = { slider, suggestedColor -> UIColor? in … } // provide your own closure to set the outline color dynamically
slider.outlineSize = 2 // set thickness of outline

slider.cornerRadius = 12 // size of corner radius; defaults to automatic based on the slider's bounds

slider.isPointerInteractionEnabled = true // display a hover effect when under the pointer on iPadOS

Fine tuning accessibility

By default, the accessibility increment and decrement gestures change the value by 10% of the slider's range, matching the behavior of UISlider. This can be adjusted:

slider.steppingMode = .percentage(5) // specify a percentage to increment/decrement the slider's value by
slider.steppingMode = .stepValue(0.1) // specify a fixed value to increment/decrement the slider's value by

Interface Builder

screenshot of Xcode Interface Builder demonstrating a TactileSlider being customized using the graphical interface

Author

Dale Price (@dale_price@mastodon.technology)

License

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

GitHub

link
Stars: 205
Last commit: 1 week ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

3.0.0
44 weeks ago
  • Documentation follows DocC standard.
    • In Xcode 13 or later, select Product > Build Documentation in your project that includes TactileSlider as a dependency and the full documentation will be viewable in Xcode’s documentation browser, as well as symbol documentation in Quick Help and code completion.
    • In earlier versions of Xcode, symbol documentation will continue to be shown in Quick Help and code completion.
  • Customizable outline color and thickness (by default, automatically shown when contrast between tint color and system theme is low, similar to the iOS 14+ Home.app sliders).
  • Adjustable precision when the user makes small adjustments – see TactileSlider.precisionRampUpDistance.
  • Configure the step size of accessibility increment and decrement using TactileSlider.steppingMode.
  • Matches UISlider's iOS 14+ behavior of sending both .valueChanged and .primaryActionTriggered events when moved.
  • Minor bugfixes and polish.
  • Now Carthage compatible.
  • Now requires iOS 9 or later.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics