Command and keyboard-first

Character grid status

<forma-character-grid-status>

Message and system-status live regions on a character grid with a visible severity word and shape cues that survive forced colors.

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

Purpose

Character grid status covers the two kinds of feedback a character-grid screen gives: the application message ("CINQ000I Type search criteria and press Enter.") and the system status line (READY, X SYSTEM). A message is a live region with a visible severity word; the status line is a role="status" run with an indicator word. Forma presents severity and state with text and shape; the application decides the content, the severity, when to replace it, and whether input is actually inhibited.

Use when

  • A character-grid screen must report the outcome of Enter or a PF key.
  • Validation errors on grid fields need a message the fields can reference with aria-describedby.
  • The screen models a terminal status line, such as the 3270 Operator Information Area, or draws its own status row.

Avoid when

Behavior to know

  • Every message starts with a visible severity word; color is never the only cue.
  • Shape cues add to the word: underline for warning, double underline for validation, reverse video with an outline for error and for the inhibited indicator.
  • Messages wrap within their run and grow their rows if needed; they are never truncated, clipped or scrolled.
  • Device status rows (data-forma-status-rows) follow the application rows, so row-major and focus order are unchanged.

Basic example

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

Canonical

Minimal character grid status

Rendered from the canonical pattern file.

BATCH TRANSFER

Records 1,204

X SYSTEM Input inhibited

HTML · Minimal character grid status Raw HTML for HTML · Minimal character grid status
<forma-character-grid-status class="forma-component-tag">
<div class="forma-character-grid" data-forma-rows="6" data-forma-columns="80" data-forma-narrow="contained">
  <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-status-title" tabindex="0">
    <div class="forma-character-grid__surface">
      <h2 class="forma-character-grid__text" id="character-grid-status-title" data-forma-row="1" data-forma-col="33" data-forma-len="14" data-forma-emphasis="intensified">BATCH TRANSFER</h2>
      <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="16">Records<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="6" data-forma-align="end">1,204</span>
      <p class="forma-character-grid__message" role="alert" data-forma-severity="error" data-forma-row="5" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>ERROR</span></span> BTX009E Transfer service did not respond. Press Reset, then Enter.</p>
      <p class="forma-character-grid__status" role="status" data-forma-row="6" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__indicator" data-forma-state="inhibited"><span>X SYSTEM</span></span>  Input inhibited</p>
    </div>
  </div>
</div>
</forma-character-grid-status>

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

Examples

Scenario

Success after an update

A success message with the severity word OK, and a READY indicator on a device status row after the application rows (data-forma-status-rows="1").

ACCOUNT MAINTENANCE

Account 00417-2231-09

OK ACCM004I Account 00417-2231-09 updated. Changes take effect at end of day.

READY

HTML · Success after an update Raw HTML for HTML · Success after an update
<forma-character-grid-status class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="6" data-forma-status-rows="1" data-forma-columns="80" data-forma-narrow="contained">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-status-update-success-title" tabindex="0">
      <div class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-status-update-success-title" data-forma-row="1" data-forma-col="31" data-forma-len="19" data-forma-emphasis="intensified">ACCOUNT MAINTENANCE</h2>
        <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="16">Account<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="13">00417-2231-09</span>
        <p class="forma-character-grid__message" role="status" data-forma-severity="success" data-forma-row="6" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>OK</span></span> ACCM004I Account 00417-2231-09 updated. Changes take effect at end of day.</p>
        <p class="forma-character-grid__status" role="status" data-forma-row="7" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__indicator"><span>READY</span></span></p>
      </div>
    </div>
  </div>
</forma-character-grid-status>

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

Scenario

Warning that does not block

A warning uses role="status" because it does not need to interrupt. The severity word WARN is underlined as a shape cue. This screen draws its own status on its last row, so it omits data-forma-status-rows.

MONTHLY BRANCH REPORT

Period 2026-09

WARN RPT021W Report includes 3 branches with incomplete data for September.

READY Page 1 of 4

HTML · Warning that does not block Raw HTML for HTML · Warning that does not block
<forma-character-grid-status class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="6" data-forma-columns="80" data-forma-narrow="contained">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-status-report-warning-title" tabindex="0">
      <div class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-status-report-warning-title" data-forma-row="1" data-forma-col="30" data-forma-len="21" data-forma-emphasis="intensified">MONTHLY BRANCH REPORT</h2>
        <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="16">Period<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="7">2026-09</span>
        <p class="forma-character-grid__message" role="status" data-forma-severity="warning" data-forma-row="5" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>WARN</span></span> RPT021W Report includes 3 branches with incomplete data for September.</p>
        <p class="forma-character-grid__status" role="status" data-forma-row="6" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__indicator"><span>READY</span></span>  Page 1 of 4</p>
      </div>
    </div>
  </div>
</forma-character-grid-status>

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

Scenario

Long error in reserved rows

Runtime message text varies in length, so the message run reserves two rows with data-forma-height="2" and wraps within its width. role="alert" announces it immediately, and the ERROR word is drawn in reverse video.

PAYMENT RELEASE

Batch PB-20260930

READY

HTML · Long error in reserved rows Raw HTML for HTML · Long error in reserved rows
<forma-character-grid-status class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="7" data-forma-columns="80" data-forma-narrow="contained">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-status-long-error-title" tabindex="0">
      <div class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-status-long-error-title" data-forma-row="1" data-forma-col="33" data-forma-len="15" data-forma-emphasis="intensified">PAYMENT RELEASE</h2>
        <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="16">Batch<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="11">PB-20260930</span>
        <p class="forma-character-grid__message" role="alert" data-forma-severity="error" data-forma-row="5" data-forma-col="2" data-forma-len="78" data-forma-height="2"><span class="forma-character-grid__severity"><span>ERROR</span></span> PAY117E Batch rejected: total 48,210.55 does not match its 212 items (48,201.55). Correct the batch and resubmit.</p>
        <p class="forma-character-grid__status" role="status" data-forma-row="7" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__indicator"><span>READY</span></span></p>
      </div>
    </div>
  </div>
</forma-character-grid-status>

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

Status line on a phone

An information message and an inhibited indicator on a 40-column screen. The indicator keeps its word and reverse-video box at phone width.

Viewport width

Frames narrower than the selected width show the component at the width available.

What changes at narrow widths

  • Messages wrap inside their reserved rows at any width; at the 44px touch pitch each row is taller, so reserved rows hold the same text.
  • If a message still does not fit, its rows grow and later rows move down instead of being painted over.
  • Status and message runs keep their cell positions; a 40-column grid fits in portrait and wider grids scroll inside the viewport.
  • The severity word stays first on the line, so it is visible even when the viewport is scrolled to its start.
HTML · Status line on a phone Raw HTML for HTML · Status line on a phone
<forma-character-grid-status class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="6" data-forma-columns="40" data-forma-narrow="contained">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-status-status-mobile-title" tabindex="0">
      <div class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-status-status-mobile-title" data-forma-row="1" data-forma-col="14" data-forma-len="13" data-forma-emphasis="intensified">STOCK INQUIRY</h2>
        <span class="forma-character-grid__text" data-forma-row="2" data-forma-col="2" data-forma-len="10">Item . . :</span>
        <span class="forma-character-grid__value" data-forma-row="2" data-forma-col="13" data-forma-len="9">SKU-40211</span>
        <p class="forma-character-grid__message" role="status" data-forma-severity="information" data-forma-row="4" data-forma-col="2" data-forma-len="38" data-forma-height="2"><span class="forma-character-grid__severity"><span>INFO</span></span> Stock levels are being refreshed from the warehouse.</p>
        <p class="forma-character-grid__status" role="status" data-forma-row="6" data-forma-col="2" data-forma-len="38"><span class="forma-character-grid__indicator" data-forma-state="inhibited"><span>X SYSTEM</span></span>  Please wait</p>
      </div>
    </div>
  </div>
</forma-character-grid-status>

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.

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
role.forma-character-grid__message / .forma-character-grid__statusstatus | alert—status for information, success and warning and for the system status line; alert for validation and error that need immediate attention. The element must exist before its text changes.
id.forma-character-grid__messagestring—Lets invalid fields reference the message with aria-describedby.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
.forma-character-grid__messageElement class—Message run. Wraps within its width (pre-wrap), never clips, and takes the severity color.
.forma-character-grid__severityElement class—Required visible severity word (INFO, OK, WARN, CHECK, ERROR) in bold. Wrap the word in an inner span.
.forma-character-grid__statusElement class—System status run in the muted color; always role="status".
.forma-character-grid__indicatorElement class—Bold indicator word inside the status run, such as READY or X SYSTEM. Wrap the word in an inner span.
[data-forma-severity]Attribute hook—information, success, warning, validation or error (CG-15). Sets the message color and the severity-word shape cue.
[data-forma-state]Attribute hook—inhibited on the indicator draws reverse video with an outline; an outlined box in forced colors.
[data-forma-status-rows]Attribute hook—On the grid: 1 or 2 device status rows after the application rows, for status runs only (CG-18).
[data-forma-height]Attribute hook—Rows a message reserves when its runtime length varies.
--forma-grid-informationCustom property—Information message color.
--forma-grid-successCustom property—Success message color.
--forma-grid-warningCustom property—Warning message color.
--forma-grid-validationCustom property—Validation message color.
--forma-grid-errorCustom property—Error message color.
--forma-grid-mutedCustom property—Status line color.
Keyboard interaction
KeysResult
NoneMessages and status are not focusable. Live regions are announced without moving focus.

Form behavior

Messages and status runs are not form controls and submit nothing.

States

Character grid status states
StateHow it is expressedPresentation
Informationdata-forma-severity="information", role="status"Plain severity word, information color.
Successdata-forma-severity="success", role="status"Plain severity word, success color.
Warningdata-forma-severity="warning", role="status"Severity word with a 2px underline.
Validationdata-forma-severity="validation", role="alert"Severity word with a double underline; fields reference the message.
Errordata-forma-severity="error", role="alert"Severity word in reverse video with an outline; an outlined box in forced colors.
Input inhibiteddata-forma-state="inhibited" on the indicatorIndicator in reverse video. Whether input is actually inhibited is application behavior.

Accessibility

Forma provides

  • Requires a visible severity word, so meaning never depends on color.
  • Adds severity shape cues (underline, double underline, reverse video) that survive grayscale; forced colors replace reverse video with an outlined box.
  • Never clips or truncates a message; long text wraps and grows its rows.

Your application supplies

  • Render the message and status elements with the screen and replace their content, so assistive technology announces the change.
  • Use role="alert" only for validation and errors; routine outcomes use role="status".
  • Reference the message from invalid fields with aria-describedby and set aria-invalid="true".
  • When showing X SYSTEM, actually disable the affected keys and fields, and keep Reset available.

Responsive behavior

  • Messages wrap within their width (white-space: pre-wrap, overflow-wrap: anywhere); reserve rows with data-forma-height where length varies.
  • If a message exceeds its reserved rows, intrinsic row tracks grow and later rows move down.
  • The status line keeps preserved spacing (white-space: pre) and its cell position; the grid's containment keeps the page from scrolling sideways.

Motion

  • No animation: messages and indicators change when the application replaces their content.
  • Messages and status are excluded from SequentialReveal, so a new message is never staged or delayed.

Usage guidance

Do

  • Keep message IDs (such as CINQ000I) and the severity word in the visible text.
  • Reserve two rows for messages whose text comes from a service.

Avoid

  • Creating the live region at the moment the message appears; it may not be announced.
  • Using color or the ibm-3270 palette alone to tell warnings from errors.
  • Putting application messages on device status rows; those rows hold status only.

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.