Stepper

struct · iOS 13.0+ · SDK 27.1

nonisolated struct Stepper<Label> where Label : View

A control that performs increment and decrement actions. Use a stepper control when you want the user to have granular control while incrementing or decrementing a value. For example, you can use a stepper to: * Change a value up or down by `1`. * Operate strictly over a prescribed range. * Step by specific amounts over a stepper's range of possible values. The example below uses an array that holds a number of ``Color`` values, a local state variable, `value`, to set the control's background color, and title label. When the user clicks or taps the stepper's increment or decrement buttons, SwiftUI executes the relevant closure that updates `value`, wrapping the `value` to prevent overflow. SwiftUI then re-renders the view, updating the text and background color to match the current index: struct StepperView: View { @State private var value = 0 let colors: [Color] = [.orange, .red, .gray, .blue, .green, .purple, .pink] func incrementStep() { value += 1 if value >= colors.count { value = 0 } } func decrementStep() { value -= 1 if value < 0 { value = colors.count - 1 } } var body: some View { Stepper { Text("Value: \(value) Color: \(colors[value].description)") } onIncrement: { incrementStep() } onDecrement: { decrementStep() } .padding(5) .background(colors[value]) } }  The following example shows a stepper that displays the effect of incrementing or decrementing a value with the step size of `step` with the bounds defined by `range`: struct StepperView: View { @State private var value = 0 let step = 5 let range = 1...50 var body: some View { Stepper( value: $value, in: range, step: step ) { Text("Current: \(value) in \(range.description) " + "stepping by \(step)") } .padding(10) } } 

Members (0)

This type has no directly callable members in this snapshot. See the framework’s skipped declarations for unsupported APIs.

All SwiftUI types →