- Account · Extended localized content for verification and layout resilience
- Northwind Logistics
- Plan
- Team, billed annually
- Renewal
VERIFICATION-0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
<forma-key-value-list>
Description-list presentation of labelled values that stacks label above value on narrow screens.
<forma-key-value-list>patterns/key-value-list.htmlA key-value list shows the facts about one object as label/value pairs. It is a native dl whose dt/dd pairs are grouped in div rows; Forma lays each row out as a two-column grid with a ruled separator and stacks the label above the value at phone width. The list is static content: the application supplies the labels, the values and how missing values are worded.
minmax(7rem, 0.35fr); the value column takes the remaining width and can shrink to zero, so long values wrap instead of overflowing.The smallest correct markup: the canonical pattern from patterns/key-value-list.html inside its public tag. Copy this first, then adapt labels, names and state.
Rendered from the canonical pattern file.
<forma-key-value-list class="forma-component-tag">
<dl class="forma-key-value-list">
<div><dt>Account</dt><dd>Northwind Logistics</dd></div>
<div><dt>Plan</dt><dd>Team, billed annually</dd></div>
<div><dt>Renewal</dt><dd><time datetime="2027-03-01">1 March 2027</time></dd></div>
</dl>
</forma-key-value-list>
Click or tap the code once to select all of it, then copy.
A deployment's properties. Values mix plain text, an Identifier & critical value, a link, a machine-readable time and a Status lozenge; the list itself stays a plain description list.
Static specimen. Its links point to placeholder destinations that do not exist on this site. Its controls are shown for their markup and appearance and cannot be operated here.
<forma-key-value-list class="forma-component-tag">
<section aria-labelledby="key-value-list-record-details-title">
<h3 id="key-value-list-record-details-title">Deployment details</h3>
<dl class="forma-key-value-list">
<div><dt>Release</dt><dd><span class="forma-identifier">rel-2026.09.29-3f8c21</span></dd></div>
<div><dt>Environment</dt><dd>Production, EU West</dd></div>
<div><dt>Status</dt><dd><span class="forma-status-lozenge" data-state="ok">Healthy</span></dd></div>
<div><dt>Started</dt><dd><time datetime="2026-09-29T07:42:00Z">29 Sep 2026, 07:42 UTC</time></dd></div>
<div><dt>Owner</dt><dd><a href="#key-value-list-record-details-owner">Platform team</a></dd></div>
</dl>
</section>
</forma-key-value-list>
Click or tap the code once to select all of it, then copy.
German labels (marked with lang="de") that are longer than the 7rem minimum label column wrap within it, and values that are not set are written out rather than left blank so an empty dd is never mistaken for a loading value.
<forma-key-value-list class="forma-component-tag">
<dl class="forma-key-value-list" lang="de">
<div><dt>Verantwortliche Abteilung für Rechnungsprüfung</dt><dd>Finanzbuchhaltung Mitteleuropa</dd></div>
<div><dt>Kostenstelle</dt><dd>Nicht festgelegt</dd></div>
<div><dt>Umsatzsteuer-Identifikationsnummer</dt><dd><span class="forma-identifier">DE 812 345 678</span></dd></div>
<div><dt>Letzte Prüfung</dt><dd>Unbekannt: Prüfprotokoll nicht verfügbar</dd></div>
</dl>
</forma-key-value-list>
Click or tap the code once to select all of it, then copy.
Each mobile example renders in its own document inside a real narrow viewport, so Forma's media and container queries run exactly as they would on a phone. Choose a width to compare.
An account summary at phone width. Each row stacks its label above its value so neither is squeezed into a narrow column.
Static specimen. Its links point to placeholder destinations that do not exist on this site. Its controls are shown for their markup and appearance and cannot be operated here.
grid-template-columns: 1fr with a 0.25rem gap: the label sits directly above its value.<forma-key-value-list class="forma-component-tag">
<dl class="forma-key-value-list">
<div><dt>Account</dt><dd>Northwind Logistics International</dd></div>
<div><dt>Plan</dt><dd>Business, billed monthly</dd></div>
<div><dt>Seats</dt><dd>48 of 50 in use</dd></div>
<div><dt>Billing contact</dt><dd><a href="#key-value-list-mobile-account-summary-contact">accounts-payable@northwind.example</a></dd></div>
</dl>
</forma-key-value-list>
Click or tap the code once to select all of it, then copy.
The canonical pattern in a true 320px viewport, the minimum width every Forma component must support without page-level horizontal scrolling.
Forma components have no JavaScript API. Their public contract is the markup: native elements and attributes you write, and the CSS hooks below. The CSS hook table is generated from the built stylesheet, so it always matches the shipped implementation.
| Attribute | On | Values | Default | Description |
|---|---|---|---|---|
datetime | time | ISO date or date-time | — | Machine-readable form of a date value; the visible text stays human-formatted. |
aria-labelledby | wrapping section | id of a heading | — | Names the section that contains the list when the list has a visible heading. |
| Hook | Kind | Values or default | Description |
|---|---|---|---|
.forma-key-value-list | Block class | — | The native dl. Each direct div child is a label/value row laid out as a two-column grid with a subtle bottom rule. |
| Keys | Result |
|---|---|
| Tab | Only interactive content inside values (links, buttons) is focusable; the list itself is not. |
Not a form control. Display values only; editable fields need real form controls.
| State | How it is expressed | Presentation |
|---|---|---|
| Two-column rows | viewport > 30rem | Label column minmax(7rem, 0.35fr) beside a flexible value column. |
| Stacked rows | viewport ≤ 30rem | Label above value in a single column. |
| Missing or unknown value | application text in the dd | Written as words (Not set, Unknown); Forma adds no special styling. |
minmax(0, 1fr)), so long values wrap instead of creating horizontal scrolling.dt/dd pair in a div directly inside the dl; that div is the styled row.minmax(7rem, 0.35fr) minmax(0, 1fr) with a 1rem gap.dd keeps the browser's default inline-start margin, so values are indented by the user agent's default at every width.dd empty to mean unknown or none.dd; split them into rows.Generated fault-injection specimens expose content, spacing, color-cue, and reduced-effective-contrast risks. They screen presentation robustness as engineering screens without claiming human-subject validation.