data-display/DSListRow

DSListRow

data-display
since 0.1.0

Standard 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

PropTypeDefaultDescription
titlereqStringโ€”Row title.
subtitleString?nilSecondary text below the title.
leadingIconString?nilLeading SF Symbol.
trailingIconString?"chevron.right"Trailing SF Symbol. nil hides it.
badgeString?nilTrailing badge label.
action(() -> Void)?nilRow 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)
}