Description list
Pairs of a label and its value, lined up as a table lines up its columns. Details start after their labels, amounts line up on the end edge over a total, and in a narrow column each value goes under its label.
Examples
- Status
- Paid
- Billing email
- accounts@kinoui.com
- Payment method
- Visa ending 4242, charged Nov 15
- Payment ID
- pi_3QkX9v2eZvKYlo2C1nJ8Hq7TCopy payment ID
Actions
Values start on one line after the labels. DescriptionListAction holds buttons at the row’s end, such as Copy or Edit, and DescriptionListValue keeps the value’s text together beside them. An xs button never makes its row taller.
- Size
- 18.4 MB
- Type
- Figma file
- Uploaded by
- MCMaya Chen
- Last opened
- Never
- Folder
- Kino / Design / Checkout / 2026 / Q4 / Final handoff / ApprovedCopy folder path
- SHA-256
- 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08Copy checksum
Long values
A long ID breaks onto the next line. truncate on the value cuts it to one line instead, with Copy for the whole.
- Kino Team, 7 seats, billed monthly from Nov 15
- $84.00
- Unused time on Kino Starter, Nov 15 to Nov 21
- −$9.50
- VAT (20%)
- $14.90
- Total
- $89.40
Total
align="end" lines amounts up on the end edge, as a receipt does, and variant="total" puts the sum under a line. A long label wraps beside its amount.
- Plan
- Kino Team
- Seats
- 7 of 10
- Seats × $12
- $84.00
- VAT (20%)
- $16.80
- Due on Dec 15
- $100.80
Values that change
Numbers line up as they change, and an Animated number rolls each one to its new value.
Installation
npx shadcn@latest add https://kinoui.com/r/description-list.json- Files
lib/reduce-motion.tscomponents/kino/description-list.tsx- Packages
class-variance-authority- Global CSS
- the feels, the density tokens, the shape tokens and the success and warning colours
New to Kino? Installation covers what your project needs first and the @kino namespace.
API reference
DescriptionList
DescriptionListItem
Data attributes
Accessibility
- It’s a
<dl>, each pair a<dt>and a<dd>in a<div>, which screen readers read as a term and its description. - Name an action by what it acts on, such as “Copy payment ID”, since the buttons in a list sit beside many values.
- A value cut to one line is still read whole by a screen reader. Give sighted users a way to the whole value too, such as Copy or a
title. - A button that turns disabled under the keyboard’s focus, such as a stepper at its limit, takes
focusableWhenDisabled, so focus stays on it. - When values change because of an action on the page, say what changed in a status region, as the seats example does.