List Background Prominence

The prominence of the background underneath views associated with this environment.

List Background Prominence - Preview Not Available

Platform Compatibility

iOS 17.0+ iPadOS 17.0+ macOS 14.0+ watchOS 10.0+ tvOS 17.0+ visionOS 1.0+

Tags

SwiftUI Code

Docs
@State var selectedEntry: String? = "Foo"
let entries = ["Foo", "Bar"]

private struct EntryItem: View {
  let text: String

  var body: some View {
    VStack(alignment: .leading) {
      HStack {
        EntryItemChild(text: text)
      }
    }
  }
}

private struct EntryItemChild: View {
  let text: String

  @Environment(\.backgroundProminence) private var backgroundProminence

  var body: some View {
    if backgroundProminence == .increased {
      Text(text)
        .bold()
        .italic()
    } else {
      Text(text)
        .foregroundStyle(Color.accentColor)
    }
  }
}

var body: some View {
  VStack {
    List(entries, id: \.self, selection: $selectedEntry) { entry in
    EntryItem(text: entry)
  }
}

Found an issue or have a suggestion?

Created: August 10, 2025Updated: August 10, 2025
Connect Wizard

Connect Wizard

Unlock insights App Store Connect doesn’t show you.

Get Started

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
Toolbar Overflow Menu - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

Toolbar Overflow Menu

The overflow menu of a toolbar. An overflow menu represents actions that are always placed in the toolbar’s overflow menu, regardless of the toolbar mode, platform, or customizability.

ViewThatFits Vertical - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
initializer

ViewThatFits Vertical

A view that adapts to the available vertical space by providing the first child view that fits.

DatePicker Components  - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

DatePicker Components

A date picker with only one displayed component

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

TabsPickerStyle

A picker style that presents options as segmented tabs. On macOS, this style produces a segmented picker with a visual treatment that distinguishes tab navigation from value selection. On iOS, tvOS, and visionOS, the visual appearance matches that of the standard standard .segmented style. On all supported platforms, VoiceOver announces options as tabs.

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

PalettePickerStyle

A picker style that presents the options as a row of compact elements. When used outside of menus, this style is rendered as a segmented picker. If that is the intended usage, consider segmented instead.

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

UIKit Separator Colors

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

Color Gradient - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Color Gradient

The Color gradient modifier

Picker Section - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
content

Picker Section

A Section inside a Picker