Workspace · Extended localized content for verification and layout resilience
Ready
VERIFICATION-0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
<forma-workspace-shell>
Composes navigation, primary work, contextual inspection, and status as explicit regions.
<forma-workspace-shell>patterns/workspace-shell.htmlA workspace shell is the outer frame of a working application screen. It places four explicit regions on a named CSS grid: a full-width landmark header (title and status), a navigation column, the primary work region, and an inspector for the current selection. Each region is a real landmark or sectioning element, so the structure is announced to assistive technology, not just drawn. Forma owns only the grid placement and the narrow-screen stacking; routing, selection, what the inspector shows and how status is updated belong to the application.
grid-template-areas, so each child names its area through its element class rather than relying on source position.min-inline-size: 0, so long content wraps or scrolls inside them instead of widening the page.The smallest correct markup: the canonical pattern from patterns/workspace-shell.html inside its public tag. Copy this first, then adapt labels, names and state. This component owns a page's main landmark, so it renders in its own document below.
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.
<forma-workspace-shell class="forma-component-tag">
<main class="forma-workspace-shell">
<header class="forma-workspace-shell__landmark"><h1>Workspace</h1><p role="status">Ready</p></header>
<nav class="forma-workspace-shell__navigation" aria-label="Workspace"><a href="#work" aria-current="page">Work</a><a href="#history">History</a></nav>
<section class="forma-workspace-shell__primary" id="work"><h2>Primary work</h2></section>
<aside class="forma-workspace-shell__inspector" aria-label="Inspector"><h2>Inspector</h2></aside>
</main>
</forma-workspace-shell>
Click or tap the code once to select all of it, then copy.
A support workspace with section navigation, the queue as primary work and the selected ticket's properties in the inspector. The landmark carries a live status line the application updates after saves.
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.
All changes saved
<forma-workspace-shell class="forma-component-tag">
<section class="forma-workspace-shell" aria-labelledby="workspace-shell-support-queue-title">
<header class="forma-workspace-shell__landmark">
<h2 id="workspace-shell-support-queue-title">Support desk</h2>
<p role="status">All changes saved</p>
</header>
<nav class="forma-workspace-shell__navigation" aria-label="Support sections">
<a href="#workspace-shell-support-queue-open" aria-current="page">Open tickets</a>
<a href="#workspace-shell-support-queue-waiting">Waiting on customer</a>
<a href="#workspace-shell-support-queue-closed">Closed</a>
</nav>
<section class="forma-workspace-shell__primary" id="workspace-shell-support-queue-open" aria-labelledby="workspace-shell-support-queue-open-title">
<h3 id="workspace-shell-support-queue-open-title">Open tickets</h3>
<ul>
<li><a href="#workspace-shell-support-queue-inspector" aria-current="true">SUP-2291 · Invoice PDF missing line items</a></li>
<li><a href="#workspace-shell-support-queue-inspector">SUP-2288 · SSO login loops back to sign-in</a></li>
<li><a href="#workspace-shell-support-queue-inspector">SUP-2280 · Export stuck at 90%</a></li>
</ul>
</section>
<aside class="forma-workspace-shell__inspector" id="workspace-shell-support-queue-inspector" aria-labelledby="workspace-shell-support-queue-inspector-title">
<h3 id="workspace-shell-support-queue-inspector-title">SUP-2291</h3>
<dl class="forma-key-value-list">
<div><dt>Customer</dt><dd>Northwind Logistics</dd></div>
<div><dt>Priority</dt><dd>High</dd></div>
<div><dt>Assignee</dt><dd>Priya Raman</dd></div>
</dl>
</aside>
</section>
</forma-workspace-shell>
Click or tap the code once to select all of it, then copy.
The inspector keeps its region and heading but explains that nothing is selected, instead of disappearing and shifting the layout. The status line reports an application-owned sync state as text.
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.
Syncing 3 changes…
12 drafts. Choose one to see its parties, value and renewal terms.
<forma-workspace-shell class="forma-component-tag">
<section class="forma-workspace-shell" aria-labelledby="workspace-shell-nothing-selected-title">
<header class="forma-workspace-shell__landmark">
<h2 id="workspace-shell-nothing-selected-title">Contracts</h2>
<p role="status">Syncing 3 changes…</p>
</header>
<nav class="forma-workspace-shell__navigation" aria-label="Contract views">
<a href="#workspace-shell-nothing-selected-drafts" aria-current="page">Drafts</a>
<a href="#workspace-shell-nothing-selected-review">In legal review</a>
<a href="#workspace-shell-nothing-selected-signed">Signed</a>
</nav>
<section class="forma-workspace-shell__primary" id="workspace-shell-nothing-selected-drafts" aria-labelledby="workspace-shell-nothing-selected-drafts-title">
<h3 id="workspace-shell-nothing-selected-drafts-title">Drafts</h3>
<p>12 drafts. Choose one to see its parties, value and renewal terms.</p>
</section>
<aside class="forma-workspace-shell__inspector" aria-labelledby="workspace-shell-nothing-selected-inspector-title">
<h3 id="workspace-shell-nothing-selected-inspector-title">Details</h3>
<p>No contract selected.</p>
</aside>
</section>
</forma-workspace-shell>
Click or tap the code once to select all of it, then copy.
Content stress: long localized navigation labels wrap inside the bounded navigation column, and a long unbroken reference wraps inside the inspector because both regions allow shrinking.
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.
Hors ligne · les modifications seront envoyées à la reconnexion
4 commandes attendent une validation budgétaire.
<forma-workspace-shell class="forma-component-tag">
<section class="forma-workspace-shell" aria-labelledby="workspace-shell-long-labels-title">
<header class="forma-workspace-shell__landmark">
<h2 id="workspace-shell-long-labels-title">Gestion des approvisionnements</h2>
<p role="status">Hors ligne · les modifications seront envoyées à la reconnexion</p>
</header>
<nav class="forma-workspace-shell__navigation" aria-label="Sections des approvisionnements">
<a href="#workspace-shell-long-labels-orders" aria-current="page">Commandes fournisseurs en attente de validation</a>
<a href="#workspace-shell-long-labels-receipts">Réceptions partielles à rapprocher</a>
</nav>
<section class="forma-workspace-shell__primary" id="workspace-shell-long-labels-orders" aria-labelledby="workspace-shell-long-labels-orders-title">
<h3 id="workspace-shell-long-labels-orders-title">Commandes en attente</h3>
<p>4 commandes attendent une validation budgétaire.</p>
</section>
<aside class="forma-workspace-shell__inspector" aria-labelledby="workspace-shell-long-labels-inspector-title">
<h3 id="workspace-shell-long-labels-inspector-title">Référence</h3>
<p style="overflow-wrap: anywhere">PO-2026-EMEA-LOGISTICS-00041872-REV3</p>
</aside>
</section>
</forma-workspace-shell>
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.
At phone width the four regions stack into one column in source order: status first, then navigation, then work, then the inspector.
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-workspace-shell class="forma-component-tag">
<section class="forma-workspace-shell" aria-labelledby="workspace-shell-mobile-title">
<header class="forma-workspace-shell__landmark">
<h2 id="workspace-shell-mobile-title">Field inspections</h2>
<p role="status">2 reports waiting to upload</p>
</header>
<nav class="forma-workspace-shell__navigation" aria-label="Inspection views">
<a href="#workspace-shell-mobile-today" aria-current="page">Today</a>
<a href="#workspace-shell-mobile-upcoming">Upcoming</a>
</nav>
<section class="forma-workspace-shell__primary" id="workspace-shell-mobile-today" aria-labelledby="workspace-shell-mobile-today-title">
<h3 id="workspace-shell-mobile-today-title">Today</h3>
<p>Pump station 4 · 10:30</p>
</section>
<aside class="forma-workspace-shell__inspector" aria-labelledby="workspace-shell-mobile-inspector-title">
<h3 id="workspace-shell-mobile-inspector-title">Site notes</h3>
<p>Gate code changes on Fridays. Call the site lead on arrival.</p>
</aside>
</section>
</forma-workspace-shell>
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 | nav, aside | string | — | Names the navigation and inspector landmarks so they are distinguishable from other navigation and complementary regions on the page. |
aria-labelledby | section, aside | id of the region heading | — | Alternative to aria-label when the region already has a visible heading. |
aria-current | navigation link | page | absent | Marks the current section. The application sets it when routing changes; the shell does not style it. |
role | status element in the landmark | status | — | Makes the workspace status a polite live region so saves, syncs and offline changes are announced. |
id | primary region | string | — | Target for navigation fragment links and skip links. |
| Hook | Kind | Values or default | Description |
|---|---|---|---|
.forma-workspace-shell | Block class | — | Root grid. In an application this is usually the page's main; any sectioning element works when the shell is nested. |
.forma-workspace-shell__inspector | Element class | — | Context region for the current selection. Also shrinkable. |
.forma-workspace-shell__landmark | Element class | — | Full-width header row for the workspace title and status. |
.forma-workspace-shell__navigation | Element class | — | Navigation column; lays its children out as a vertical grid with a small gap. |
.forma-workspace-shell__primary | Element class | — | Primary work region. Shrinks below its content width so long content does not widen the page. |
--forma-workspace-nav | Custom property | — | Navigation column track. Default minmax(10rem, 14rem). |
--forma-workspace-inspector | Custom property | — | Inspector column track. Default minmax(14rem, 20rem). |
--forma-workspace-space | Custom property | — | Gap between regions. Default the 1rem spacing token. |
| Keys | Result |
|---|---|
| Tab / Shift+Tab | Moves through links and controls in source order: landmark, navigation, primary, inspector. The shell adds no keyboard behavior. |
| Screen-reader landmark navigation | Navigation and inspector are exposed as named landmarks, so users can jump between them directly. |
Not a form control. Forms inside any region participate normally.
| State | How it is expressed | Presentation |
|---|---|---|
| Wide | viewport wider than 48rem | Three columns under a full-width landmark row: navigation, primary, inspector. |
| Stacked | @media (max-width: 48rem) | One column in landmark, navigation, primary, inspector order. |
| Current section | aria-current="page" on a navigation link | Application-owned. The shell does not add a visual treatment; use link styling or compose a navigation component if one is needed. |
| Status | text in the role="status" element | Application-owned text such as Saved, Syncing or Offline. Never color-only. |
nav for navigation and aside for the inspector, each with a unique accessible name.main for the shell only once per page; when the shell is nested inside another page, use a labelled section instead.var(--forma-workspace-nav) minmax(0, 1fr) var(--forma-workspace-inspector) under a full-width landmark row; the primary column absorbs remaining space.min-inline-size: 0; long unbroken strings still need overflow-wrap or a Bounded overflow region in the application's content.--forma-workspace-inspector to 0px (the column gap remains) or use Navigation shell instead.order or area changes that make visual order differ from focus order.main inside the shell.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.