Command and keyboard-first

Character grid field

<forma-character-grid-field>

Protected text and native editable fields placed on a character grid with explicit capacity, preceding labels, and shape-based required, invalid, disabled, and read-only cues.

Authoring tag
<forma-character-grid-field>
Behavior owner
Native HTML
Canonical source
patterns/character-grid-field.html

Purpose

Character grid fields are the editable parts of a Character grid screen. Each field is a native input positioned on its cells, preceded by a label for run, with maxlength equal to its data-forma-len so the visible capacity and the real capacity agree. Everything that is not editable stays protected text. The browser owns typing, Tab order, maxlength, required and form submission; the application owns validation policy, aria-invalid, messages and initial focus.

Use when

  • A character-grid screen needs data entry: sign-on, inquiry criteria, record maintenance.
  • The field width must show its exact capacity in cells, as on a host screen.
  • Required, invalid, disabled and read-only states must stay distinguishable in grayscale and forced colors.

Avoid when

  • Showing a value the user cannot change: use protected forma-character-grid__value text, not a readonly input (CG-9).
  • Ordinary application forms outside a grid: use Text field, Select and Textarea.
  • A per-row option column in a list: use Character grid selection, which names each field by its column and row headers.

Behavior to know

  • Fields are exactly their declared cells wide and one row pitch tall; the value never pushes neighboring runs.
  • State cues differ in shape: solid underline (editable), double underline (required), dashed rules above and below (invalid), dotted underline (disabled), thin underline (read-only).
  • Leader dots in labels are aria-hidden, so the accessible name is "Account", not "Account dot dot dot colon".
  • Forma does not style :invalid; the application decides when a value is wrong and sets aria-invalid.

Basic example

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

Canonical

Minimal character grid field

Rendered from the canonical pattern file.

PAYMENT ENTRY

(required, 12 digits) Opened 2014-03-11

Error: Amount must contain digits only, e.g. 12480.55

HTML · Minimal character grid field Raw HTML for HTML · Minimal character grid field
<forma-character-grid-field class="forma-component-tag">
<div class="forma-character-grid" data-forma-rows="10" data-forma-columns="60" data-forma-narrow="contained">
  <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-field-title" tabindex="0">
    <form class="forma-character-grid__surface">
      <h2 class="forma-character-grid__text" id="character-grid-field-title" data-forma-row="1" data-forma-col="23" data-forma-len="14" data-forma-emphasis="intensified">PAYMENT ENTRY</h2>
      <label class="forma-character-grid__label" for="character-grid-field-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-field-account" name="account" type="text" inputmode="numeric" pattern="[0-9]*" maxlength="12" required aria-describedby="character-grid-field-account-hint" autocomplete="off" data-forma-row="3" data-forma-col="20" data-forma-len="12">
      <span class="forma-character-grid__text" id="character-grid-field-account-hint" data-forma-row="3" data-forma-col="34" data-forma-len="21" data-forma-emphasis="muted">(required, 12 digits)</span>
      <label class="forma-character-grid__label" for="character-grid-field-reference" data-forma-row="4" data-forma-col="2" data-forma-len="16">Reference<span class="forma-character-grid__leader" aria-hidden="true">  . . :</span></label>
      <input class="forma-character-grid__field" id="character-grid-field-reference" name="reference" type="text" maxlength="20" value="INV-1042" autocomplete="off" data-forma-row="4" data-forma-col="20" data-forma-len="20">
      <label class="forma-character-grid__label" for="character-grid-field-amount" data-forma-row="5" data-forma-col="2" data-forma-len="16">Amount<span class="forma-character-grid__leader" aria-hidden="true"> . . . . :</span></label>
      <input class="forma-character-grid__field" id="character-grid-field-amount" name="amount" type="text" inputmode="decimal" maxlength="12" value="12,48O.55" aria-invalid="true" aria-describedby="character-grid-field-error" autocomplete="off" data-forma-row="5" data-forma-col="20" data-forma-len="12">
      <label class="forma-character-grid__label" for="character-grid-field-branch" data-forma-row="6" 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-field-branch" name="branch" type="text" maxlength="8" value="NORTH" disabled data-forma-row="6" data-forma-col="20" data-forma-len="8">
      <span class="forma-character-grid__text" data-forma-row="7" data-forma-col="2" data-forma-len="16">Opened<span class="forma-character-grid__leader" aria-hidden="true"> . . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-row="7" data-forma-col="20" data-forma-len="10">2014-03-11</span>
      <label class="forma-character-grid__label" for="character-grid-field-session" data-forma-row="8" data-forma-col="2" data-forma-len="16">Session<span class="forma-character-grid__leader" aria-hidden="true">  . . . :</span></label>
      <input class="forma-character-grid__field" id="character-grid-field-session" name="session" type="text" maxlength="16" value="S-20260927-01" readonly data-forma-row="8" data-forma-col="20" data-forma-len="16">
      <p class="forma-character-grid__text" id="character-grid-field-error" data-forma-row="10" data-forma-col="2" data-forma-len="54">Error: Amount must contain digits only, e.g. 12480.55</p>
    </form>
  </div>
</div>
</forma-character-grid-field>

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

Examples

Scenario

Sign-on with required fields

Two required fields and one optional field. Password fields keep their native type and autocomplete tokens; each requirement is stated in a visible hint as well as by the double underline.

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.

SYSTEM SIGN ON

(required) (required) (optional, 8 max)

Passwords are case sensitive.

HTML · Sign-on with required fields Raw HTML for HTML · Sign-on with required fields
<forma-character-grid-field class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="8" data-forma-columns="50" data-forma-narrow="contained">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-field-sign-on-title" tabindex="0">
      <form class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-field-sign-on-title" data-forma-row="1" data-forma-col="19" data-forma-len="14" data-forma-emphasis="intensified">SYSTEM SIGN ON</h2>
        <label class="forma-character-grid__label" for="character-grid-field-sign-on-user" data-forma-row="3" data-forma-col="2" data-forma-len="16">User ID<span class="forma-character-grid__leader" aria-hidden="true"> . . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-sign-on-user" name="user" type="text" maxlength="8" required autocomplete="username" aria-describedby="character-grid-field-sign-on-user-hint" data-forma-row="3" data-forma-col="20" data-forma-len="8">
        <span class="forma-character-grid__text" id="character-grid-field-sign-on-user-hint" data-forma-row="3" data-forma-col="31" data-forma-len="10" data-forma-emphasis="muted">(required)</span>
        <label class="forma-character-grid__label" for="character-grid-field-sign-on-password" data-forma-row="4" data-forma-col="2" data-forma-len="16">Password<span class="forma-character-grid__leader" aria-hidden="true">  . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-sign-on-password" name="password" type="password" maxlength="8" required autocomplete="current-password" aria-describedby="character-grid-field-sign-on-password-hint" data-forma-row="4" data-forma-col="20" data-forma-len="8">
        <span class="forma-character-grid__text" id="character-grid-field-sign-on-password-hint" data-forma-row="4" data-forma-col="31" data-forma-len="10" data-forma-emphasis="muted">(required)</span>
        <label class="forma-character-grid__label" for="character-grid-field-sign-on-new" data-forma-row="5" data-forma-col="2" data-forma-len="16">New password<span class="forma-character-grid__leader" aria-hidden="true"> :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-sign-on-new" name="new-password" type="password" maxlength="8" autocomplete="new-password" aria-describedby="character-grid-field-sign-on-new-hint" data-forma-row="5" data-forma-col="20" data-forma-len="8">
        <span class="forma-character-grid__text" id="character-grid-field-sign-on-new-hint" data-forma-row="5" data-forma-col="31" data-forma-len="17" data-forma-emphasis="muted">(optional, 8 max)</span>
        <p class="forma-character-grid__text" data-forma-row="7" data-forma-col="2" data-forma-len="29">Passwords are case sensitive.</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-field>

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

Scenario

Validation error after Enter

The application rejected two values. Each invalid field has aria-invalid="true" and lists both its format hint and the shared message in aria-describedby. The message reserves two rows with data-forma-height because its length varies.

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.

CHANGE OF ADDRESS

Account 00417-2231-09 (99999-9999) (YYYY-MM-DD)
HTML · Validation error after Enter Raw HTML for HTML · Validation error after Enter
<forma-character-grid-field class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="10" data-forma-columns="60" data-forma-narrow="contained">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-field-address-validation-title" tabindex="0">
      <form class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-field-address-validation-title" data-forma-row="1" data-forma-col="22" data-forma-len="17" data-forma-emphasis="intensified">CHANGE OF ADDRESS</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>
        <label class="forma-character-grid__label" for="character-grid-field-address-validation-street" data-forma-row="4" data-forma-col="2" data-forma-len="16">Street<span class="forma-character-grid__leader" aria-hidden="true">  . . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-address-validation-street" name="street" type="text" maxlength="30" required value="1200 HARBOR VIEW DR" autocomplete="off" data-forma-row="4" data-forma-col="20" data-forma-len="30">
        <label class="forma-character-grid__label" for="character-grid-field-address-validation-postal" data-forma-row="5" data-forma-col="2" data-forma-len="16">Postal code<span class="forma-character-grid__leader" aria-hidden="true"> . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-address-validation-postal" name="postal" type="text" maxlength="10" required value="9720" aria-invalid="true" aria-describedby="character-grid-field-address-validation-postal-hint character-grid-field-address-validation-message" autocomplete="off" data-forma-row="5" data-forma-col="20" data-forma-len="10">
        <span class="forma-character-grid__text" id="character-grid-field-address-validation-postal-hint" data-forma-row="5" data-forma-col="32" data-forma-len="12" data-forma-emphasis="muted">(99999-9999)</span>
        <label class="forma-character-grid__label" for="character-grid-field-address-validation-date" data-forma-row="6" data-forma-col="2" data-forma-len="16">Move date<span class="forma-character-grid__leader" aria-hidden="true">  . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-address-validation-date" name="move-date" type="text" maxlength="10" value="2026-02-30" aria-invalid="true" aria-describedby="character-grid-field-address-validation-date-hint character-grid-field-address-validation-message" autocomplete="off" data-forma-row="6" data-forma-col="20" data-forma-len="10">
        <span class="forma-character-grid__text" id="character-grid-field-address-validation-date-hint" data-forma-row="6" data-forma-col="32" data-forma-len="12" data-forma-emphasis="muted">(YYYY-MM-DD)</span>
        <p class="forma-character-grid__message" id="character-grid-field-address-validation-message" role="alert" data-forma-severity="validation" data-forma-row="8" data-forma-col="2" data-forma-len="58" data-forma-height="2"><span class="forma-character-grid__severity"><span>CHECK</span></span> Postal code needs 5 or 9 digits. Move date is not a real date.</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="10" 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="10" data-forma-col="16" data-forma-len="11"><kbd>PF12</kbd>=Cancel</button>
        </div>
      </form>
    </div>
  </div>
</forma-character-grid-field>

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

Scenario

Short codes and touch spacing

One- and two-cell code fields. Each is followed by at least five blank cells before its hint (CG-13), so the 2.75rem touch minimum on phones paints into empty cells instead of covering the hint.

TRANSACTION ENTRY

(A=Add C=Change D=Delete) (two letters)
HTML · Short codes and touch spacing Raw HTML for HTML · Short codes and touch spacing
<forma-character-grid-field class="forma-component-tag">
  <div class="forma-character-grid" data-forma-rows="6" data-forma-columns="60" data-forma-narrow="contained">
    <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-field-short-codes-title" tabindex="0">
      <form class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-field-short-codes-title" data-forma-row="1" data-forma-col="22" data-forma-len="17" data-forma-emphasis="intensified">TRANSACTION ENTRY</h2>
        <label class="forma-character-grid__label" for="character-grid-field-short-codes-action" data-forma-row="3" data-forma-col="2" data-forma-len="16">Action code<span class="forma-character-grid__leader" aria-hidden="true"> . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-short-codes-action" name="action-code" type="text" maxlength="1" required pattern="[ACD]" aria-describedby="character-grid-field-short-codes-action-hint" autocomplete="off" data-forma-row="3" data-forma-col="20" data-forma-len="1">
        <span class="forma-character-grid__text" id="character-grid-field-short-codes-action-hint" data-forma-row="3" data-forma-col="26" data-forma-len="25" data-forma-emphasis="muted">(A=Add C=Change D=Delete)</span>
        <label class="forma-character-grid__label" for="character-grid-field-short-codes-region" data-forma-row="4" data-forma-col="2" data-forma-len="16">Region<span class="forma-character-grid__leader" aria-hidden="true">  . . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-short-codes-region" name="region" type="text" maxlength="2" value="NE" aria-describedby="character-grid-field-short-codes-region-hint" autocomplete="off" data-forma-row="4" data-forma-col="20" data-forma-len="2">
        <span class="forma-character-grid__text" id="character-grid-field-short-codes-region-hint" data-forma-row="4" data-forma-col="26" data-forma-len="13" data-forma-emphasis="muted">(two letters)</span>
        <label class="forma-character-grid__label" for="character-grid-field-short-codes-amount" data-forma-row="5" data-forma-col="2" data-forma-len="16">Amount<span class="forma-character-grid__leader" aria-hidden="true">  . . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-short-codes-amount" name="amount" type="text" inputmode="decimal" maxlength="12" autocomplete="off" data-forma-row="5" data-forma-col="20" data-forma-len="12">
      </form>
    </div>
  </div>
</forma-character-grid-field>

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

Payment entry on a phone

A small entry screen at phone width. Rows grow to the 44px touch pitch and the numeric field asks the on-screen keyboard for digits with inputmode.

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

  • Below 40rem the row pitch becomes 2.75rem, so each field is a 44px-tall target; field widths stay tied to their cells.
  • Fields shorter than 2.75rem get a minimum width that extends into the blank cells after them, never over the next run.
  • The 40-column grid fits most phones in portrait; wider grids scroll inside the viewport and the page does not scroll sideways.
  • inputmode="decimal" brings up a numeric keyboard; the visible capacity still matches maxlength.
HTML · Payment entry on a phone Raw HTML for HTML · Payment entry on a phone
<forma-character-grid-field 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-field-payment-mobile-title" tabindex="0">
      <form class="forma-character-grid__surface">
        <h2 class="forma-character-grid__text" id="character-grid-field-payment-mobile-title" data-forma-row="1" data-forma-col="14" data-forma-len="13" data-forma-emphasis="intensified">PAYMENT ENTRY</h2>
        <label class="forma-character-grid__label" for="character-grid-field-payment-mobile-amount" data-forma-row="3" data-forma-col="2" data-forma-len="12">Amount<span class="forma-character-grid__leader" aria-hidden="true"> . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-payment-mobile-amount" name="amount" type="text" inputmode="decimal" maxlength="10" required autocomplete="off" data-forma-row="3" data-forma-col="15" data-forma-len="10">
        <label class="forma-character-grid__label" for="character-grid-field-payment-mobile-reference" data-forma-row="4" data-forma-col="2" data-forma-len="12">Reference<span class="forma-character-grid__leader" aria-hidden="true"> :</span></label>
        <input class="forma-character-grid__field" id="character-grid-field-payment-mobile-reference" name="reference" type="text" maxlength="12" value="INV-1042" autocomplete="off" data-forma-row="4" data-forma-col="15" data-forma-len="12">
        <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="10"><kbd>Enter</kbd>=Pay</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="14" data-forma-len="8"><kbd>PF3</kbd>=Exit</button>
        </div>
      </form>
    </div>
  </div>
</forma-character-grid-field>

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
forlabel.forma-character-grid__labelid of the field—Required (CG-8). The label run must precede its field in source order.
typeinputtext | passwordtextNative input type. Keep password for secrets so the browser masks and protects the value.
maxlengthinputinteger—Required. Must equal data-forma-len, so visible capacity and real capacity agree (CG-8).
nameinputstring—Form field name submitted with the screen.
valueinputstringemptyInitial value rendered by the application.
requiredinputbooleanabsentNative requirement; draws a double underline. Also say "required" in the label or hint.
aria-invalidinputtrueabsentSet by the application after validation; draws dashed rules above and below. The field must also reference its message.
aria-describedbyinputone or more ids—Hint and, when invalid, the message ID: aria-describedby="hint message".
disabledinputbooleanabsentRemoves the field from Tab order and submission; dotted underline and muted text.
readonlyinputbooleanabsentOnly for genuine read-only form values the application reads back; thin underline, no surface. Otherwise use protected text.
inputmodeinputnumeric | decimal | …—Chooses the on-screen keyboard without changing validation.
patterninputregular expression—Optional native constraint. Forma does not style :invalid; the application reports errors.
autocompleteinputtoken—Use real tokens (username, current-password) or off for host codes.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
.forma-character-grid__labelElement class—Protected label run for a field. Keeps protected text color and a default cursor.
.forma-character-grid__leaderElement class—Decorative leader characters inside the label, muted and aria-hidden="true".
.forma-character-grid__fieldElement class—The native input run: field surface, bottom boundary, no radius, exactly its cells wide. Where field-sizing: content is supported it widens under text-spacing overrides.
.forma-character-grid__textElement class—Protected hint or prose run, commonly referenced by aria-describedby.
.forma-character-grid__valueElement class—Protected value. Use this, not a readonly input, for data the user cannot change.
[data-forma-len]Attribute hook—Field width in cells; must equal maxlength.
[aria-invalid]Attribute hook—true draws the invalid cue: dashed rules above and below in --forma-grid-validation.
--forma-grid-fieldCustom property—Field text color.
--forma-grid-field-surfaceCustom property—Field background. Disabled and read-only fields are transparent.
--forma-grid-boundaryCustom property—Field underline color.
--forma-grid-validationCustom property—Color of the invalid rules and validation messages.
--forma-grid-focusCustom property—Focus outline color.
Keyboard interaction
KeysResult
Tab / Shift+TabMoves between fields in row-major order, skipping disabled fields natively.
TypingNative text entry, stopped at maxlength.
EnterNative implicit submission through the form's first submit button (the Enter key in Character grid keys).
Events
EventDescription
input / changeNative events from the field.
invalidNative event when required or pattern blocks submission. The application still sets aria-invalid and the message.

Form behavior

Fields are native form controls: named values submit with the surface form, required blocks a submit key without formnovalidate, disabled fields do not submit, and readonly fields do.

States

Character grid field states
StateHow it is expressedPresentation
Editableinput.forma-character-grid__fieldField surface with a solid 2px bottom boundary.
Requiredrequired / :requiredDouble 4px bottom boundary. The label or hint also says required.
Invalidaria-invalid="true"Dashed rules above and below, with no inline border, so the field stays exactly its cells.
Disableddisabled / :disabledDotted bottom boundary, transparent surface, muted text, not-allowed cursor; skipped by Tab.
Read-onlyreadonly / :read-onlyThin 1px bottom boundary and no surface.
Focus:focus-visible2px outline in --forma-grid-focus; Highlight in forced colors. Profiles may add a caret treatment but not remove the outline.

Accessibility

Forma provides

  • Keeps fields native, so name, role, value, required and disabled state come from the platform.
  • Hides leader characters from the accessible name with the markup contract aria-hidden="true".
  • Distinguishes states by boundary shape, not only color; in forced colors boundaries use CanvasText and disabled text uses GrayText.
  • Rows are at least 24px; on narrow or coarse-pointer screens fields are at least 44px tall and 2.75rem wide.

Your application supplies

  • Precede every field with a label for run and keep maxlength equal to data-forma-len.
  • After validation set aria-invalid="true" and add the message ID to aria-describedby; clear both when the value is fixed.
  • State requirements and formats in visible text, not only through the underline.
  • Choose initial focus when the screen appears, typically the first invalid field, otherwise the first field.
  • Leave at least five cells between a field shorter than five cells and the next run (CG-13).

Responsive behavior

  • Fields are exactly data-forma-len cells wide and one row pitch tall at every width.
  • Below 40rem or on a coarse pointer, fields and rows reach 44px; short fields paint into the blank cells after them without widening the tracks.
  • Under text-spacing overrides, supporting browsers widen the field to its value (field-sizing: content); others scroll the value inside the field.
  • Narrow-screen containment or reflow is set on the grid; see Character grid.

Motion

  • No animation: state cues and focus appear immediately.
  • Fields are never part of SequentialReveal; only protected text can reveal.

Usage guidance

Do

  • Use protected text for everything the user cannot edit.
  • Keep hints short and on the same row after the field, leaving blank cells between.

Avoid

  • Styling a div or span to look like a field.
  • Relying on :invalid or color alone to report errors.
  • Readonly inputs for display values; they are focusable and announced as edit fields.

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.