In its simplest form, a List creates its contents statically, as shown in the following example:
var body: someView {List {Text("A List Item")Text("A Second List Item")Text("A Third List Item") }}
More commonly, you create lists dynamically from an underlying collection of data. The following example shows how to create a simple list from an array of an Ocean type which conforms to Identifiable:
To make members of a list selectable, provide a binding to a selection variable. Binding to a single instance of the list data’s Identifiable.ID type creates a single-selection list. Binding to a Set creates a list that supports multiple selections. The following example shows how to add multi-select to the previous example. A Text view below the list shows the number of items currently selected.
On iOS and tvOS, you must explicitly put the list into edit mode to enable selections. To do that, either add an EditButton to your user interface, or modify the editMode value directly. The example above uses an Edit button, which changes its title to Done while in edit mode:
Refreshing the List Content
To make the content of the list refreshable using the standard refresh control, use the refreshable(action:) modifier.
The following example shows how to add a standard refresh control to a list. When the user drags the top of the list downward, SwiftUI reveals the refresh control and executes the specified action. Use an await expression inside the action closure to refresh your data. The refresh indicator remains visible for the duration of the awaited operation.
To support two-dimensional lists, your list’s content can create instances of the Section type, which then provide their own contents.
The following example creates sections named after the world’s oceans, each of which has Text children named for major seas attached to those oceans. The example also allows for selection of a single list item, identified by the id of the example’s Sea type.
You can also create a hierarchical list of arbitrary depth by providing tree-structured data and a children parameter that provides a key path to get the child nodes at any level. The following example uses a deeply-nested collection of a custom FileItem type to simulate the contents of a file system. The list created from this data uses collapsing cells to allow the user to navigate the tree structure.
SwiftUI chooses a display style for a list based on the platform and the view type in which it appears. Use the listStyle(_:) modifier to apply a different ListStyle to all lists within a view. For example, adding .listStyle(.insetGrouped) to the example shown in the “Creating Multi-Dimensional Lists” topic applies the insetGrouped style, as seen in the following screenshot.
Creates a list that identifies its rows based on a key path to the identifier of the underlying data.
あるリストを作成します、それは、それの行それらを、基礎をなすデータの識別子へのあるキーパスに基づいて識別するものです。
Available when SelectionValue is Never and Content conforms to View.
Creates a list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select a single row.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select multiple rows.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a list that computes its rows on demand from an underlying collection of identifiable data.
あるリストを作成します、それはそれの行それらを、身元識別可能データからなるある基礎をなすコレクションから請求に応じて計算するものです。
Available when SelectionValue is Never and Content conforms to View.
Creates a list that identifies its rows based on a key path to the identifier of the underlying data.
あるリストを作成します、それは、それの行それらを、基礎をなすデータの識別子へのあるキーパスに基づいて識別するものです。
Available when SelectionValue is Never and Content conforms to View.
Creates a list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select a single row.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select multiple rows.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a list that computes its rows on demand from an underlying collection of identifiable data.
あるリストを作成します、それはそれの行それらを、身元識別可能データからなるある基礎をなすコレクションから請求に応じて計算するものです。
Available when SelectionValue is Never and Content conforms to View.
Creates a hierarchical list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select a single row.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a hierarchical list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select multiple rows.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a hierarchical list that computes its rows on demand from an underlying collection of identifiable data, optionally allowing users to select a single row.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a hierarchical list that computes its rows on demand from an underlying collection of identifiable data, optionally allowing users to select multiple rows.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a hierarchical list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select a single row.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a hierarchical list that identifies its rows based on a key path to the identifier of the underlying data, optionally allowing users to select multiple rows.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a hierarchical list that computes its rows on demand from a binding to an underlying collection of identifiable data, optionally allowing users to select a single row.
Available when SelectionValue conforms to Hashable and Content conforms to View.
Creates a hierarchical list that computes its rows on demand from a binding to an underlying collection of identifiable data, optionally allowing users to select multiple rows.
Available when SelectionValue conforms to Hashable and Content conforms to View.
