--- title: "List Components | Explore SwiftUI" description: "A container that presents rows of data arranged in a single column, optionally providing the ability to select one or more members" canonical_url: "https://exploreswiftui.com/library/list" meta: author: "Explore SwiftUI" "og:description": "A container that presents rows of data arranged in a single column, optionally providing the ability to select one or more members" "og:image": "https://exploreswiftui.com/_og/d/c_Default%2Ctitle_List%2BComponents%2Cdescription_Explore%2B32%2BSwiftUI%2Bcomponents%2Bvisually%2Cp_Ii9saWJyYXJ5L2xpc3Qi%2Cs_Phz4SolNkQRcU3kn.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "List Components | Explore SwiftUI" "twitter:description": "A container that presents rows of data arranged in a single column, optionally providing the ability to select one or more members" "twitter:image": "https://exploreswiftui.com/_og/d/c_Default%2Ctitle_List%2BComponents%2Cdescription_Explore%2B32%2BSwiftUI%2Bcomponents%2Bvisually%2Cp_Ii9saWJyYXJ5L2xpc3Qi%2Cs_Phz4SolNkQRcU3kn.png" "twitter:title": "List Components | Explore SwiftUI" --- > Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt) # **List Components** A container that presents rows of data arranged in a single column, optionally providing the ability to select one or more members. 32 components ![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. ![SidebarListStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/107/variants/283?v=1790073478842&r=2&w=412&q=75&f=webp) ### **SidebarListStyle** The list style that describes the behavior and appearance of a sidebar list. ![InsetGroupedListStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/106/variants/277?v=1790073478842&r=2&w=412&q=75&f=webp) ### **InsetGroupedListStyle** The list style that describes the behavior and appearance of an inset grouped list. ![InsetGroupedListStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/105/variants/305?v=1790073478842&r=2&w=412&q=75&f=webp) ### **InsetGroupedListStyle** The list style that describes the behavior and appearance of an inset grouped list. ![InsetListStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/104/variants/329?v=1790073478842&r=2&w=412&q=75&f=webp) ### **InsetListStyle** The list style that describes the behavior and appearance of an inset list. ![EllipticalListStyle - watchOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/103/variants/327?v=1790073478842&r=2&w=412&q=75&f=webp) ### **EllipticalListStyle** The list style that describes the behavior and appearance of an elliptical list. ![CarouselListStyle - watchOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/102/variants/328?v=1790073478842&r=2&w=412&q=75&f=webp) ### **CarouselListStyle** The carousel list style. ![BorderedListStyle - macOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/101/variants/308?v=1790073478842&r=2&w=412&q=75&f=webp) ### **BorderedListStyle** The list style that describes the behavior and appearance of a list with standard border. ![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. ![List Badge Prominence - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/124/variants/353?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Badge Prominence** Specifies the prominence of badges created by this view. ![List Badge - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/123/variants/349?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Badge** Generates a badge for the view from an integer value. ![List Row Background - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/121/variants/345?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Row Background** Places a custom background view behind a list row item. ![Hidden List Row Separator - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/120/variants/343?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Hidden List Row Separator** Sets the display mode to hidden for the separator associated with this specific row. ![Hidden List Section Separator - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/119/variants/293?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Hidden List Section Separator** Sets whether to hide the separator associated with a list section. ![List Section Separator Tint - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/118/variants/287?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Section Separator Tint** Sets the tint color associated with a section. ![List Row Separator Tint - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/117/variants/291?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Row Separator Tint** Sets the tint color associated with a row. ![List Item Tint - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/116/variants/285?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Item Tint** Sets a fixed tint color for content in a list. ![List Section Margins - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/115/variants/297?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Section Margins** Set the section margins for the specific edges. ![Compact List Section Spacing - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/114/variants/171?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Compact List Section Spacing** Compact spacing between sections ![Custom List Section Spacing - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/113/variants/94?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Custom List Section Spacing** Sets the spacing between adjacent sections in a List to a custom value. ![List Row Spacing - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/112/variants/31?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Row Spacing** Sets the vertical spacing between two adjacent rows in a List. ![Default Min List Header Height - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/111/variants/310?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Default Min List Header Height** The default minimum height of a header in a list. ![Default Min List Row Height - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/110/variants/312?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Default Min List Row Height** The default minimum height of rows in a list. ![List Row Insets - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/109/variants/281?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Row Insets** Applies an inset to the rows in a list. ![Increased Header Prominence - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/108/variants/331?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Increased Header Prominence** Sets the header prominence to increased for this view. ![List Background Prominence - macOS - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/122/variants/347?v=1790073478842&r=2&w=412&q=75&f=webp) ### **List Background Prominence** The prominence of the background underneath views associated with this environment. ```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#webpage","@type":"WebPage","description":"A container that presents rows of data arranged in a single column, optionally providing the ability to select one or more members","name":"List Components","url":"https://exploreswiftui.com/library/list","breadcrumb":{"@id":"https://exploreswiftui.com/library/list#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/list"]}],"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#collectionpage","@type":"CollectionPage","description":"A container that presents rows of data arranged in a single column, optionally providing the ability to select one or more members","inLanguage":"en-US","name":"List Components","url":"https://exploreswiftui.com/library/list","about":{"@type":"Thing","name":"SwiftUI"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"}},{"@id":"https://exploreswiftui.com/library/list#/schema/item-list/1","@type":"ItemList","name":"List Components","itemListElement":[{"@type":"ListItem","position":1,"name":"Outline Group","url":"https://exploreswiftui.com/library/list/outline-group"},{"@type":"ListItem","position":2,"name":"Disclosure Group","url":"https://exploreswiftui.com/library/list/disclosure-group"},{"@type":"ListItem","position":3,"name":"Edit Button","url":"https://exploreswiftui.com/library/list/edit-button"},{"@type":"ListItem","position":4,"name":"SidebarListStyle","url":"https://exploreswiftui.com/library/list/sidebarliststyle"},{"@type":"ListItem","position":5,"name":"InsetGroupedListStyle","url":"https://exploreswiftui.com/library/list/insetgroupedliststyle"},{"@type":"ListItem","position":6,"name":"InsetGroupedListStyle","url":"https://exploreswiftui.com/library/list/insetgroupedliststyle"},{"@type":"ListItem","position":7,"name":"InsetListStyle","url":"https://exploreswiftui.com/library/list/insetliststyle"},{"@type":"ListItem","position":8,"name":"EllipticalListStyle","url":"https://exploreswiftui.com/library/list/ellipticalliststyle"},{"@type":"ListItem","position":9,"name":"CarouselListStyle","url":"https://exploreswiftui.com/library/list/carouselliststyle"},{"@type":"ListItem","position":10,"name":"BorderedListStyle","url":"https://exploreswiftui.com/library/list/borderedliststyle"},{"@type":"ListItem","position":11,"name":"Section Index Label and Visibility","url":"https://exploreswiftui.com/library/list/section-index-label-and-visibility"},{"@type":"ListItem","position":12,"name":"Move Disabled","url":"https://exploreswiftui.com/library/list/move-disabled"},{"@type":"ListItem","position":13,"name":"Delete Disabled","url":"https://exploreswiftui.com/library/list/delete-disabled"},{"@type":"ListItem","position":14,"name":"Refreshable List","url":"https://exploreswiftui.com/library/list/refreshable-list"},{"@type":"ListItem","position":15,"name":"Swipe Action","url":"https://exploreswiftui.com/library/list/swipe-action"},{"@type":"ListItem","position":16,"name":"List Badge Prominence","url":"https://exploreswiftui.com/library/list/list-badge-prominence"},{"@type":"ListItem","position":17,"name":"List Badge","url":"https://exploreswiftui.com/library/list/list-badge"},{"@type":"ListItem","position":18,"name":"List Row Background","url":"https://exploreswiftui.com/library/list/list-row-background"},{"@type":"ListItem","position":19,"name":"Hidden List Row Separator","url":"https://exploreswiftui.com/library/list/hidden-list-row-separator"},{"@type":"ListItem","position":20,"name":"Hidden List Section Separator","url":"https://exploreswiftui.com/library/list/hidden-list-section-separator"},{"@type":"ListItem","position":21,"name":"List Section Separator Tint","url":"https://exploreswiftui.com/library/list/list-section-separator-tint"},{"@type":"ListItem","position":22,"name":"List Row Separator Tint","url":"https://exploreswiftui.com/library/list/list-row-separator-tint"},{"@type":"ListItem","position":23,"name":"List Item Tint","url":"https://exploreswiftui.com/library/list/list-item-tint"},{"@type":"ListItem","position":24,"name":"List Section Margins","url":"https://exploreswiftui.com/library/list/list-section-margins"},{"@type":"ListItem","position":25,"name":"Compact List Section Spacing","url":"https://exploreswiftui.com/library/list/compact-list-section-spacing"},{"@type":"ListItem","position":26,"name":"Custom List Section Spacing","url":"https://exploreswiftui.com/library/list/custom-list-section-spacing"},{"@type":"ListItem","position":27,"name":"List Row Spacing","url":"https://exploreswiftui.com/library/list/list-row-spacing"},{"@type":"ListItem","position":28,"name":"Default Min List Header Height","url":"https://exploreswiftui.com/library/list/default-min-list-header-height"},{"@type":"ListItem","position":29,"name":"Default Min List Row Height","url":"https://exploreswiftui.com/library/list/default-min-list-row-height"},{"@type":"ListItem","position":30,"name":"List Row Insets","url":"https://exploreswiftui.com/library/list/list-row-insets"},{"@type":"ListItem","position":31,"name":"Increased Header Prominence","url":"https://exploreswiftui.com/library/list/increased-header-prominence"},{"@type":"ListItem","position":32,"name":"List Background Prominence","url":"https://exploreswiftui.com/library/list/list-background-prominence"}]},{"@id":"https://exploreswiftui.com/library/list#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}]},{"@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"}]} ```