data-display/DSListRow

DSListRow

data-display

since v1.0

Standard list row with leading icon, title, optional subtitle, badge, and a trailing action.

iOS 17+macOS 14+

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
icon	String?	nil	Leading SF Symbol.
iconColor	Color	DSColor.primary	Icon background colour.
titlereq	String	—	Row title.
subtitle	String?	nil	Secondary text below the title.
badge	String?	nil	Trailing badge label.
action	(() -> Void)?	nil	Row tap action.

Examples

Settings list

Typical iOS settings section.

swift

DSListRow(icon: "bell.fill", iconColor: DSColor.primary, title: "Notifications", badge: "3") {
    navigate(.notifications)
}
DSListRow(icon: "lock.fill", iconColor: DSColor.secondary, title: "Privacy & Security") {
    navigate(.privacy)
}