How to create a toggle switch

Paul Hudson @twostraws June 16th 2021

Updated for Xcode 13.0 beta 2

**Updated in iOS 15”

SwiftUI’s toggle lets users move between true and false states, just like UISwitch in UIKit.

For example, we could create a toggle that either shows a message or not depending on whether the toggle is enabled or not, but of course we don’t want to have to track the state of the toggle by hand – we want SwiftUI to do that for us.

Instead we should define a @State Boolean property that will be used to store the current value of our toggle. We can then use that to show or hide other views as needed.

For example:

struct ContentView: View {
    @State private var showGreeting = true

    var body: some View {
        VStack {
            Toggle("Show welcome message", isOn: $showGreeting)

            if showGreeting {
                Text("Hello World!")
            }
        }
    }
}

Download this as an Xcode project

I’ve made that code so that a text view is returned only when showGreeting is true, which means the VStack will decrease in size when showGreeting is false – it doesn’t have a second view in its stack.

If you want, you can customize the color used to create your toggle switch by using the toggleStyle() modifier. This is helpful because the Toggle view doesn’t work with accentColor(), so this is the only way to recolor it.

For example, this creates a red toggle:

struct ContentView: View {
    @State private var showGreeting = true

    var body: some View {
        VStack {
            Toggle("Show welcome message", isOn: $showGreeting)
                .toggleStyle(SwitchToggleStyle(tint: .red))

            if showGreeting {
                Text("Hello World!")
            }
        }
    }
}

Download this as an Xcode project

If you’re targeting iOS 15 or later, you can configure your switch to appear like a button by specifying .toggleStyle(.button). In this mode the button flips its tint color when its state is on:

struct ContentView: View {
    @State private var isOn = false

    var body: some View {
        Toggle("Filter", isOn: $isOn)
            .toggleStyle(.button)
            .tint(.mint)
    }
}

Download this as an Xcode project

Sponsor Hacking with Swift and reach the world's largest Swift community!

How to create a toggle switch

Similar solutions…