How to add sections to a list

Paul Hudson    @twostraws    September 18th 2019

Fully updated for Xcode 11.2

SwiftUI’s list view has built-in support for sections and section headers, just like UITableView in UIKit. To add a section around some cells, start by placing a Section around it, optionally also adding a header and footer.

As an example, here’s a row that holds task data for a reminders app:

struct TaskRow: View {
    var body: some View {
        Text("Task data goes here")
    }
}

What we want to do is create a list view that has two sections: one for important tasks and one for less important tasks. Here’s how that looks:

struct ContentView: View {
    var body: some View {
        List {
            Section(header: Text("Important tasks")) {
                TaskRow()
                TaskRow()
                TaskRow()
            }

            Section(header: Text("Other tasks")) {
                TaskRow()
                TaskRow()
                TaskRow()
            }
        }
    }
}

You can also add footer text to sections, like this:

Section(header: Text("Other tasks"), footer: Text("End")) {
    TaskRow()
    TaskRow()
    TaskRow()
}

Similar solutions…

• Breaking forms into sections
• Building a menu using List
• Two-way bindings in SwiftUI
• Adding items to an order with @EnvironmentObject
• Composing views to create a list row