An entry index is an ordered list of destinations, such as research areas or products, where each row shows a marker, a heading with eyebrow, a one-sentence summary and a visible link. On wide containers the rows share four aligned columns through subgrid, so markers, titles, summaries and links line up down the page. Because four columns of different kinds cannot degrade by a minimum item size, the list regroups by its own width with container queries.
Use when
Listing a small, ordered set of top-level areas or products, each with its own page.
The order or numbering is part of the presentation (R / 01, R / 02).
Rows should align into a table-like index on wide screens without being a data table.
Avoid when
The items are unordered peers with richer content: use Card grid.
The rows are a numbered procedure without links: use Steps.
An ol list: the order is announced, and the marker text is visible content, not a CSS counter.
Each entry has one visible text link that names its destination; the row itself is not a link.
Rows are separated by rules, with a strong rule above the first row.
Basic example
The smallest correct markup: the canonical pattern from patterns/entry-index.html inside its public tag. Copy this first, then adapt labels, names and state.
Canonical
Minimal entry index
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.
R / 01
Intelligent systems
AI Engineering
Dependable practice, evaluation, human oversight, and workflow design.
<forma-entry-index class="forma-component-tag">
<div class="forma-site">
<ol class="forma-index" aria-label="Products">
<li class="forma-index__item">
<p class="forma-index__marker">P / 01</p>
<div class="forma-index__heading"><p class="forma-eyebrow">Domain state</p><h3 class="forma-index__title" id="entry-index-product-family-ordo">Ordo</h3></div>
<p class="forma-index__summary">Legal transitions, obligations and capabilities as executable rules.</p>
<a class="forma-index__link" href="#entry-index-product-family-ordo">Visit Ordo</a>
</li>
<li class="forma-index__item">
<p class="forma-index__marker">P / 02</p>
<div class="forma-index__heading"><p class="forma-eyebrow">Interface behavior</p><h3 class="forma-index__title" id="entry-index-product-family-limen">Limen</h3></div>
<p class="forma-index__summary">Behavior at the boundary between presentation and domain.</p>
<a class="forma-index__link" href="#entry-index-product-family-limen">Visit Limen</a>
</li>
<li class="forma-index__item">
<p class="forma-index__marker">P / 03</p>
<div class="forma-index__heading"><p class="forma-eyebrow">Quality evidence</p><h3 class="forma-index__title" id="entry-index-product-family-dokimos">Dokimos</h3></div>
<p class="forma-index__summary">Longitudinal code-health evidence across every change.</p>
<a class="forma-index__link" href="#entry-index-product-family-dokimos">Visit Dokimos</a>
</li>
<li class="forma-index__item">
<p class="forma-index__marker">P / 04</p>
<div class="forma-index__heading"><p class="forma-eyebrow">Presentation</p><h3 class="forma-index__title" id="entry-index-product-family-forma">Forma</h3></div>
<p class="forma-index__summary">Zero-runtime HTML and CSS contracts for every interface.</p>
<a class="forma-index__link" href="#entry-index-product-family-forma">Visit Forma</a>
</li>
</ol>
</div>
</forma-entry-index>
Click or tap the code once to select all of it, then copy.
Scenario
Long titles and summaries
Entries with long titles and two-sentence summaries and no eyebrow. Titles and summaries wrap within their columns; the link text stays on one line while it fits and wraps between words rather than overflowing at large text sizes.
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.
R / 01
Human oversight of automated decisions
How review, escalation and accountability survive automation. Includes field studies from regulated industries.
<forma-entry-index class="forma-component-tag">
<div class="forma-site">
<ol class="forma-index" aria-label="Research programmes">
<li class="forma-index__item">
<p class="forma-index__marker">R / 01</p>
<div class="forma-index__heading"><h3 class="forma-index__title">Human oversight of automated decisions</h3></div>
<p class="forma-index__summary">How review, escalation and accountability survive automation. Includes field studies from regulated industries.</p>
<a class="forma-index__link" href="#entry-index-long-titles-oversight">Read the programme<span class="forma-visually-hidden">: Human oversight of automated decisions</span></a>
</li>
<li class="forma-index__item">
<p class="forma-index__marker">R / 02</p>
<div class="forma-index__heading"><h3 class="forma-index__title">Evidence-led visual hierarchy</h3></div>
<p class="forma-index__summary">Measured effects of type, color and composition on comprehension. Findings feed Forma's tokens.</p>
<a class="forma-index__link" href="#entry-index-long-titles-hierarchy">Read the programme<span class="forma-visually-hidden">: Evidence-led visual hierarchy</span></a>
</li>
</ol>
</div>
</forma-entry-index>
Click or tap the code once to select all of it, then copy.
Mobile
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.
Mobile example
Phone single column
Two research areas at phone width, where each row has regrouped into one column.
Live demo. 2 native actions work here and are verified by an outcome test.
Frames narrower than the selected width show the component at the width available.
What changes at narrow widths
Below a 56rem list width each row regroups into a 3.5rem marker column beside the content, with heading, summary and link stacked in the second column.
Below 28rem (most phones) the marker also moves into the single column above the heading; source order is unchanged.
The link text stays on one line while it fits and wraps between words instead of overflowing a 320px row; still keep it short.
The link is at least 24px tall and sits alone on its own line, so it is easy to tap without catching neighbours.
Click or tap the code once to select all of it, then copy.
Baseline
Mobile · 320px
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.
Frames narrower than the selected width show the component at the width available.
API and configuration
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.
Native and ARIA attributes
Attribute
On
Values
Default
Description
aria-label
ol.forma-index
string
—
Names the list when no visible heading introduces it.
href
a.forma-index__link
URL
—
Destination of the entry.
CSS hooks (derived from dist/all.css)
Hook
Kind
Values or default
Description
.forma-index
Block class
—
The ol. A four-column grid (5rem marker, heading, summary, link) with a strong top rule; also the forma-index size container for regrouping.
.forma-index__heading
Element class
—
Wraps the optional eyebrow and the title.
.forma-index__item
Element class
—
One entry. Spans all columns and uses subgrid so rows align; separated by a bottom rule.
.forma-index__link
Element class
—
Visible link to the entry's page: small strong text, 24px minimum height, no wrapping.
.forma-index__marker
Element class
—
Visible entry marker text in the mono label face, such as R / 01.
.forma-index__summary
Element class
—
One-sentence description of the entry.
.forma-index__title
Element class
—
Entry title in the display face at the statement size, whatever its heading level.
Keyboard interaction
Keys
Result
Tab / Shift+Tab
Moves between entry links in list order.
Enter
Follows the focused link (native link behavior).
States
Entry index states
State
How it is expressed
Presentation
Four columns
list at least 56rem wide
Marker, heading, summary and link align across rows.
Marker and content
@container forma-index (inline-size < 56rem)
Two columns: marker, then everything else stacked.
Single column
@container forma-index (inline-size < 28rem)
Every part stacks in source order.
Accessibility
Forma provides
Keeps the native ordered list so the number of entries and their order are announced.
Regroups without reordering, so reading and focus order are the same at every width.
Keeps entry links underlined, with the shell's visible focus ring.
Your application supplies
Use headings at the level the page outline needs and name the list.
Write link text that names the destination ("Visit Ordo"), not "Learn more".
Keep link text short, because it does not wrap.
Responsive behavior
Container queries on the list itself (forma-index) regroup rows at 56rem and 28rem; they respond to the space the list gets, not the viewport.
Columns are minmax(0, …), so titles and summaries wrap instead of widening the page.
.forma-index__link keeps its text on one line while it fits and wraps between words at narrow widths or large text sizes instead of overflowing.
Motion
No animation: regrouping is immediate and links change only their underline thickness on hover.
Usage guidance
Do
Keep the index to a handful of top-level entries.
Keep the marker scheme consistent (R / 01, R / 02).
Avoid
Wrapping a whole row in a link.
Using the marker as the only identifier of an entry.