List Background Prominence
The prominence of the background underneath views associated with this environment.
Platform Compatibility
Tags
SwiftUI Code
@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?
More List Components
View allOutline Group
A structure that computes views and disclosure groups on demand from an underlying collection of tree-structured, identified data.
Disclosure Group
A view that shows or hides another content view, based on the state of a disclosure control.
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.
Explore Other Components
Browse allToolbar 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
A view that adapts to the available vertical space by providing the first child view that fits.
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
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
The UIKit separator colors that are also used in other components, such as the TextField