Site and editorial

Entry index

<forma-entry-index>

Ordered linked entries (research areas, products) that regroup from four columns to one by container width.

Authoring tag
<forma-entry-index>
Behavior owner
Site content
Canonical source
patterns/entry-index.html

Purpose

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.
  • Users need to sort, filter or compare values: use Data grid or Relationship index.

Behavior to know

  • 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.

  1. R / 01

    Intelligent systems

    AI Engineering

    Dependable practice, evaluation, human oversight, and workflow design.

    Visit AI Engineering
  2. R / 02

    Perception & composition

    Visual Engineering

    Evidence-led hierarchy, typography, color, composition, and interaction.

    Visit Visual Engineering
HTML · Minimal entry index Raw HTML for HTML · Minimal entry index
<forma-entry-index class="forma-component-tag">
<div class="forma-site">
  <ol class="forma-index" aria-label="Research areas">
    <li class="forma-index__item">
      <p class="forma-index__marker">R / 01</p>
      <div class="forma-index__heading"><p class="forma-eyebrow">Intelligent systems</p><h3 class="forma-index__title">AI Engineering</h3></div>
      <p class="forma-index__summary">Dependable practice, evaluation, human oversight, and workflow design.</p>
      <a class="forma-index__link" href="#ai">Visit AI Engineering</a>
    </li>
    <li class="forma-index__item">
      <p class="forma-index__marker">R / 02</p>
      <div class="forma-index__heading"><p class="forma-eyebrow">Perception &amp; composition</p><h3 class="forma-index__title">Visual Engineering</h3></div>
      <p class="forma-index__summary">Evidence-led hierarchy, typography, color, composition, and interaction.</p>
      <a class="forma-index__link" href="#visual">Visit Visual Engineering</a>
    </li>
  </ol>
</div>
</forma-entry-index>

Click or tap the code once to select all of it, then copy.

Examples

Scenario

Product family index

Four products in order. On a wide container marker, heading, summary and link line up in four columns across every row.

Live demo. 4 native actions work here and are verified by an outcome test.

  1. P / 01

    Domain state

    Ordo

    Legal transitions, obligations and capabilities as executable rules.

    Visit Ordo
  2. P / 02

    Interface behavior

    Limen

    Behavior at the boundary between presentation and domain.

    Visit Limen
  3. P / 03

    Quality evidence

    Dokimos

    Longitudinal code-health evidence across every change.

    Visit Dokimos
  4. P / 04

    Presentation

    Forma

    Zero-runtime HTML and CSS contracts for every interface.

    Visit Forma
HTML · Product family index Raw HTML for HTML · Product family index
<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.

  1. R / 01

    Human oversight of automated decisions

    How review, escalation and accountability survive automation. Includes field studies from regulated industries.

    Read the programme: Human oversight of automated decisions
  2. R / 02

    Evidence-led visual hierarchy

    Measured effects of type, color and composition on comprehension. Findings feed Forma's tokens.

    Read the programme: Evidence-led visual hierarchy
HTML · Long titles and summaries Raw HTML for HTML · Long titles and summaries
<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.

Viewport width

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.
HTML · Phone single column Raw HTML for HTML · Phone single column
<forma-entry-index class="forma-component-tag">
  <div class="forma-site">
    <ol class="forma-index" aria-label="Research areas">
      <li class="forma-index__item">
        <p class="forma-index__marker">R / 01</p>
        <div class="forma-index__heading"><p class="forma-eyebrow">Intelligent systems</p><h3 class="forma-index__title">AI Engineering</h3></div>
        <p class="forma-index__summary">Dependable practice, evaluation and human oversight.</p>
        <a class="forma-index__link" href="#entry-index-mobile-single-column-visual">Visit AI Engineering</a>
      </li>
      <li class="forma-index__item" id="entry-index-mobile-single-column-visual">
        <p class="forma-index__marker">R / 02</p>
        <div class="forma-index__heading"><p class="forma-eyebrow">Perception</p><h3 class="forma-index__title">Visual Engineering</h3></div>
        <p class="forma-index__summary">Evidence-led hierarchy, typography and composition.</p>
        <a class="forma-index__link" href="#entry-index-mobile-single-column-visual">Visit Visual Engineering</a>
      </li>
    </ol>
  </div>
</forma-entry-index>

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.

Viewport width

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
AttributeOnValuesDefaultDescription
aria-labelol.forma-indexstring—Names the list when no visible heading introduces it.
hrefa.forma-index__linkURL—Destination of the entry.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
.forma-indexBlock 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__headingElement class—Wraps the optional eyebrow and the title.
.forma-index__itemElement class—One entry. Spans all columns and uses subgrid so rows align; separated by a bottom rule.
.forma-index__linkElement class—Visible link to the entry's page: small strong text, 24px minimum height, no wrapping.
.forma-index__markerElement class—Visible entry marker text in the mono label face, such as R / 01.
.forma-index__summaryElement class—One-sentence description of the entry.
.forma-index__titleElement class—Entry title in the display face at the statement size, whatever its heading level.
Keyboard interaction
KeysResult
Tab / Shift+TabMoves between entry links in list order.
EnterFollows the focused link (native link behavior).

States

Entry index states
StateHow it is expressedPresentation
Four columnslist at least 56rem wideMarker, 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.

Verification specimens

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.