Diagnose
Prove what is wrong before changing it
Observations stay separate from explanations until evidence removes the alternatives.
<forma-card-grid>
Ruled grid of cards with a column cap and content-driven column dropping; card links stretch without making the whole card the accessible name.
<forma-card-grid>patterns/card-grid.htmlA card grid presents a set of parallel items (services, capabilities, products) as a list of article.forma-card elements separated by shared hairline rules. data-forma-columns caps the number of columns; the minimum card width (--forma-layout-card-min, 15rem) decides when a column drops, so the grid degrades to one column by content rather than by breakpoints. A card may contain one .forma-card__link in its title: the link stretches over the whole card for pointer and touch, while its accessible name stays the title text.
surface tone; data-forma-tone can set page, elevated (adds a raised shadow) or inverse.The smallest correct markup: the canonical pattern from patterns/card-grid.html inside its public tag. Copy this first, then adapt labels, names and state.
Rendered from the canonical pattern file.
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.
Diagnose
Observations stay separate from explanations until evidence removes the alternatives.
Constrain
Domain state and legal transitions are modeled instead of implied.
Accessibility, responsiveness, and meaning are checked as executable contracts.
<forma-card-grid class="forma-component-tag">
<div class="forma-site">
<ul class="forma-card-grid" data-forma-columns="3" aria-label="Capabilities">
<li>
<article class="forma-card">
<p class="forma-eyebrow">Diagnose</p>
<h3 class="forma-card__title"><a class="forma-card__link" href="#diagnose">Prove what is wrong before changing it</a></h3>
<p>Observations stay separate from explanations until evidence removes the alternatives.</p>
<p class="forma-card__footer">Outcome: a defensible root cause</p>
</article>
</li>
<li>
<article class="forma-card">
<p class="forma-eyebrow">Constrain</p>
<h3 class="forma-card__title">Make valid work explicit</h3>
<p>Domain state and legal transitions are modeled instead of implied.</p>
</article>
</li>
<li>
<article class="forma-card" data-forma-tone="inverse">
<h3 class="forma-card__title">Verify what people receive</h3>
<p>Accessibility, responsiveness, and meaning are checked as executable contracts.</p>
</article>
</li>
</ul>
</div>
</forma-card-grid>
Click or tap the code once to select all of it, then copy.
Two linked service cards with footers stating the outcome. Each whole card is a target, but each link's accessible name is only its title. data-forma-columns="2" stops the grid at two columns even on very wide screens.
Live demo. 2 native actions work here and are verified by an outcome test.
Diagnostic
A two-week engagement that separates observations from explanations.
Architecture
Domain state and legal transitions become explicit and testable.
<forma-card-grid class="forma-component-tag">
<div class="forma-site">
<ul class="forma-card-grid" data-forma-columns="2" aria-label="Services">
<li>
<article class="forma-card">
<p class="forma-eyebrow">Diagnostic</p>
<h3 class="forma-card__title"><a class="forma-card__link" href="#card-grid-linked-services-diagnostic">Find the cause of a recurring failure</a></h3>
<p>A two-week engagement that separates observations from explanations.</p>
<p class="forma-card__footer" id="card-grid-linked-services-diagnostic">Outcome: a defensible root cause</p>
</article>
</li>
<li>
<article class="forma-card">
<p class="forma-eyebrow">Architecture</p>
<h3 class="forma-card__title"><a class="forma-card__link" href="#card-grid-linked-services-architecture">Model the rules your system must keep</a></h3>
<p>Domain state and legal transitions become explicit and testable.</p>
<p class="forma-card__footer" id="card-grid-linked-services-architecture">Outcome: executable constraints</p>
</article>
</li>
</ul>
</div>
</forma-card-grid>
Click or tap the code once to select all of it, then copy.
Five short, unlinked product cards. data-forma-columns="5" also lowers the card minimum to 12rem so five columns fit on wide screens; they drop to fewer columns as the container narrows. One card uses the elevated tone and gains a raised shadow.
Domain state and legal transitions.
Interface behavior at the boundary.
Longitudinal quality evidence.
Operational monitoring.
Presentation and layout.
<forma-card-grid class="forma-component-tag">
<div class="forma-site">
<ul class="forma-card-grid" data-forma-columns="5" aria-label="Products">
<li><article class="forma-card"><h3 class="forma-card__title">Ordo</h3><p>Domain state and legal transitions.</p></article></li>
<li><article class="forma-card"><h3 class="forma-card__title">Limen</h3><p>Interface behavior at the boundary.</p></article></li>
<li><article class="forma-card"><h3 class="forma-card__title">Dokimos</h3><p>Longitudinal quality evidence.</p></article></li>
<li><article class="forma-card"><h3 class="forma-card__title">Vigila</h3><p>Operational monitoring.</p></article></li>
<li><article class="forma-card" data-forma-tone="elevated"><h3 class="forma-card__title">Forma</h3><p>Presentation and layout.</p></article></li>
</ul>
</div>
</forma-card-grid>
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.
Three capability cards at phone width, one linked and one on the inverse tone. The grid collapses to a single column and each card spans the full width.
Live demo. 1 native action works here and is verified by an outcome test.
data-forma-columns says.<forma-card-grid class="forma-component-tag">
<div class="forma-site">
<ul class="forma-card-grid" data-forma-columns="3" aria-label="Capabilities">
<li><article class="forma-card"><p class="forma-eyebrow">Diagnose</p><h3 class="forma-card__title"><a class="forma-card__link" href="#card-grid-mobile-single-column-verify">Prove what is wrong before changing it</a></h3><p>Evidence removes the alternatives.</p></article></li>
<li><article class="forma-card"><p class="forma-eyebrow">Constrain</p><h3 class="forma-card__title">Make valid work explicit</h3><p>Legal transitions are modeled, not implied.</p></article></li>
<li><article class="forma-card" data-forma-tone="inverse" id="card-grid-mobile-single-column-verify"><h3 class="forma-card__title">Verify what people receive</h3><p>Accessibility and meaning are executable contracts.</p></article></li>
</ul>
</div>
</forma-card-grid>
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.
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 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 |
|---|---|---|---|---|
aria-label | ul.forma-card-grid | string | — | Names the list when no visible heading introduces it. |
href | a.forma-card__link | URL | — | Destination of the card. Use at most one card link per card. |
| Hook | Kind | Values or default | Description |
|---|---|---|---|
.forma-card-grid | Block class | — | Unstyled list laid out as an auto-fit grid. Draws the top and inline-start rules; each card draws its end and bottom rules. |
[data-forma-columns] | Attribute hook | "2", "3", "4", "5" | Column cap on the grid: 2, 3, 4 or 5. Without it the cap is 12. 5 also lowers the card minimum to 12rem. The minimum card width still decides when columns drop. |
.forma-card | Block class | — | Card article. Positioned so a card link can stretch over it; defaults to the surface tone and a full border when standalone. |
.forma-card__footer | Element class | — | Closing line (outcome, meta) separated by a strong rule. |
.forma-card__link | Element class | — | Link inside the title. Its ::after pseudo-element covers the card to enlarge the target; the focus ring is drawn on the card. |
.forma-card__title | Element class | — | Card title at the h3 role size in the body face, whatever its heading level. Capped at 24ch. |
[data-forma-tone] | Attribute hook | "elevated" | Tone of a card: surface (default), page, elevated (adds a raised shadow) or inverse. |
--forma-card-rule | Custom property | default var(--forma-tone-rule) | Color of the grid's shared hairline rules. Default the tone's rule color. |
--forma-card-columns | Custom property | — | Column cap computed from data-forma-columns (default 12). Prefer the attribute over setting this directly. |
| Keys | Result |
|---|---|
| Tab / Shift+Tab | Moves between card links; unlinked cards are not focusable. |
| Enter | Follows the focused card link (native link behavior). |
| State | How it is expressed | Presentation |
|---|---|---|
| Static card | no .forma-card__link | Not interactive; no hover or focus treatment. |
| Linked card hover | :has(.forma-card__link:hover) | The card background changes to the tone's hover surface and the title underlines. |
| Linked card focus | :has(.forma-card__link:focus-visible) | The focus outline and halo are drawn inside the card edge instead of around the title. |
| Elevated | data-forma-tone="elevated" | Elevated surface with a raised shadow. |
| Inverse | data-forma-tone="inverse" | Inverse surface; text, labels and rules switch to inverse tone colors. |
article cards with real headings at the level the outline needs.aria-label or a preceding heading.minmax(min(100%, max(--forma-layout-card-min, 100% / columns)), 1fr): the cap limits columns and the 15rem minimum (12rem for five columns) drops them.min-inline-size: 0 and titles wrap within 24ch, so long words and titles do not overflow.data-forma-columns to match the number of items (2 for two, 3 for three or six).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.