Site and editorial

Section heading

<forma-section-heading>

Labels a page section with an eyebrow, heading, framing sentence, and optional aside that wraps on narrow screens.

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

Purpose

A section heading is the header of a marketing page section. .forma-section-heading__text carries an optional eyebrow, the section's h2 and an optional framing sentence; .forma-section-heading__aside holds a secondary link, button or short note. A strong rule under the heading separates it from the section's content. It is presentation only; the heading level and the section's accessible name come from the markup.

Use when

  • Introducing a section of a marketing or product page (services, capabilities, method, proof).
  • The section needs a short framing sentence or a secondary action beside its title.
  • Several sections on a page should share the same heading rhythm.

Avoid when

  • Opening the page: use Hero.
  • Headings inside a long-form article: use plain headings in Prose.
  • Titling an application panel or record: use Record header or a plain heading.

Behavior to know

  • The text group grows first (basis 32rem, minimum 20rem or full width); the aside flexes around 14rem and is capped at 28rem.
  • Heading and aside align to their bottom edges when side by side.
  • Inside .forma-section, content directly after the heading starts without extra stack spacing because the heading already ends in a rule and margin.

Basic example

The smallest correct markup: the canonical pattern from patterns/section-heading.html inside its public tag. Copy this first, then adapt labels, names and state.

Canonical

Minimal section heading

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.

Service lines

Name the section in plain language

An optional sentence frames what follows and why it matters.

HTML · Minimal section heading Raw HTML for HTML · Minimal section heading
<forma-section-heading class="forma-component-tag">
<div class="forma-site">
  <section class="forma-section" aria-labelledby="services-title">
    <header class="forma-section-heading">
      <div class="forma-section-heading__text">
        <p class="forma-eyebrow">Service lines</p>
        <h2 id="services-title">Name the section in plain language</h2>
        <p>An optional sentence frames what follows and why it matters.</p>
      </div>
      <div class="forma-section-heading__aside"><a class="forma-button" href="#services">Explore the services</a></div>
    </header>
  </section>
</div>
</forma-section-heading>

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

Examples

Scenario

Heading with an update note

The aside carries a short mono note (.forma-section-heading__note) instead of an action, for example when the section's content was last reviewed. The note is text, not a link.

Published work

Research the practice depends on

Each paper states its question, method and limits before its conclusion.

Updated September 2026

Twelve papers across four research areas.

HTML · Heading with an update note Raw HTML for HTML · Heading with an update note
<forma-section-heading class="forma-component-tag">
  <div class="forma-site">
    <section class="forma-section" aria-labelledby="section-heading-with-note-title">
      <header class="forma-section-heading">
        <div class="forma-section-heading__text">
          <p class="forma-eyebrow">Published work</p>
          <h2 id="section-heading-with-note-title">Research the practice depends on</h2>
          <p>Each paper states its question, method and limits before its conclusion.</p>
        </div>
        <div class="forma-section-heading__aside"><p class="forma-section-heading__note">Updated September 2026</p></div>
      </header>
      <p>Twelve papers across four research areas.</p>
    </section>
  </div>
</forma-section-heading>

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

Scenario

Title only, followed by cards

The smallest useful heading: eyebrow and title with no framing sentence or aside, directly followed by a card grid. The grid starts right after the heading rule.

Capabilities

What the product does

  • Record quality over time

    Each change adds evidence.

  • Explain regressions

    Every movement links to its cause.

HTML · Title only, followed by cards Raw HTML for HTML · Title only, followed by cards
<forma-section-heading class="forma-component-tag">
  <div class="forma-site">
    <section class="forma-section" aria-labelledby="section-heading-title-only-title">
      <header class="forma-section-heading">
        <div class="forma-section-heading__text">
          <p class="forma-eyebrow">Capabilities</p>
          <h2 id="section-heading-title-only-title">What the product does</h2>
        </div>
      </header>
      <ul class="forma-card-grid" data-forma-columns="2" aria-label="Capabilities">
        <li><article class="forma-card"><h3 class="forma-card__title">Record quality over time</h3><p>Each change adds evidence.</p></article></li>
        <li><article class="forma-card"><h3 class="forma-card__title">Explain regressions</h3><p>Every movement links to its cause.</p></article></li>
      </ul>
    </section>
  </div>
</forma-section-heading>

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

Long title with an action on a phone

A long heading with a framing sentence and an action. At phone width the aside wraps under the text and the button starts at the inline start.

Live demo. 1 native action works here and is 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

  • The text group needs at least 20rem (or the full width when narrower), so the aside wraps below it on phones.
  • Headings balance their line breaks and wrap; the h2 keeps an 18ch maximum so lines stay short on any width.
  • The action button in the aside keeps a 44px minimum target and its label wraps if it is longer than the line.
  • Rotation only changes whether text and aside share a row; source order is unchanged.
HTML · Long title with an action on a phone Raw HTML for HTML · Long title with an action on a phone
<forma-section-heading class="forma-component-tag">
  <div class="forma-site">
    <section class="forma-section" aria-labelledby="section-heading-mobile-long-title-title">
      <header class="forma-section-heading">
        <div class="forma-section-heading__text">
          <p class="forma-eyebrow">Service lines</p>
          <h2 id="section-heading-mobile-long-title-title">Diagnosis, constraint modelling and verification for consequential systems</h2>
          <p>Three engagements that can run alone or in sequence.</p>
        </div>
        <div class="forma-section-heading__aside"><a class="forma-button" href="#section-heading-mobile-long-title-title">Compare the engagements</a></div>
      </header>
    </section>
  </div>
</forma-section-heading>

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-labelledbysection.forma-sectionid of the h2—Names the section by its visible heading.
idh2string—Referenced by the section's aria-labelledby.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
.forma-section-headingBlock class—Root, normally a header inside a section. Wrapping flex row with a strong bottom rule and bottom spacing.
.forma-section-heading__asideElement class—Optional secondary action or note. Flex basis 14rem, capped at 28rem.
.forma-section-heading__noteElement class—Short muted note in the mono label size, for dates or counts shown in the aside.
.forma-section-heading__textElement class—Eyebrow, heading and framing sentence. Grows first with a 32rem basis and a 20rem (or 100%) minimum.
Keyboard interaction
KeysResult
TabReaches any link or button in the aside in source order, after the heading text.

States

Section heading states
StateHow it is expressedPresentation
Side by sideenough inline spaceText and aside share one row, aligned to the bottom.
Wrappedflex-wrapThe aside moves below the text on narrow widths.
Text onlyomit .forma-section-heading__asideThe text group takes the full width.

Accessibility

Forma provides

  • Keeps source order at every width; nothing is reordered visually.
  • Uses text and rules, not color, to separate the heading from content; muted text stays AA on every tone.

Your application supplies

  • Use a real heading element at the right level (normally h2) and name the section with aria-labelledby.
  • Keep the aside secondary: a link or ordinary button, not a second primary action.

Responsive behavior

  • Content-driven wrapping with flex bases; no breakpoints.
  • The text group's minimum is min(100%, 20rem), so it never forces horizontal overflow.
  • Framing sentences keep the reading measure.

Motion

  • No animation: the section heading is static. A button in the aside interpolates color on hover only, and not under reduced motion.

Usage guidance

Do

  • Name the section in plain language; use the eyebrow for its category.
  • Keep the framing sentence to one line of intent.

Avoid

  • Putting the section's main content or a primary action in the aside.
  • Using the eyebrow as the only heading.

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.