listRowInsets(_:_:)

Declaration

nonisolated func listRowInsets(_ edges: Edge.Set = .all, _ length: CGFloat?) -> some View

Parameters

• edges:

  The edges to set the insets to.

• length:

  An amount, given in points, to set the insets to on the specified edges.

Return Value

A view in which the margins of list sections are set to the specified amount

Discussion

Use this modifier to change the default insets of list rows on the specified edges.

In the example below, the Flavor enumeration provides content for list items. The SwiftUI ForEach structure computes views for each element of the Flavor enumeration and extracts the raw value of each of its elements using the resulting text to create each list row item. The listRowInsets(_:_:) modifier then changes the leading inset of each row of the list and leaves the default insets on the other edges untouched:

struct ContentView: View {
    enum Flavor: String, CaseIterable, Identifiable {
        var id: String { self.rawValue }
        case vanilla, chocolate, strawberry
    }

    var body: some View {
        List {
            ForEach(Flavor.allCases) {
                Text($0.rawValue)
                    .listRowInsets(.leading, 25)
            }
        }
    }
}

[Image]

When applying multiple listRowInsets modifiers, modifiers with the same edges will override modifiers higher up in the view hierarchy.