Close Menu

kwstepper

About KWStepper

KWStepper is a flexible stepper control, written in Swift, that allows users to easily select values by tapping or dragging a handle along a track. It provides a customizable interface that can be used in various iOS applications.

Features

  • Horizontal or vertical orientation
  • Customizable track appearance
  • Flexible handle design
  • Tap or drag to select values
  • Support for decimal and integer values
  • Control over minimum and maximum values
  • Step size customization
  • Delegate methods for value change events
  • Easy integration with existing projects

Installation

To integrate KWStepper into your project, you can use CocoaPods:

pod 'KWStepper'

If you prefer not to use CocoaPods, you can manually include the source files in your project.

Usage

Using KWStepper in your application is straightforward:

import KWStepper
let stepper = KWStepper()
stepper.frame = CGRect(x: 50, y: 100, width: 200, height: 40)
stepper.minimumValue = 0
stepper.maximumValue = 100
stepper.stepValue = 5
// Set appearance properties if desired
stepper.trackTintColor = .gray
stepper.handleBackgroundColor = .blue
// Customize handle design
stepper.handleType = .rectangle
stepper.handleImage = UIImage(named: "custom_handle")
// Add value change event handler
stepper.addTarget(self, action: #selector(stepperValueChanged), for: .valueChanged)
// Add the stepper to a view
view.addSubview(stepper)
...
@objc func stepperValueChanged() {
    let selectedValue = stepper.value
    // Perform actions based on the selected value
}

Properties

KWStepper provides several properties for customization:

  • minimumValue: The minimum selectable value.
  • maximumValue: The maximum selectable value.
  • stepValue: The increment or decrement value when tapping the stepper.
  • value: The current selected value.
  • trackTintColor: The color of the track.
  • trackHighlightTintColor: The color of the highlighted portion of the track.
  • handleBackgroundColor: The background color of the handle.
  • handleType: The shape of the handle (rectangle or rounded).
  • handleImage: An optional custom image to use as the handle.
  • delegate: An object conforming to the KWStepperDelegate protocol to handle events.

Delegate Methods

KWStepper provides delegate methods to handle value change events:

func stepperValueDidChange(_ stepper: KWStepper) {
    let selectedValue = stepper.value
    // Perform actions based on the selected value
}
func stepperDidReachMaximumValue(_ stepper: KWStepper) {
    // Called when the stepper reaches the maximum value
}
func stepperDidReachMinimumValue(_ stepper: KWStepper) {
    // Called when the stepper reaches the minimum value
}

Support

If you need any assistance or have questions, feel free to reach out to the KWStepper community through the GitHub repository or the Gitter channel. You can also find sample projects and documentation in the repository.

License

KWStepper is released under the MIT license. See the LICENSE file for more information.