Interactive previews iPhone

Custom List Section Spacing

Sets the spacing between adjacent sections in a List to a custom value.

Custom List Section Spacing - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview

Platform Compatibility

iOS 17.0+ iPadOS 17.0+ watchOS 10.0+ visionOS 1.0+

Tags

SwiftUI Code

Docs
List {
  Section("Header") {
    Text("Foo")
  }
  Section("Header") {
    Text("Bar")
  }
  .listSectionSpacing(42)
  Section("Header") {
    Text("Foo")
  }
}

Found an issue or have a suggestion?

Created: August 6, 2025Updated: August 6, 2025

More List Components

View all
Outline Group - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
initializer

Outline Group

A structure that computes views and disclosure groups on demand from an underlying collection of tree-structured, identified data.

Disclosure Group - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
initializer

Disclosure Group

A view that shows or hides another content view, based on the state of a disclosure control.

Edit Button - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
initializer

Edit Button

A button that toggles the edit mode environment value.

Section Index Label and Visibility - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Section Index Label and Visibility

Sets the label that is used in a section index to point to this section, typically only a single character long. Changes the visibility of the list section index.

Move Disabled - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Move Disabled

Adds a condition for whether the view’s view hierarchy is movable.

Delete Disabled - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Delete Disabled

Adds a condition for whether the view’s view hierarchy is deletable.

Refreshable List - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Refreshable List

Marks this view as refreshable.

Swipe Action - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Swipe Action

Adds custom swipe actions to a row in a list.

Explore Other Components

Browse all
Prefer Vertical Toolbar Items - iOS on iPhone Duo - Landscape - Closed - Liquid Glass - Light Mode - Preview
modifier

Prefer Vertical Toolbar Items

A compression behavior that prioritizes keeping toolbar items visible over other elements, such as tabs. By default, tabs are prioritized.

NavigationSplitView - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

NavigationSplitView

Creates a two-column navigation split view.

NavigationControlGroupStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
style

NavigationControlGroupStyle

The navigation control group style

ShareLink - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

ShareLink

A view that controls a sharing presentation

Vertical Divider - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
style

Vertical Divider

A vertical visual element that can be used to separate other content

UIKit Text Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
type

UIKit Text Colors

The UIKit text colors that are also used in other components, such as the TextField

Content Unavailable Search Text - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
type

Content Unavailable Search Text

A pre-built placeholder for empty search results with search text

HelpLink - macOS - Flat Design - Light Mode - Preview
initializer

HelpLink

A button with a standard appearance that opens app-specific help documentation