Basic form design

Paul Hudson @twostraws March 11th 2021

Updated for Xcode 13.0 beta 2

SwiftUI’s forms work as containers, just like HStack and VStack, which means you can add other views inside it as needed. However, they automatically adapt the behavior and styling of some controls so they fit better in the form environment.

For example, this creates a form with a toggle, a segmented control, and a button:

struct ContentView: View {
    @State private var enableLogging = false
    @State private var selectedColor = "Red"
    @State private var colors = ["Red", "Green", "Blue"]

    var body: some View {
        Form {
            Picker("Select a color", selection: $selectedColor) {
                ForEach(colors, id: \.self) {
                    Text($0)
                }
            }
            .pickerStyle(SegmentedPickerStyle())

            Toggle("Enable Logging", isOn: $enableLogging)

            Button("Save changes") {
                // activate theme!
            }
        }
    }
}

Download this as an Xcode project

When that code is run you’ll see two things that are fundamental to the behavior of forms:

On iOS the form automatically adopts the style of a grouped list, so users see a scrolling selection of options.
The button has adapted itself to look like an actionable list row – it’s left-aligned and in blue.

You can have as many rows in your form as you need, but remember to use groups if you need more than 10.