VERIFICATION-0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
Character grid 3270 profile
<forma-character-grid-3270>
IBM 3270-inspired reference profile built only from public CharacterGrid contracts: a 24x80 operations menu with 3279-style palette tokens and block caret, verified at 32x80.
- Authoring tag
<forma-character-grid-3270>- Category
- Command and keyboard-first
- Behavior owner
- Application / Limen
- Canonical source
patterns/character-grid-3270.html
Purpose
The 3270 profile is the first reference presentation for Character grid. Adding data-forma-profile="ibm-3270" to a grid swaps presentation tokens only: black screen, protected text in blue, intensified text and values in white, unprotected fields in green, severity colors, a block caret on fields and a rule over the device status row. Geometry, placement, order and semantics are unchanged, and the same markup renders in Forma's default presentation without the attribute. It is a stylistic evocation of the 3279 palette, not an emulation: no data stream, attribute bytes, autoskip, wraparound Tab or uppercase transformation is reproduced.
Use when
- An application re-platforms 3270 host screens and operators expect the familiar palette.
- A screen models the 3270 Operator Information Area on a device status row after the application rows.
- You need a verified reference geometry: 24 by 80 (canonical) or 32 by 80 (Model 3).
Avoid when
- 5250, DOS, BBS or modern tools: use the default presentation or your own token set; Forma ships no profile for them.
- Screens that must follow the application's light or dark theme: the profile always draws a black screen.
- Adding behavior such as autoskip or uppercase input: that is application code, not a profile.
Behavior to know
- Profiles may change palette, border and shadow color, caret treatment and focus background only (Visual Engineering rule B-8).
- All profile colors pass WCAG AA contrast on the black screen.
- The block caret (
caret-shape: block) is progressive enhancement layered on the standard focus outline, which is never removed. - Forced colors replace the palette while boundaries, focus and severity shapes remain.
Basic example
The smallest correct markup: the canonical pattern from patterns/character-grid-3270.html inside its public tag. Copy this first, then adapt labels, names and state.
Minimal character grid 3270 profile
Rendered from the canonical pattern file.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. 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-3270 class="forma-component-tag">
<div class="forma-character-grid" data-forma-profile="ibm-3270" data-forma-rows="24" 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-3270-title" tabindex="0">
<form class="forma-character-grid__surface">
<span class="forma-character-grid__text" data-forma-row="1" data-forma-col="2" data-forma-len="4">OPSM</span>
<h2 class="forma-character-grid__text" id="character-grid-3270-title" data-forma-row="1" data-forma-col="33" data-forma-len="15" data-forma-emphasis="intensified">OPERATIONS MENU</h2>
<span class="forma-character-grid__text" data-forma-row="1" data-forma-col="64" data-forma-len="5">Date:</span>
<span class="forma-character-grid__value" data-forma-row="1" data-forma-col="70" data-forma-len="10">2026-09-27</span>
<span class="forma-character-grid__text" data-forma-row="2" data-forma-col="2" data-forma-len="7">System:</span>
<span class="forma-character-grid__value" data-forma-row="2" data-forma-col="10" data-forma-len="8">ECHT01</span>
<span class="forma-character-grid__text" data-forma-row="2" data-forma-col="60" data-forma-len="9">Operator:</span>
<span class="forma-character-grid__value" data-forma-row="2" data-forma-col="70" data-forma-len="8">OP0142</span>
<p class="forma-character-grid__text" data-forma-row="4" data-forma-col="2" data-forma-len="33">Select an option and press Enter.</p>
<dl class="forma-character-grid__group" aria-label="Options">
<dt class="forma-character-grid__value" data-forma-row="6" data-forma-col="6" data-forma-len="1">1</dt>
<dd class="forma-character-grid__text" data-forma-row="6" data-forma-col="10" data-forma-len="16">Customer inquiry</dd>
<dt class="forma-character-grid__value" data-forma-row="7" data-forma-col="6" data-forma-len="1">2</dt>
<dd class="forma-character-grid__text" data-forma-row="7" data-forma-col="10" data-forma-len="19">Account maintenance</dd>
<dt class="forma-character-grid__value" data-forma-row="8" data-forma-col="6" data-forma-len="1">3</dt>
<dd class="forma-character-grid__text" data-forma-row="8" data-forma-col="10" data-forma-len="19">Transaction history</dd>
<dt class="forma-character-grid__value" data-forma-row="9" data-forma-col="6" data-forma-len="1">4</dt>
<dd class="forma-character-grid__text" data-forma-row="9" data-forma-col="10" data-forma-len="7">Reports</dd>
<dt class="forma-character-grid__value" data-forma-row="10" data-forma-col="6" data-forma-len="1">X</dt>
<dd class="forma-character-grid__text" data-forma-row="10" data-forma-col="10" data-forma-len="4">Exit</dd>
</dl>
<label class="forma-character-grid__label" for="character-grid-3270-option" data-forma-row="13" data-forma-col="2" data-forma-len="11">Option<span class="forma-character-grid__leader" aria-hidden="true"> ===></span></label>
<input class="forma-character-grid__field" id="character-grid-3270-option" name="option" type="text" maxlength="2" required aria-describedby="character-grid-3270-option-hint" autocomplete="off" data-forma-row="13" data-forma-col="15" data-forma-len="2">
<span class="forma-character-grid__text" id="character-grid-3270-option-hint" data-forma-row="13" data-forma-col="20" data-forma-len="18" data-forma-emphasis="muted">(1-4 or X to exit)</span>
<p class="forma-character-grid__message" role="status" data-forma-severity="information" data-forma-row="21" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>INFO</span></span> OPSM000I Session started 2026-09-27 08:15.</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="22" data-forma-col="2" data-forma-len="12"><kbd>Enter</kbd>=Select</button>
<button class="forma-character-grid__key" type="submit" name="action" value="pf1" formnovalidate data-forma-action="pf1" data-forma-row="22" data-forma-col="16" data-forma-len="8"><kbd>PF1</kbd>=Help</button>
<button class="forma-character-grid__key" type="submit" name="action" value="pf3" formnovalidate data-forma-action="pf3" data-forma-row="22" data-forma-col="26" data-forma-len="8"><kbd>PF3</kbd>=Exit</button>
<button class="forma-character-grid__key" type="submit" name="action" value="pf12" formnovalidate data-forma-action="pf12" data-forma-row="22" data-forma-col="36" data-forma-len="11"><kbd>PF12</kbd>=Cancel</button>
<button class="forma-character-grid__key" type="button" data-forma-action="reset" data-forma-row="23" data-forma-col="2" data-forma-len="12"><kbd>Reset</kbd>=Unlock</button>
</div>
<p class="forma-character-grid__status" role="status" data-forma-row="25" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__indicator"><span>READY</span></span></p>
</form>
</div>
</div>
</forma-character-grid-3270>
Click or tap the code once to select all of it, then copy.
Examples
Host error with input inhibited
The host did not respond. The error message uses role="alert" and reverse video, the Operator Information Area on row 11 shows X SYSTEM, and only Reset is enabled until the application unlocks input.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
<forma-character-grid-3270 class="forma-component-tag">
<div class="forma-character-grid" data-forma-profile="ibm-3270" data-forma-rows="10" 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-3270-host-error-title" tabindex="0">
<form class="forma-character-grid__surface">
<span class="forma-character-grid__text" data-forma-row="1" data-forma-col="2" data-forma-len="4">BTXR</span>
<h2 class="forma-character-grid__text" id="character-grid-3270-host-error-title" data-forma-row="1" data-forma-col="32" data-forma-len="18" data-forma-emphasis="intensified">BATCH TRANSFER RUN</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">BT-20260930</span>
<span class="forma-character-grid__text" data-forma-row="4" 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="4" 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="8" 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>
<div class="forma-character-grid__group" role="group" aria-label="Function keys">
<button class="forma-character-grid__key" type="submit" name="action" value="enter" disabled data-forma-action="enter" data-forma-row="10" data-forma-col="2" data-forma-len="11"><kbd>Enter</kbd>=Retry</button>
<button class="forma-character-grid__key" type="button" data-forma-action="reset" data-forma-row="10" data-forma-col="15" data-forma-len="12"><kbd>Reset</kbd>=Unlock</button>
<button class="forma-character-grid__key" type="submit" name="action" value="pf3" formnovalidate disabled data-forma-action="pf3" data-forma-row="10" data-forma-col="29" data-forma-len="8"><kbd>PF3</kbd>=Exit</button>
</div>
<p class="forma-character-grid__status" role="status" data-forma-row="11" 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>
</form>
</div>
</div>
</forma-character-grid-3270>
Click or tap the code once to select all of it, then copy.
Field states in the 3279 palette
Required, invalid and disabled fields in green on black. The state cues are the same shapes as the default presentation (double underline, dashed rules, dotted underline); focused fields add a block caret and a dark green focus background.
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-3270 class="forma-component-tag">
<div class="forma-character-grid" data-forma-profile="ibm-3270" data-forma-rows="9" 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-3270-field-states-title" tabindex="0">
<form class="forma-character-grid__surface">
<span class="forma-character-grid__text" data-forma-row="1" data-forma-col="2" data-forma-len="4">ACCM</span>
<h2 class="forma-character-grid__text" id="character-grid-3270-field-states-title" data-forma-row="1" data-forma-col="31" data-forma-len="19" data-forma-emphasis="intensified">ACCOUNT MAINTENANCE</h2>
<label class="forma-character-grid__label" for="character-grid-3270-field-states-account" data-forma-row="3" data-forma-col="2" data-forma-len="16">Account<span class="forma-character-grid__leader" aria-hidden="true"> . . . :</span></label>
<input class="forma-character-grid__field" id="character-grid-3270-field-states-account" name="account" type="text" maxlength="13" required value="00417-2231-09" autocomplete="off" data-forma-row="3" data-forma-col="20" data-forma-len="13">
<label class="forma-character-grid__label" for="character-grid-3270-field-states-limit" data-forma-row="4" data-forma-col="2" data-forma-len="16">Credit limit<span class="forma-character-grid__leader" aria-hidden="true"> :</span></label>
<input class="forma-character-grid__field" id="character-grid-3270-field-states-limit" name="limit" type="text" inputmode="decimal" maxlength="12" value="5,000.0O" aria-invalid="true" aria-describedby="character-grid-3270-field-states-message" autocomplete="off" data-forma-row="4" data-forma-col="20" data-forma-len="12">
<label class="forma-character-grid__label" for="character-grid-3270-field-states-branch" data-forma-row="5" data-forma-col="2" data-forma-len="16">Branch<span class="forma-character-grid__leader" aria-hidden="true"> . . . :</span></label>
<input class="forma-character-grid__field" id="character-grid-3270-field-states-branch" name="branch" type="text" maxlength="8" value="NORTH" disabled data-forma-row="5" data-forma-col="20" data-forma-len="8">
<p class="forma-character-grid__message" id="character-grid-3270-field-states-message" role="alert" data-forma-severity="validation" data-forma-row="8" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>CHECK</span></span> ACCM012E Credit limit must contain digits only, e.g. 5000.00</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="9" data-forma-col="2" data-forma-len="12"><kbd>Enter</kbd>=Update</button>
<button class="forma-character-grid__key" type="submit" name="action" value="pf12" formnovalidate data-forma-action="pf12" data-forma-row="9" data-forma-col="16" data-forma-len="11"><kbd>PF12</kbd>=Cancel</button>
</div>
<p class="forma-character-grid__status" role="status" data-forma-row="10" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__indicator"><span>READY</span></span></p>
</form>
</div>
</div>
</forma-character-grid-3270>
Click or tap the code once to select all of it, then copy.
Same screen without the profile
The host-error screen with data-forma-profile removed. Every run stays on the same cell; only tokens change, so it follows the application's light or dark theme. This is how a profile is verified to be presentation-only.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
<forma-character-grid-3270 class="forma-component-tag">
<div class="forma-character-grid" data-forma-rows="10" 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-3270-without-profile-title" tabindex="0">
<form class="forma-character-grid__surface">
<span class="forma-character-grid__text" data-forma-row="1" data-forma-col="2" data-forma-len="4">BTXR</span>
<h2 class="forma-character-grid__text" id="character-grid-3270-without-profile-title" data-forma-row="1" data-forma-col="32" data-forma-len="18" data-forma-emphasis="intensified">BATCH TRANSFER RUN</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">BT-20260930</span>
<span class="forma-character-grid__text" data-forma-row="4" 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="4" 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="8" 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>
<div class="forma-character-grid__group" role="group" aria-label="Function keys">
<button class="forma-character-grid__key" type="submit" name="action" value="enter" disabled data-forma-action="enter" data-forma-row="10" data-forma-col="2" data-forma-len="11"><kbd>Enter</kbd>=Retry</button>
<button class="forma-character-grid__key" type="button" data-forma-action="reset" data-forma-row="10" data-forma-col="15" data-forma-len="12"><kbd>Reset</kbd>=Unlock</button>
<button class="forma-character-grid__key" type="submit" name="action" value="pf3" formnovalidate disabled data-forma-action="pf3" data-forma-row="10" data-forma-col="29" data-forma-len="8"><kbd>PF3</kbd>=Exit</button>
</div>
<p class="forma-character-grid__status" role="status" data-forma-row="11" 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>
</form>
</div>
</div>
</forma-character-grid-3270>
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 · 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 buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. 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-profile] | Attribute hook | — | ibm-3270 on .forma-character-grid applies the profile. Remove it to get Forma's default presentation with identical geometry. |
[data-forma-status-rows] | Attribute hook | — | Use 1 to model the Operator Information Area after the application rows (row 25 on a 24 by 80 screen, row 33 on 32 by 80). The profile rules a muted line over it. |
[data-forma-rows] | Attribute hook | — | 24 (canonical) or 32 (Model 3) are the verified geometries; 43 by 80 and 27 by 132 are supported but not separately exercised. |
--forma-grid-background | Custom property | — | Profile value #000000. |
--forma-grid-foreground | Custom property | — | Profile value #7aa7ff (protected blue). |
--forma-grid-protected | Custom property | — | Profile value #7aa7ff. |
--forma-grid-emphasis | Custom property | — | Profile value #f2f2f2 (intensified white) for values, titles and key names. |
--forma-grid-muted | Custom property | — | Profile value #9fb8e8. |
--forma-grid-field | Custom property | — | Profile value #5ee08f (unprotected green). |
--forma-grid-field-surface | Custom property | — | Profile value #0b1f12. |
--forma-grid-boundary | Custom property | — | Profile value #5ee08f. |
--forma-grid-focus | Custom property | — | Profile value #4fe3d6; also the block caret color. |
--forma-grid-information | Custom property | — | Profile value #f2f2f2. |
--forma-grid-success | Custom property | — | Profile value #5ee08f. |
--forma-grid-warning | Custom property | — | Profile value #ffe066. |
--forma-grid-validation | Custom property | — | Profile value #ff9ad5. |
--forma-grid-error | Custom property | — | Profile value #ff7a7a. |
| Keys | Result |
|---|---|
| Tab / Shift+Tab | Native, in row-major order. The profile does not add 3270 wraparound Tab or autoskip; those are optional application behavior. |
| PF1-PF24, PA1-PA3, Clear, Reset | Presented as key buttons; mapping physical keys to them is application or Limen behavior. |
Form behavior
Unchanged from Character grid: the surface is a native form and keys are native submitters.
States
| State | How it is expressed | Presentation |
|---|---|---|
| Profiled | data-forma-profile="ibm-3270" | 3279-style palette on a black screen with a darker viewport border and inset line. |
| Field focus | :focus-visible on a field | Standard outline plus a dark green field background and a block caret where caret-shape is supported. |
| Key focus | :focus-visible on a key | Standard outline plus a dark blue key background. |
| Device status row | data-forma-status-rows on the grid | A muted rule over the status row; the row is still a role="status" run with an indicator word. |
| Forced colors | forced-colors: active | Every profile token is projected to Canvas, CanvasText or Highlight, so no 3279 color survives on the forced Canvas; boundaries, focus and severity shapes remain. |
Accessibility
Forma provides
- Every profile color passes axe's WCAG AA color-contrast rule on the black screen.
- The profile never removes the focus outline; the block caret and focus backgrounds are added cues.
- Severity words and shape cues are unchanged, so meaning never depends on the 3279 colors.
- The status-row rule is stylistic and never the only cue.
Your application supplies
- Do not reproduce 3270 behaviors (uppercase, autoskip) silently; if you add them, implement and document them in the application.
- Keep the device status row for system status only and use a visible indicator word.
- Verify your screens with the conformance tool at the geometry you ship (24 by 80 or 32 by 80).
Responsive behavior
- Identical to the default grid: 80 columns are kept and the viewport scrolls horizontally on narrow screens.
- The touch pitch and short-field touch minimum apply unchanged under the profile.
- For 32 by 80 set
data-forma-rows="32", move reserved application rows to 29-32 and the status to row 33; nothing else changes.
Motion
- No animation is added by the profile. SequentialReveal works the same with or without it and is removed under reduced motion (see Character grid reveal).
Usage guidance
Do
- Treat the profile as a skin: author the screen against the default presentation, then add the attribute.
- Keep the 3270 key vocabulary (PF keys, Clear, Reset) with the profile.
Avoid
- Overriding profile tokens with lower-contrast colors.
- Claiming 3270 emulation; the profile is a visual evocation 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.