data-display/DSListRow
DSListRow
data-displayStandard list row with leading icon, title, optional subtitle, badge, and a trailing action.
iOS 17+macOS 14+watchOS 10+tvOS 17+visionOS 1+
Purpose
Settings rows, navigation links, and entity lists.
Interactive Reference
Live showroom
Need the full visual surface?
Screenshots do not scale well across every component, state, and variant. For the real interactive reference, import the package and launch DSShowcaseRoot().
Best for exploring:
variants, states, categories, and real app examples in one place.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| titlereq | String | โ | Row title. |
| subtitle | String? | nil | Secondary text below the title. |
| leadingIcon | String? | nil | Leading SF Symbol. |
| trailingIcon | String? | "chevron.right" | Trailing SF Symbol. nil hides it. |
| badge | String? | nil | Trailing badge label. |
| action | (() -> Void)? | nil | Row tap action. |
Examples
Settings list
Typical settings section.
swift
DSListRow(title: "Notifications", leadingIcon: "bell.fill", badge: "3") {
navigate(.notifications)
}
DSListRow(title: "Privacy & Security", subtitle: "Face ID, passcode", leadingIcon: "lock.fill") {
navigate(.privacy)
}