VERIFICATION-0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
No results match these filters · Extended localized content for verification and layout resilience
Clear one or more filters or broaden the search to see records.
<forma-empty-state>
Explains an empty result and offers a useful recovery action without treating absence as failure.
<forma-empty-state>patterns/empty-state.htmlAn empty state fills the space where a list, table or search result would be when there is nothing to show, and tells the user why and what to do next. Forma renders a centered, dashed-border section with a decorative symbol, a heading, supporting text and actions. The application decides that the result is truly empty (not loading, not failed, not unknown) and supplies the explanation and actions.
The smallest correct markup: the canonical pattern from patterns/empty-state.html inside its public tag. Copy this first, then adapt labels, names and state.
Rendered from the canonical pattern file.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
Clear one or more filters or broaden the search to see records.
<forma-empty-state class="forma-component-tag">
<section class="forma-empty-state" aria-labelledby="empty-title">
<div class="forma-empty-state__symbol" aria-hidden="true">□</div>
<h3 id="empty-title">No results match these filters</h3>
<p>Clear one or more filters or broaden the search to see records.</p>
<button type="button">Clear filters</button>
</section>
</forma-empty-state>
Click or tap the code once to select all of it, then copy.
A collection that has never had records. The heading names the object, the text says what it is for, and the primary action creates the first one.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
Vendors you add here can be selected on purchase orders and invoices.
<forma-empty-state class="forma-component-tag">
<section class="forma-empty-state" aria-labelledby="empty-state-first-use-title">
<div class="forma-empty-state__symbol" aria-hidden="true">+</div>
<h3 id="empty-state-first-use-title">No vendors yet</h3>
<p>Vendors you add here can be selected on purchase orders and invoices.</p>
<button type="button">Add vendor</button>
</section>
</forma-empty-state>
Click or tap the code once to select all of it, then copy.
A search that returned nothing. The query is repeated so the user can spot a typo, and two recovery actions are grouped in a Cluster: clear the search or open help.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
Check the spelling, or search by record number instead.
<forma-empty-state class="forma-component-tag">
<section class="forma-empty-state" aria-labelledby="empty-state-search-no-matches-title">
<div class="forma-empty-state__symbol" aria-hidden="true">?</div>
<h3 id="empty-state-search-no-matches-title">No records match "reconcilation"</h3>
<p>Check the spelling, or search by record number instead.</p>
<div class="forma-cluster">
<button type="button">Clear search</button>
<a class="forma-button" href="#empty-state-search-no-matches-title">Search tips</a>
</div>
</section>
</forma-empty-state>
Click or tap the code once to select all of it, then copy.
An empty queue that is a good outcome. There is no action to take, so the empty state has only a heading and text; it must not look or read like an error.
New items assigned to you will appear here.
<forma-empty-state class="forma-component-tag">
<section class="forma-empty-state" aria-labelledby="empty-state-queue-complete-title">
<div class="forma-empty-state__symbol" aria-hidden="true">✓</div>
<h3 id="empty-state-queue-complete-title">Nothing waiting for review</h3>
<p>New items assigned to you will appear here.</p>
</section>
</forma-empty-state>
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.
A filtered list with no results at phone width, with a long heading and two actions.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
clamp(2rem, 8vw, 5rem), so the block is compact on phones and roomier on desktops.<forma-empty-state class="forma-component-tag">
<section class="forma-empty-state" aria-labelledby="empty-state-mobile-filtered-list-title">
<div class="forma-empty-state__symbol" aria-hidden="true">□</div>
<h3 id="empty-state-mobile-filtered-list-title">No open invoices from Northwind Traders in the last 30 days</h3>
<p>Change the date range or remove the vendor filter.</p>
<div class="forma-cluster">
<button type="button">Clear filters</button>
<button type="button">Last 90 days</button>
</div>
</section>
</forma-empty-state>
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 buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. 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-labelledby | section.forma-empty-state | id of the heading | — | Names the section so it is exposed as a labelled region. |
aria-hidden | .forma-empty-state__symbol | true | — | Hides the decorative symbol. |
type | button | button | — | Keeps recovery actions from submitting a surrounding form. |
| Hook | Kind | Values or default | Description |
|---|---|---|---|
.forma-empty-state | Block class | — | Root section: centered grid with dashed border and viewport-scaled vertical padding. Removes heading and paragraph margins. |
.forma-empty-state__symbol | Element class | — | Bordered 2rem square holding a short text glyph. Decorative. |
| Keys | Result |
|---|---|
| Tab / Shift+Tab | Moves through the recovery actions. The empty state itself is not focusable. |
| Event | Description |
|---|---|
click | Native click on recovery buttons or links. The application performs the action. |
Not a form control.
| State | How it is expressed | Presentation |
|---|---|---|
| Empty with action | heading, text and one or more buttons or links | The user can change the situation, such as adding a record or clearing filters. |
| Empty as a good outcome | heading and text only | Nothing needs doing; the text confirms that and says what will appear later. |
clamp(2rem, 8vw, 5rem) and horizontal padding is a fixed 1.25rem.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.