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.

Props

PropTypeDefaultDescription
iconString?nilLeading SF Symbol.
iconColorColorDSColor.primaryIcon background colour.
titlereqStringโ€”Row title.
subtitleString?nilSecondary text below the title.
badgeString?nilTrailing badge label.
action(() -> Void)?nilRow 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)
}

Related Components