--- title: "List Background Prominence | Explore SwiftUI" description: "The prominence of the background underneath views associated with this environment" canonical_url: "https://exploreswiftui.com/library/list/list-background-prominence" meta: author: "Explore SwiftUI" "og:description": "The prominence of the background underneath views associated with this environment" "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_List%2BBackground%2BProminence%2Cdescription_The%2Bprominence%2Bof%2Bthe%2Bbackground%2Bunderneath%2Bviews%2Bassociated%2Bwith%2Bthis%2Benvironment.%2Ccategory_List%2Cimage_~L2FwaS9pbWFnZXMvMTIyL3ZhcmlhbnRzLzM0Nz92PTE3OTAwNzM0Nzg4NDImcj0yJnc9NjQwJmg9NDgwJmY9cG5n%2CimageMode_fit%2CimagePosition_center%2CimageFrame_~ZmlsdGVyOiBkcm9wLXNoYWRvdygwIDAgMXB4IHJnYmEoMCwwLDAsMC4wNikpIGRyb3Atc2hhZG93KDAgLTEwcHggMjVweCByZ2JhKDM3LDk5LDIzNSwwLjE4KSk7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2xpc3QvbGlzdC1iYWNrZ3JvdW5kLXByb21pbmVuY2Ui%2Cs_nVyd6KKVbi7zlr03.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "List Background Prominence | Explore SwiftUI" "twitter:description": "The prominence of the background underneath views associated with this environment" "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_List%2BBackground%2BProminence%2Cdescription_The%2Bprominence%2Bof%2Bthe%2Bbackground%2Bunderneath%2Bviews%2Bassociated%2Bwith%2Bthis%2Benvironment.%2Ccategory_List%2Cimage_~L2FwaS9pbWFnZXMvMTIyL3ZhcmlhbnRzLzM0Nz92PTE3OTAwNzM0Nzg4NDImcj0yJnc9NjQwJmg9NDgwJmY9cG5n%2CimageMode_fit%2CimagePosition_center%2CimageFrame_~ZmlsdGVyOiBkcm9wLXNoYWRvdygwIDAgMXB4IHJnYmEoMCwwLDAsMC4wNikpIGRyb3Atc2hhZG93KDAgLTEwcHggMjVweCByZ2JhKDM3LDk5LDIzNSwwLjE4KSk7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwibWFjT1MiLCJ3YXRjaE9TIiwidHZPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2xpc3QvbGlzdC1iYWNrZ3JvdW5kLXByb21pbmVuY2Ui%2Cs_nVyd6KKVbi7zlr03.png" "twitter:title": "List Background Prominence | Explore SwiftUI" --- > Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt) # **List Background Prominence** The prominence of the background underneath views associated with this environment. ![List Background Prominence - Preview Not Available](https://exploreswiftui.com/api/images/122/variants/347?v=1790073478842&r=2&w=800&q=80&f=webp) ### **Platform Compatibility** iOS 17.0+ iPadOS 17.0+ macOS 14.0+ watchOS 10.0+ tvOS 17.0+ visionOS 1.0+ ### **Tags** ### **SwiftUI Code** [ Docs](https://developer.apple.com/documentation/swiftui/environmentvalues/backgroundprominence) ``` @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](https://exploreswiftui.com/_ipx/f_webp&q_80&s_48x48/images/connect-wizard-icon.png) **Connect Wizard** **Unlock insights App Store Connect doesn’t show you.** [** Get Started **](https://apps.apple.com/app/apple-store/id6747314580?pt=121213751&ct=Explore%20SwiftUI%20Banner&mt=8) ### **More List Components ** [**View all **](https://exploreswiftui.com/library/list) ![Outline Group - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/132/variants/371?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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](https://exploreswiftui.com/api/images/131/variants/363?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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](https://exploreswiftui.com/api/images/130/variants/367?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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](https://exploreswiftui.com/api/images/129/variants/369?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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](https://exploreswiftui.com/api/images/128/variants/361?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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](https://exploreswiftui.com/api/images/127/variants/351?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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](https://exploreswiftui.com/api/images/126/variants/359?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Refreshable List** Marks this view as refreshable. ![Swipe Action - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/125/variants/357?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Swipe Action** Adds custom swipe actions to a row in a list. ### **Explore Other Components ** [**Browse all **](https://exploreswiftui.com/) ![Picker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/174/variants/609?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Picker** Creates a pickers with title, image, systemImage, and custom label. ![Future DatePicker - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/68/variants/18?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Future DatePicker** Creates an instance that selects multiple dates on or after some start date ![WheelPickerStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/186/variants/604?v=1790073478842&r=2&w=412&q=75&f=webp) ### **WheelPickerStyle** A picker style that presents the options in a scrollable wheel that shows the selected option and a few neighboring options. ![Picker Section - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/178/variants/544?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Picker Section** A Section inside a Picker ![Nested Menu - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/21/variants/151?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Nested Menu** A Menu inside a Menu ![Picker Divider - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/177/variants/540?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Picker Divider** A Picker with a Divider ![Content Unavailable - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/4/variants/37?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Content Unavailable** A placeholder for empty results with optional button ![Default Collapsed Tab Section - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/234/variants/341?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Default Collapsed Tab Section** Sets the default expansion state for the section containing this tab to collapsed when displayed in the sidebar. ```json {"@context":"https://schema.org","@graph":[{"@id":"https://exploreswiftui.com/#website","@type":"WebSite","description":"A visual library for SwiftUI APIs, components, and modifiers","inLanguage":"en-US","name":"Explore SwiftUI","url":"https://exploreswiftui.com/","publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/list/list-background-prominence#webpage","@type":"WebPage","dateModified":"2025-08-10T16:41:50.476Z","datePublished":"2025-08-10T16:41:50.476Z","description":"The prominence of the background underneath views associated with this environment","name":"List Background Prominence","url":"https://exploreswiftui.com/library/list/list-background-prominence","breadcrumb":{"@id":"https://exploreswiftui.com/library/list/list-background-prominence#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/list/list-background-prominence"]}],"primaryImageOfPage":{"@id":"https://exploreswiftui.com/#logo"}},{"@id":"https://exploreswiftui.com/#identity","@type":"Organization","description":"A visual library for SwiftUI APIs, components, and modifiers","name":"Explore SwiftUI","url":"https://exploreswiftui.com","logo":{"@id":"https://exploreswiftui.com/#logo"},"sameAs":["https://x.com/Typ0genius","https://mastodon.social/@Typ0genius"]},{"@id":"https://exploreswiftui.com/library/list/list-background-prominence#article","dateModified":"2025-08-10T16:41:50.476Z","datePublished":"2025-08-10T16:41:50.476Z","description":"The prominence of the background underneath views associated with this environment","headline":"List Background Prominence","inLanguage":"en-US","name":"List Background Prominence","thumbnailUrl":"https://exploreswiftui.com/api/images/122/variants/347?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/list/list-background-prominence","@type":["Article","TechArticle"],"about":{"@type":"Thing","name":"SwiftUI"},"author":{"@id":"https://exploreswiftui.com/#identity"},"image":{"@id":"https://exploreswiftui.com/#/schema/image/1"},"isPartOf":{"@type":"WebSite","name":"Explore SwiftUI","url":"https://exploreswiftui.com"},"mainEntityOfPage":{"@id":"https://exploreswiftui.com/library/list/list-background-prominence#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/list/list-background-prominence#/schema/software-source-code/1","@type":"SoftwareSourceCode","codeRepository":"https://developer.apple.com/documentation/swiftui/environmentvalues/backgroundprominence","codeSampleType":"full example","description":"The prominence of the background underneath views associated with this environment","name":"List Background Prominence SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"@State var selectedEntry: String? = \"Foo\"\nlet entries = [\"Foo\", \"Bar\"]\n\nprivate struct EntryItem: View {\n let text: String\n\n var body: some View {\n VStack(alignment: .leading) {\n HStack {\n EntryItemChild(text: text)\n }\n }\n }\n}\n\nprivate struct EntryItemChild: View {\n let text: String\n\n @Environment(\\.backgroundProminence) private var backgroundProminence\n\n var body: some View {\n if backgroundProminence == .increased {\n Text(text)\n .bold()\n .italic()\n } else {\n Text(text)\n .foregroundStyle(Color.accentColor)\n }\n }\n}\n\nvar body: some View {\n VStack {\n List(entries, id: \\.self, selection: $selectedEntry) { entry in\n EntryItem(text: entry)\n }\n}","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"List"},{"@type":"Thing","name":"List Background Prominence"}]},{"@id":"https://exploreswiftui.com/library/list/list-background-prominence#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"List","item":"https://exploreswiftui.com/library/list","position":2},{"@type":"ListItem","name":"List Background Prominence","item":"https://exploreswiftui.com/library/list/list-background-prominence","position":3}]},{"@id":"https://exploreswiftui.com/#logo","@type":"ImageObject","caption":"Explore SwiftUI","contentUrl":"https://exploreswiftui.com/apple-touch-icon.png","inLanguage":"en","url":"https://exploreswiftui.com/apple-touch-icon.png"},{"@id":"https://exploreswiftui.com/#/schema/image/1","@type":"ImageObject","contentUrl":"https://exploreswiftui.com/api/images/122/variants/347?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/122/variants/347?v=1790073478842&r=2"}]} ```