Description lists

On this page

A description list shows the facts about one record as label and value pairs: a member's plan, a room's capacity, a booking's time. Labels sit in a column on the left, values on the right.

A description list in a cardA description list in a card

Figure 1: A description list with an avatar, an ID and plain values

<dl class="ph-dl">
  <dt>Member</dt>
  <dd><span class="ph-avatar ph-avatar--sm" aria-hidden="true">OB</span> Olivia Bennett</dd>
  <dt>Member ID</dt>
  <dd><code>mbr_8f2c41</code></dd>
  <dt>Plan</dt>
  <dd>Annual, renews 1 March</dd>
</dl>
ClassWhat it does
.ph-dlTwo columns: secondary-coloured labels and values. Below 480px, each label sits above its value.

Values can hold badges, status indicators, avatars, links and code.

React

InfoRow and OverviewCard from ph-app-kit-react show the same kind of facts in React.

Guidelines

  • Short labels in sentence case, no colons.
  • Show "—" or "Not set" for missing values rather than leaving a gap.
  • Put IDs people copy in code.