VERIFICATION-0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
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>- Category
- Command and keyboard-first
- 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
- Application messages outside a grid: use Alert, Toast or Validation summary.
- Long-running operation progress with steps and recovery: use Operation status.
- Decorative banners or titles: use protected text runs in Character grid.
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.
Minimal character grid status
Rendered from the canonical pattern file.
<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
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").
<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.
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.
<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.
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.
<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.
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.
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.
<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.
Mobile · 320px
The canonical pattern in a true 320px viewport, the minimum width every Forma component must support without page-level horizontal scrolling.
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.
| Attribute | On | Values | Default | Description |
|---|---|---|---|---|
role | .forma-character-grid__message / .forma-character-grid__status | status | 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__message | string | — | Lets invalid fields reference the message with aria-describedby. |
| Hook | Kind | Values or default | Description |
|---|---|---|---|
.forma-character-grid__message | Element class | — | Message run. Wraps within its width (pre-wrap), never clips, and takes the severity color. |
.forma-character-grid__severity | Element class | — | Required visible severity word (INFO, OK, WARN, CHECK, ERROR) in bold. Wrap the word in an inner span. |
.forma-character-grid__status | Element class | — | System status run in the muted color; always role="status". |
.forma-character-grid__indicator | Element 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-information | Custom property | — | Information message color. |
--forma-grid-success | Custom property | — | Success message color. |
--forma-grid-warning | Custom property | — | Warning message color. |
--forma-grid-validation | Custom property | — | Validation message color. |
--forma-grid-error | Custom property | — | Error message color. |
--forma-grid-muted | Custom property | — | Status line color. |
| Keys | Result |
|---|---|
| None | Messages 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
| State | How it is expressed | Presentation |
|---|---|---|
| Information | data-forma-severity="information", role="status" | Plain severity word, information color. |
| Success | data-forma-severity="success", role="status" | Plain severity word, success color. |
| Warning | data-forma-severity="warning", role="status" | Severity word with a 2px underline. |
| Validation | data-forma-severity="validation", role="alert" | Severity word with a double underline; fields reference the message. |
| Error | data-forma-severity="error", role="alert" | Severity word in reverse video with an outline; an outlined box in forced colors. |
| Input inhibited | data-forma-state="inhibited" on the indicator | Indicator 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 userole="status". - Reference the message from invalid fields with
aria-describedbyand setaria-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 withdata-forma-heightwhere 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.