Component
List Row
One row in a grouped list: documents, topics, settings. The accessory on the right says what tapping does.
Variant State Rendered at 1pt = 1px on a 393pt iPhone canvas. Tap to feel the pressed state.
What & when
Use it for
- Navigation: opens a detail (chevron).
- Value: shows a current setting (value + chevron).
- Toggle: turns something on or off instantly.
- Check: selects items, e.g. topics for a quiz.
- Link: opens a web page outside the app (Privacy Policy, Terms) — an arrow instead of a chevron.
- Loading: a spinner replaces the accessory while work happens in place, e.g. finding topics in a new document.
Don’t use it for
- Subjects and folders — use the Subject Card, colour helps scanning.
- Quiz answers — use the Answer Row.
Anatomy & specs
All values in pt. Click a value to copy.
- Min. height
- Horizontal padding
- Icon–text gap
- Icon tile
- Icon size
- Checkbox
- Switch width
- Switch height
- Disabled opacity
- Corner radius (radius-lg)
- Corner radius (radius-sm)
- Corner radius (radius-pill)
Tokens
Every colour and text style comes from the Brand Kit.
- surface
- separator
- surface-muted
- label
- label-secondary
- label-tertiary
- primary
- on-primary
- primary-soft
- primary-text
- Body
- 17/24pt · 500
- Subheadline
- 15/20pt · 500
Accessibility
Dynamic Type, VoiceOver & contrast
- The whole row is the tap target, never just the accessory.
- Toggle rows use the switch trait; check rows use .isSelected; link rows use the .link trait.
- Loading rows announce their subtitle (“Finding topics”) and can’t be tapped until done.
- At large text sizes the subtitle moves under the title and the row grows.