Multiple rows Selection in SwiftUI List

SwiftUI List view has many built-in styles and functions.

With few lines of code, we can easily add multiple rows selection support in a SwiftUI list view.

How to make SwiftUI List support multiple rows selection

There are three steps to make SwiftUI List support multiple selections.

1. Create a Set variable to hold the selected rows. It must be a set of the list data's Identifiable.ID type.
2. Initialize a List with an initializer that accepts selection binding. Use the set we created in step 1 as an argument.
3. Get the list into Edit mode by either modifying the editMode value or adding an EditButton.

The following example shows how to create a simple list from an array of a Contact type.

The Contact type conforms to the Identifiable protocol with an id of type UUID.

// 1
struct Contact: Identifiable {
    let id = UUID()
    let name: String
}

struct ContentView: View {
    let contacts = [
        Contact(name: "John"),
        Contact(name: "Alice"),
        Contact(name: "Bob")
    ]
    // 2
    @State private var multiSelection = Set<UUID>()
        
    var body: some View {
        NavigationView {
            VStack {
                // 3
                List(contacts, selection: $multiSelection) { contact in
                    Text(contact.name)
                }
                Text("\(multiSelection.count) selections")                
            }
            .navigationTitle("Contacts")
            .toolbar {
                // 4
                EditButton()
            }
        }
    }
}

1 I create a Contact type with an Identifiable.ID of type UUID. This will be the type for our Set variable to hold selected rows.
2 We create a Set<UUID> variable to hold selected item. It has the same type as the list data's Identifiable.ID type, which is UUID in this case.
3 Initialize a List view with an initializer that accept the selection binding, init(selection:content:).
4 Add EditButton as a way to enter the Edit mode.

To enable multiple rows selection, a list view needs to be in Edit mode.

When you put the list into Edit mode, the list shows a circle next to each list item. When selected, a circle change to a checkmark to indicate selection.

You can easily support sarunw.com by checking out this sponsor.

Tiny OCR: Extract text from image directly from your mac.

Try it for Free

Make multiple selections without entering an edit mode

In the previous section, I mentioned that we need to enter an Edit mode to be able to select row items.

But that is not entirely true.

Not all platforms are created equal. Mac users can make multiple selections without entering an Edit mode.

By using a combination of modifier keys like Command (⌘), and mouse click, users can select multiple items in a list view without entering edit mode.

Here is an example of the same list on Mac. I remove EditButton entirely in this example.

struct ContentView: View {
    let contacts = [
        Contact(name: "John"),
        Contact(name: "Alice"),
        Contact(name: "Bob")
    ]
    
    @State private var multiSelection = Set<UUID>()
        
    var body: some View {
        NavigationView {
            VStack {
                List(contacts, selection: $multiSelection) { contact in
                    Text(contact.name)
                }
                Text("\(multiSelection.count) selections")
            }
            .navigationTitle("Contacts")
        }
    }
}

iOS 16 Behavior changes

In iOS 16, there are two noticeable changes in list selection:

1. Users can select a single item without entering an Edit mode.
2. If the devices have access to a keyboard and mouse or trackpad, like Mac and iPad, users can make multiple selections using a combination of modifier keys and click.

These two changes make it possible to use multiple selections with a list view across the platforms.

Here is an example of the same list without EditButton on iPhone with iOS 16.

struct ContentView: View {
    let contacts = [
        Contact(name: "John"),
        Contact(name: "Alice"),
        Contact(name: "Bob")
    ]
    
    @State private var multiSelection = Set<UUID>()
        
    var body: some View {
        NavigationView {
            VStack {
                List(contacts, selection: $multiSelection) { contact in
                    Text(contact.name)
                }
                Text("\(multiSelection.count) selections")
            }
            .navigationTitle("Contacts")
        }
    }
}

As you can see, we can select multiple items on iPhone without entering an Edit mode.