VERIFICATION-0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
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>- Category
- Command and keyboard-first
- 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 hasdata-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.
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.
<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
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.
<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.
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.
<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.
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.
<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.
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.
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.
<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.
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.
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.
| Hook | Kind | Values or default | Description |
|---|---|---|---|
[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-ms | Custom property | — | Time per cell, in milliseconds as a unitless number. Default 12. |
--forma-reveal-line-ms | Custom property | — | Extra time per row. Default 40. |
--forma-reveal-max-ms | Custom property | — | Upper bound for the whole reveal. Default 1500. The scale factor is min(1, max / (rows × (columns × char + line))). |
.forma-character-grid__text | Element class | — | The only run type that can reveal. |
| Keys | Result |
|---|---|
| Any key | No 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
| State | How it is expressed | Presentation |
|---|---|---|
| Static (default) | no data-forma-reveal, or data-forma-reveal="static" | All text painted immediately. |
| Revealing | data-forma-reveal="sequential" and data-forma-reveal-run on text runs | Each staged run is uncovered one cell per step after a delay based on its row and column. |
| Complete | data-forma-reveal="complete" (set by the application) | Static and sticky: the mask is gone and does not return when focus moves. |
| Reduced motion or print | prefers-reduced-motion: reduce, @media print | Animation 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: reduceand 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
staticand thensequentialagain. - 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-pathfrominset(0 100% 0 0)toinset(0)withsteps(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) × scalemilliseconds and duration islen × 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-withininterruption would replay when focus leaves. - Under
prefers-reduced-motion: reduceand 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.