Command and keyboard-first

Character grid reveal

<forma-character-grid-reveal>

Optional SequentialReveal presentation: a row-major clip mask over protected text already in the DOM, static by default and under reduced motion; orchestration stays in the application.

Authoring tag
<forma-character-grid-reveal>
Behavior owner
Application / Limen
Canonical source
patterns/character-grid-reveal.html

Purpose

SequentialReveal draws protected text on a Character grid as if it were being typed onto the screen, left to right and top to bottom. It is a presentation-only mask: the text is in the DOM, in the accessibility tree and in source order from time zero, and only its painting is staged with a stepped clip-path. It is a Forma presentation behavior, not authentic 3270 behavior, and it is never required. Forma supplies the mask and timing; the application or Limen decides when a reveal starts, completes it on any input, and replays it only on explicit request.

Use when

  • A sign-on banner or screen title appears for the first time and a brief typed-on effect helps orientation.
  • The effect can be skipped at any moment without losing information.

Avoid when

  • Messages, values, fields, keys, status or tables: they cannot reveal, and the selector does not match them.
  • Screens users revisit to verify data; re-rendering unchanged content must never replay a reveal.
  • Anything users must read before acting; content must never wait on motion. Use static protected text instead.

Behavior to know

  • Static by default: nothing animates unless the grid has data-forma-reveal="sequential" and a run has data-forma-reveal-run.
  • Delay derives from the run's cell position, so reveal order is row-major order.
  • The whole reveal is compressed to finish within --forma-reveal-max-ms (1500ms by default), well under WCAG 2.2.2's five seconds.
  • Staged text is not a live region; screen readers read it immediately and in order.

Basic example

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

Canonical

Minimal character grid reveal

Rendered from the canonical pattern file.

Static specimen. Submitting or resetting it needs the consuming application's form handling, which this documentation does not have. Its controls are shown for their markup and appearance and cannot be operated here.

EXAMPLE SYSTEMS

OPERATIONS NETWORK

Authorized use only.

INFO Enter your operator ID and press Enter.

HTML · Minimal character grid reveal Raw HTML for HTML · Minimal character grid reveal
<forma-character-grid-reveal class="forma-component-tag">
<div class="forma-character-grid" data-forma-rows="8" data-forma-columns="60" data-forma-narrow="contained" data-forma-reveal="sequential" data-forma-reveal-rows="3">
  <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-reveal-title" tabindex="0">
    <form class="forma-character-grid__surface">
      <h2 class="forma-character-grid__text" id="character-grid-reveal-title" data-forma-reveal-run data-forma-row="1" data-forma-col="23" data-forma-len="15" data-forma-emphasis="intensified">EXAMPLE SYSTEMS</h2>
      <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="2" data-forma-col="21" data-forma-len="18">OPERATIONS NETWORK</p>
      <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="3" data-forma-col="20" data-forma-len="20" data-forma-emphasis="muted">Authorized use only.</p>
      <label class="forma-character-grid__label" for="character-grid-reveal-operator" data-forma-row="5" data-forma-col="2" data-forma-len="16">Operator<span class="forma-character-grid__leader" aria-hidden="true"> . . . :</span></label>
      <input class="forma-character-grid__field" id="character-grid-reveal-operator" name="operator" type="text" maxlength="8" required autocomplete="username" data-forma-row="5" data-forma-col="20" data-forma-len="8">
      <p class="forma-character-grid__message" role="status" data-forma-severity="information" data-forma-row="7" data-forma-col="2" data-forma-len="58"><span class="forma-character-grid__severity"><span>INFO</span></span> Enter your operator ID and press Enter.</p>
      <div class="forma-character-grid__group" role="group" aria-label="Function keys">
        <button class="forma-character-grid__key" type="submit" name="action" value="enter" data-forma-action="enter" data-forma-row="8" data-forma-col="2" data-forma-len="13"><kbd>Enter</kbd>=Sign on</button>
        <button class="forma-character-grid__key" type="submit" name="action" value="pf3" formnovalidate data-forma-action="pf3" data-forma-row="8" data-forma-col="17" data-forma-len="8"><kbd>PF3</kbd>=Exit</button>
      </div>
    </form>
  </div>
</div>
</forma-character-grid-reveal>

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

Examples

Scenario

Title-only reveal on a data screen

Only the screen title reveals, and data-forma-reveal-rows="1" limits the timing window to the first row, so the title finishes in well under a second. Values and the message below are never staged.

SHIPMENT TRACKING

Shipment SHP-00931-7 Status IN TRANSIT

INFO SHPT000I Estimated delivery 2026-10-02.

HTML · Title-only reveal on a data screen Raw HTML for HTML · Title-only reveal on a data screen
<forma-character-grid-reveal class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="7" data-forma-columns="80" data-forma-narrow="contained" data-forma-reveal="sequential" data-forma-reveal-rows="1">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-reveal-title-only-title" tabindex="0">
      <div class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-reveal-title-only-title" data-forma-reveal-run data-forma-row="1" data-forma-col="32" data-forma-len="17" data-forma-emphasis="intensified">SHIPMENT TRACKING</h2>
        <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="16">Shipment<span class="forma-character-grid__leader" aria-hidden="true">  . . :</span></span>
        <span class="forma-character-grid__value" data-forma-row="3" data-forma-col="20" data-forma-len="12">SHP-00931-7</span>
        <span class="forma-character-grid__text" data-forma-row="4" data-forma-col="2" data-forma-len="16">Status<span class="forma-character-grid__leader" aria-hidden="true">  . . . :</span></span>
        <span class="forma-character-grid__value" data-forma-row="4" data-forma-col="20" data-forma-len="10">IN TRANSIT</span>
        <p class="forma-character-grid__message" role="status" data-forma-severity="information" data-forma-row="6" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>INFO</span></span> SHPT000I Estimated delivery 2026-10-02.</p>
      </div>
    </div>
  </div>
</forma-character-grid-reveal>

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

Scenario

Multi-line banner within the cap

A four-line banner over a 60-column grid. Uncapped, four rows would take about three seconds; the scale factor compresses delays and durations proportionally so the whole reveal ends within 1.5 seconds.

NORTHWIND LOGISTICS

DISPATCH NETWORK 4

Scheduled maintenance: Sun 02:00 UTC

Authorized use only.

Press Enter to continue to sign on.

HTML · Multi-line banner within the cap Raw HTML for HTML · Multi-line banner within the cap
<forma-character-grid-reveal class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="6" data-forma-columns="60" data-forma-narrow="contained" data-forma-reveal="sequential" data-forma-reveal-rows="4">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-reveal-banner-capped-title" tabindex="0">
      <div class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-reveal-banner-capped-title" data-forma-reveal-run data-forma-row="1" data-forma-col="20" data-forma-len="21" data-forma-emphasis="intensified">NORTHWIND LOGISTICS</h2>
        <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="2" data-forma-col="21" data-forma-len="18">DISPATCH NETWORK 4</p>
        <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="3" data-forma-col="13" data-forma-len="36">Scheduled maintenance: Sun 02:00 UTC</p>
        <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="4" data-forma-col="20" data-forma-len="20" data-forma-emphasis="muted">Authorized use only.</p>
        <p class="forma-character-grid__text" data-forma-row="6" data-forma-col="2" data-forma-len="35">Press Enter to continue to sign on.</p>
      </div>
    </div>
  </div>
</forma-character-grid-reveal>

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

Scenario

Reveal completed by input

The same banner after the user pressed a key during the reveal. The application set data-forma-reveal="complete", a static state: everything is painted and the input that completed it was not consumed.

NORTHWIND LOGISTICS

DISPATCH NETWORK 4

Scheduled maintenance: Sun 02:00 UTC

Authorized use only.

Press Enter to continue to sign on.

HTML · Reveal completed by input Raw HTML for HTML · Reveal completed by input
<forma-character-grid-reveal class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="6" data-forma-columns="60" data-forma-narrow="contained" data-forma-reveal="complete" data-forma-reveal-rows="4">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-reveal-completed-by-input-title" tabindex="0">
      <div class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-reveal-completed-by-input-title" data-forma-reveal-run data-forma-row="1" data-forma-col="20" data-forma-len="21" data-forma-emphasis="intensified">NORTHWIND LOGISTICS</h2>
        <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="2" data-forma-col="21" data-forma-len="18">DISPATCH NETWORK 4</p>
        <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="3" data-forma-col="13" data-forma-len="36">Scheduled maintenance: Sun 02:00 UTC</p>
        <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="4" data-forma-col="20" data-forma-len="20" data-forma-emphasis="muted">Authorized use only.</p>
        <p class="forma-character-grid__text" data-forma-row="6" data-forma-col="2" data-forma-len="35">Press Enter to continue to sign on.</p>
      </div>
    </div>
  </div>
</forma-character-grid-reveal>

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

Sign-on banner on a phone

A 40-column sign-on banner. The reveal timing depends on cell positions, not on viewport width, so it looks the same on a phone.

Static specimen. Submitting or resetting it needs the consuming application's form handling, which this documentation does not have. 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.

What changes at narrow widths

  • Timing derives from cell coordinates and grid geometry, so a narrow viewport neither speeds up nor slows down the reveal.
  • Text scrolled out of the contained viewport is still revealed on schedule and is already readable by assistive technology.
  • A tap anywhere is input: the application completes the reveal and lets the tap proceed.
  • With reduced motion enabled on the device the banner is static from the first frame.
HTML · Sign-on banner on a phone Raw HTML for HTML · Sign-on banner on a phone
<forma-character-grid-reveal class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="6" data-forma-columns="40" data-forma-narrow="contained" data-forma-reveal="sequential" data-forma-reveal-rows="2">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-reveal-banner-mobile-title" tabindex="0">
      <form class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-reveal-banner-mobile-title" data-forma-reveal-run data-forma-row="1" data-forma-col="12" data-forma-len="17" data-forma-emphasis="intensified">FIELD SERVICE HUB</h2>
        <p class="forma-character-grid__text" data-forma-reveal-run data-forma-row="2" data-forma-col="11" data-forma-len="20" data-forma-emphasis="muted">Authorized use only.</p>
        <label class="forma-character-grid__label" for="character-grid-reveal-banner-mobile-tech" data-forma-row="4" data-forma-col="2" data-forma-len="12">Technician<span class="forma-character-grid__leader" aria-hidden="true"> :</span></label>
        <input class="forma-character-grid__field" id="character-grid-reveal-banner-mobile-tech" name="technician" type="text" maxlength="8" required autocomplete="username" data-forma-row="4" data-forma-col="15" data-forma-len="8">
        <div class="forma-character-grid__group" role="group" aria-label="Function keys">
          <button class="forma-character-grid__key" type="submit" name="action" value="enter" data-forma-action="enter" data-forma-row="6" data-forma-col="2" data-forma-len="13"><kbd>Enter</kbd>=Sign on</button>
          <button class="forma-character-grid__key" type="submit" name="action" value="pf3" formnovalidate data-forma-action="pf3" data-forma-row="6" data-forma-col="17" data-forma-len="8"><kbd>PF3</kbd>=Exit</button>
        </div>
      </form>
    </div>
  </div>
</forma-character-grid-reveal>

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. Submitting or resetting it needs the consuming application's form handling, which this documentation does not have. 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.

CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
[data-forma-reveal]Attribute hook—On the grid. sequential runs the mask on staged runs; complete is the static state the application sets on any input; static is the static state used before a replay.
[data-forma-reveal-rows]Attribute hook—On the grid. Limits the timing window to the first N rows (1 up to the grid's rows), so a short banner is not slowed by the rows below it.
[data-forma-reveal-run]Attribute hook—On a protected forma-character-grid__text run only (CG-16). Opts that run into the reveal.
--forma-reveal-char-msCustom property—Time per cell, in milliseconds as a unitless number. Default 12.
--forma-reveal-line-msCustom property—Extra time per row. Default 40.
--forma-reveal-max-msCustom property—Upper bound for the whole reveal. Default 1500. The scale factor is min(1, max / (rows × (columns × char + line))).
.forma-character-grid__textElement class—The only run type that can reveal.
Keyboard interaction
KeysResult
Any keyNo built-in behavior. The application completes the reveal by setting data-forma-reveal="complete" without consuming the key, so the key still does its normal job.

Form behavior

No form behavior. Fields and keys on a revealing screen work from time zero.

States

Character grid reveal states
StateHow it is expressedPresentation
Static (default)no data-forma-reveal, or data-forma-reveal="static"All text painted immediately.
Revealingdata-forma-reveal="sequential" and data-forma-reveal-run on text runsEach staged run is uncovered one cell per step after a delay based on its row and column.
Completedata-forma-reveal="complete" (set by the application)Static and sticky: the mask is gone and does not return when focus moves.
Reduced motion or printprefers-reduced-motion: reduce, @media printAnimation and mask removed; static presentation.

Accessibility

Forma provides

  • Stages only painting: the text is in the DOM, accessibility tree and source order from time zero and is not a live region.
  • Restricts the reveal to protected text by selector, so values, fields, keys, messages, status and tables are never hidden.
  • Caps the total duration at 1.5 seconds by default.
  • Removes the animation and mask under prefers-reduced-motion: reduce and in print.
  • Reveals right-to-left runs from the inline start with a mirrored mask.

Your application supplies

  • Complete the reveal on any key, pointer or focus input, without calling preventDefault.
  • Start a reveal only when new screen content appears; never on re-render of unchanged content.
  • Replay only on explicit user request, by setting static and then sequential again.
  • Do not override Forma's reduced-motion rule.

Responsive behavior

  • Timing depends only on cell coordinates and the grid geometry, never on viewport width.
  • The reveal behaves the same in contained and reflowed layouts, because delay comes from declared coordinates rather than rendered position.

Motion

  • Each staged run animates clip-path from inset(0 100% 0 0) to inset(0) with steps(len, jump-start), one step per character, so text appears a cell at a time.
  • Delay is ((row − 1) × (columns × char + line) + (col − 1) × char) × scale milliseconds and duration is len × char × scale, so order is row-major.
  • The scale factor compresses everything to finish within --forma-reveal-max-ms; the animation runs once and never loops.
  • Interruption is the application's data-forma-reveal="complete", which removes the animation for good; a CSS-only :focus-within interruption would replay when focus leaves.
  • Under prefers-reduced-motion: reduce and in print the animation and clip mask are removed.

Usage guidance

Do

  • Reveal a banner or a title on first display, and keep it short with data-forma-reveal-rows.
  • Keep the screen fully usable while the reveal runs.

Avoid

  • Revealing on every visit to a screen.
  • Using the reveal to delay content users need to read or verify.

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.