Command and keyboard-first

Character grid workflow

<forma-character-grid-workflow>

Customer Inquiry, Account Detail, and Transaction History built only from public CharacterGrid contracts; transitions stay in the application.

Authoring tag
<forma-character-grid-workflow>
Behavior owner
Application / Limen / Ordo
Canonical source
patterns/character-grid-workflow.html

Purpose

The reference workflow shows three linked 24 by 80 screens in the Character grid 3270 profile profile: Customer Inquiry (CINQ) with six search fields, Account Detail (ACCD) with protected data only, and Transaction History (TRNH) with date fields and a positioned 12-row table. It uses only public forma-character-grid* classes and forma-stack, with no inline style and no product CSS. The screens are independent grids on one page: moving between them is application or Limen behavior driven by the native submitter value, and whether a transition is legal (for example, whether a restricted account may be displayed) is Ordo or application-domain state.

Use when

  • Planning a multi-screen host re-platforming and you need a worked example of fields, protected data, tables, keys and messages together.
  • Checking which parts of a flow Forma presents and which the application must implement.
  • Rendering application states (validation, empty, service error) of a character-grid screen.

Avoid when

  • Building a single screen: start from Character grid and the family pages.
  • Multi-step forms outside a character grid: use Wizard or Steps.
  • Expecting Forma to move between screens: there is no navigation behavior in the markup.

Behavior to know

  • Each screen has its own named region, form surface, message run on row 21, keys on rows 22-23 and the Operator Information Area on row 25.
  • Only the CINQ title uses SequentialReveal (data-forma-reveal-rows="1").
  • Transitions follow the submitter: CINQ Enter goes to ACCD when exactly one customer matches, ACCD PF5 to TRNH, TRNH PF3 back to ACCD, PF12 to CINQ.
  • Application states are rendered by changing values, aria-invalid, message content and the status indicator, never the structure.

Basic example

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

Canonical

Minimal character grid workflow

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.

CINQ

CUSTOMER INQUIRY

Date: 2026-09-27 System: ECHT01 Operator: OP0142

Enter one or more search criteria, then press Enter.

(YYYY-MM-DD)

At least one criterion is required. Last names match from the first letter.

INFO CINQ000I Type search criteria and press Enter.

READY

ACCD

ACCOUNT DETAIL

Date: 2026-09-27 System: ECHT01 Operator: OP0142 Customer 0001042778 Name RIVERA, ALEX J Address 1200 HARBOR VIEW DRIVE APT 4B PORTLAND OR 97209-3311 Phone not on file

ACCOUNT

Account number 00417-2231-09 Type CHECKING Status ACTIVE Opened 2014-03-11 Currency USD

BALANCES

Ledger balance 12,480.55 Available 12,230.55 Holds 250.00 Overdraft 1,000.00 Last statement 2026-08-31

INFO ACCD000I Account 00417-2231-09 displayed.

READY

TRNH

TRANSACTION HISTORY

Date: 2026-09-27 System: ECHT01 Operator: OP0142 Account 00417-2231-09
Transactions for account 00417-2231-09, newest first
DateDescriptionAmountBalanceStatus
2026-09-26PAYROLL DEPOSIT ACME CORP2,450.0012,480.55POSTED
2026-09-25CARD 4411 CITY MARKET-86.1210,030.55POSTED
2026-09-25CARD 4411 FUEL STOP 118-52.4010,116.67POSTED
2026-09-24TRANSFER TO SAVINGS 7710-500.0010,169.07POSTED
2026-09-23CHECK 1043-1,200.0010,669.07POSTED
2026-09-22ACH ELECTRIC UTILITY-143.8811,869.07POSTED
2026-09-22CARD 4411 BOOKSHOP-24.9912,012.95PENDING
2026-09-20ATM WITHDRAWAL 0931-200.0012,037.94POSTED
2026-09-19CHECK 1041-310.0012,237.94RETURNED
2026-09-18ONLINE PAYMENT CREDIT CARD-640.0012,547.94POSTED
2026-09-17INTEREST CREDIT1.3713,187.94POSTED
2026-09-15CARD 4411 PHARMACY-18.4513,186.57REVERSED
Rows 1-12 of 37 More: +

INFO TRNH000I 37 transactions from 2026-08-01 to 2026-09-27.

READY

HTML · Minimal character grid workflow Raw HTML for HTML · Minimal character grid workflow
<forma-character-grid-workflow class="forma-component-tag">
<div class="forma-stack">
<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" data-forma-reveal="sequential" data-forma-reveal-rows="1">
  <div class="forma-character-grid__viewport" role="region" aria-labelledby="character-grid-workflow-cinq-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">CINQ</span>
      <h2 class="forma-character-grid__text" id="character-grid-workflow-cinq-title" data-forma-reveal-run data-forma-emphasis="intensified" data-forma-row="1" data-forma-col="33" data-forma-len="16">CUSTOMER INQUIRY</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="52">Enter one or more search criteria, then press Enter.</p>
      <label class="forma-character-grid__label" for="character-grid-workflow-cinq-custno" data-forma-row="6" data-forma-col="2" data-forma-len="23">Customer number<span class="forma-character-grid__leader" aria-hidden="true"> . . . .</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-cinq-custno" name="custno" type="text" maxlength="10" autocomplete="off" inputmode="numeric" data-forma-row="6" data-forma-col="26" data-forma-len="10">
      <label class="forma-character-grid__label" for="character-grid-workflow-cinq-last" data-forma-row="7" data-forma-col="2" data-forma-len="23">Last name<span class="forma-character-grid__leader" aria-hidden="true"> . . . . . . .</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-cinq-last" name="last" type="text" maxlength="20" autocomplete="off" data-forma-row="7" data-forma-col="26" data-forma-len="20">
      <label class="forma-character-grid__label" for="character-grid-workflow-cinq-first" data-forma-row="8" data-forma-col="2" data-forma-len="23">First name<span class="forma-character-grid__leader" aria-hidden="true">  . . . . . .</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-cinq-first" name="first" type="text" maxlength="15" autocomplete="off" data-forma-row="8" data-forma-col="26" data-forma-len="15">
      <label class="forma-character-grid__label" for="character-grid-workflow-cinq-dob" data-forma-row="9" data-forma-col="2" data-forma-len="23">Date of birth<span class="forma-character-grid__leader" aria-hidden="true"> . . . . .</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-cinq-dob" name="dob" type="text" maxlength="10" autocomplete="off" aria-describedby="character-grid-workflow-cinq-dob-hint" data-forma-row="9" data-forma-col="26" data-forma-len="10">
      <span class="forma-character-grid__text" id="character-grid-workflow-cinq-dob-hint" data-forma-emphasis="muted" data-forma-row="9" data-forma-col="38" data-forma-len="12">(YYYY-MM-DD)</span>
      <label class="forma-character-grid__label" for="character-grid-workflow-cinq-postal" data-forma-row="10" data-forma-col="2" data-forma-len="23">Postal code<span class="forma-character-grid__leader" aria-hidden="true"> . . . . . .</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-cinq-postal" name="postal" type="text" maxlength="10" autocomplete="off" data-forma-row="10" data-forma-col="26" data-forma-len="10">
      <label class="forma-character-grid__label" for="character-grid-workflow-cinq-acct" data-forma-row="11" data-forma-col="2" data-forma-len="23">Account number<span class="forma-character-grid__leader" aria-hidden="true">  . . . .</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-cinq-acct" name="acct" type="text" maxlength="14" autocomplete="off" data-forma-row="11" data-forma-col="26" data-forma-len="14">
      <p class="forma-character-grid__text" data-forma-row="13" data-forma-col="2" data-forma-len="75">At least one criterion is required. Last names match from the first letter.</p>
      <p class="forma-character-grid__message" id="character-grid-workflow-cinq-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> CINQ000I Type search criteria 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="22" data-forma-col="2" data-forma-len="12"><kbd>Enter</kbd>=Search</button>
        <button class="forma-character-grid__key" type="submit" name="action" value="clear" formnovalidate data-forma-action="clear" data-forma-row="22" data-forma-col="16" data-forma-len="11"><kbd>Clear</kbd>=Erase</button>
        <button class="forma-character-grid__key" type="button" data-forma-action="reset" data-forma-row="22" data-forma-col="29" data-forma-len="12"><kbd>Reset</kbd>=Unlock</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="43" 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="53" data-forma-len="8"><kbd>PF3</kbd>=Exit</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>
<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-workflow-accd-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">ACCD</span>
      <h2 class="forma-character-grid__text" id="character-grid-workflow-accd-title" data-forma-emphasis="intensified" data-forma-row="1" data-forma-col="34" data-forma-len="14">ACCOUNT DETAIL</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>
      <span class="forma-character-grid__text" data-forma-row="4" data-forma-col="2" data-forma-len="17">Customer<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">0001042778</span>
      <span class="forma-character-grid__text" data-forma-row="4" data-forma-col="34" data-forma-len="12">Name<span class="forma-character-grid__leader" aria-hidden="true"> . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-row="4" data-forma-col="47" data-forma-len="30">RIVERA, ALEX J</span>
      <span class="forma-character-grid__text" data-forma-row="5" data-forma-col="2" data-forma-len="17">Address<span class="forma-character-grid__leader" aria-hidden="true"> . . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-row="5" data-forma-col="20" data-forma-len="40">1200 HARBOR VIEW DRIVE APT 4B</span>
      <span class="forma-character-grid__value" data-forma-row="6" data-forma-col="20" data-forma-len="40">PORTLAND OR 97209-3311</span>
      <span class="forma-character-grid__text" data-forma-row="7" data-forma-col="2" data-forma-len="17">Phone<span class="forma-character-grid__leader" aria-hidden="true"> . . . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-state="missing" data-forma-row="7" data-forma-col="20" data-forma-len="14">not on file</span>
      <h3 class="forma-character-grid__text" data-forma-emphasis="intensified" data-forma-row="9" data-forma-col="2" data-forma-len="7">ACCOUNT</h3>
      <span class="forma-character-grid__text" data-forma-row="10" data-forma-col="2" data-forma-len="17">Account number<span class="forma-character-grid__leader" aria-hidden="true">  :</span></span>
      <span class="forma-character-grid__value" data-forma-row="10" data-forma-col="20" data-forma-len="14">00417-2231-09</span>
      <span class="forma-character-grid__text" data-forma-row="10" data-forma-col="42" data-forma-len="12">Type<span class="forma-character-grid__leader" aria-hidden="true"> . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-row="10" data-forma-col="55" data-forma-len="12">CHECKING</span>
      <span class="forma-character-grid__text" data-forma-row="11" data-forma-col="2" data-forma-len="17">Status<span class="forma-character-grid__leader" aria-hidden="true">  . . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-row="11" data-forma-col="20" data-forma-len="10">ACTIVE</span>
      <span class="forma-character-grid__text" data-forma-row="11" data-forma-col="42" data-forma-len="12">Opened<span class="forma-character-grid__leader" aria-hidden="true"> . . :</span></span>
      <span class="forma-character-grid__value" data-forma-row="11" data-forma-col="55" data-forma-len="10">2014-03-11</span>
      <span class="forma-character-grid__text" data-forma-row="12" data-forma-col="2" data-forma-len="17">Currency<span class="forma-character-grid__leader" aria-hidden="true">  . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-row="12" data-forma-col="20" data-forma-len="3">USD</span>
      <h3 class="forma-character-grid__text" data-forma-emphasis="intensified" data-forma-row="14" data-forma-col="2" data-forma-len="8">BALANCES</h3>
      <span class="forma-character-grid__text" data-forma-row="15" data-forma-col="2" data-forma-len="17">Ledger balance<span class="forma-character-grid__leader" aria-hidden="true">  :</span></span>
      <span class="forma-character-grid__value" data-forma-align="end" data-forma-row="15" data-forma-col="20" data-forma-len="15">12,480.55</span>
      <span class="forma-character-grid__text" data-forma-row="15" data-forma-col="42" data-forma-len="11">Available<span class="forma-character-grid__leader" aria-hidden="true"> :</span></span>
      <span class="forma-character-grid__value" data-forma-align="end" data-forma-row="15" data-forma-col="55" data-forma-len="15">12,230.55</span>
      <span class="forma-character-grid__text" data-forma-row="16" data-forma-col="2" data-forma-len="17">Holds<span class="forma-character-grid__leader" aria-hidden="true"> . . . . . :</span></span>
      <span class="forma-character-grid__value" data-forma-align="end" data-forma-row="16" data-forma-col="20" data-forma-len="15">250.00</span>
      <span class="forma-character-grid__text" data-forma-row="16" data-forma-col="42" data-forma-len="11">Overdraft<span class="forma-character-grid__leader" aria-hidden="true"> :</span></span>
      <span class="forma-character-grid__value" data-forma-align="end" data-forma-row="16" data-forma-col="55" data-forma-len="15">1,000.00</span>
      <span class="forma-character-grid__text" data-forma-row="18" data-forma-col="2" data-forma-len="17">Last statement<span class="forma-character-grid__leader" aria-hidden="true">  :</span></span>
      <span class="forma-character-grid__value" data-forma-row="18" data-forma-col="20" data-forma-len="10">2026-08-31</span>
      <p class="forma-character-grid__message" id="character-grid-workflow-accd-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> ACCD000I Account 00417-2231-09 displayed.</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="13"><kbd>Enter</kbd>=Refresh</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="17" data-forma-len="10"><kbd>PF3</kbd>=Return</button>
        <button class="forma-character-grid__key" type="submit" name="action" value="pf5" formnovalidate data-forma-action="pf5" data-forma-row="22" data-forma-col="29" data-forma-len="16"><kbd>PF5</kbd>=Transactions</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="47" data-forma-len="12"><kbd>PF12</kbd>=Inquiry</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="61" data-forma-len="8"><kbd>PF1</kbd>=Help</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>
<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-workflow-trnh-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">TRNH</span>
      <h2 class="forma-character-grid__text" id="character-grid-workflow-trnh-title" data-forma-emphasis="intensified" data-forma-row="1" data-forma-col="31" data-forma-len="19">TRANSACTION HISTORY</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>
      <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="11">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="14" data-forma-len="14">00417-2231-09</span>
      <label class="forma-character-grid__label" for="character-grid-workflow-trnh-from" data-forma-row="3" data-forma-col="32" data-forma-len="11">From<span class="forma-character-grid__leader" aria-hidden="true">  . . :</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-trnh-from" name="from" type="text" maxlength="10" autocomplete="off" value="2026-08-01" required data-forma-row="3" data-forma-col="44" data-forma-len="10">
      <label class="forma-character-grid__label" for="character-grid-workflow-trnh-to" data-forma-row="3" data-forma-col="57" data-forma-len="4">To<span class="forma-character-grid__leader" aria-hidden="true"> :</span></label>
      <input class="forma-character-grid__field" id="character-grid-workflow-trnh-to" name="to" type="text" maxlength="10" autocomplete="off" value="2026-09-27" required data-forma-row="3" data-forma-col="62" data-forma-len="10">
      <div class="forma-character-grid__table" data-forma-row="5" data-forma-col="2" data-forma-len="77" data-forma-height="13">
        <table data-forma-gutter="2">
          <caption>Transactions for account 00417-2231-09, newest first</caption>
          <thead><tr><th scope="col" data-forma-len="10">Date</th><th scope="col" data-forma-len="27">Description</th><th scope="col" data-forma-len="12" data-forma-align="end">Amount</th><th scope="col" data-forma-len="12" data-forma-align="end">Balance</th><th scope="col" data-forma-len="8">Status</th></tr></thead>
          <tbody>
          <tr><td>2026-09-26</td><td>PAYROLL DEPOSIT ACME CORP</td><td data-forma-align="end">2,450.00</td><td data-forma-align="end">12,480.55</td><td>POSTED</td></tr>
          <tr><td>2026-09-25</td><td>CARD 4411 CITY MARKET</td><td data-forma-align="end">-86.12</td><td data-forma-align="end">10,030.55</td><td>POSTED</td></tr>
          <tr><td>2026-09-25</td><td>CARD 4411 FUEL STOP 118</td><td data-forma-align="end">-52.40</td><td data-forma-align="end">10,116.67</td><td>POSTED</td></tr>
          <tr><td>2026-09-24</td><td>TRANSFER TO SAVINGS 7710</td><td data-forma-align="end">-500.00</td><td data-forma-align="end">10,169.07</td><td>POSTED</td></tr>
          <tr><td>2026-09-23</td><td>CHECK 1043</td><td data-forma-align="end">-1,200.00</td><td data-forma-align="end">10,669.07</td><td>POSTED</td></tr>
          <tr><td>2026-09-22</td><td>ACH ELECTRIC UTILITY</td><td data-forma-align="end">-143.88</td><td data-forma-align="end">11,869.07</td><td>POSTED</td></tr>
          <tr><td>2026-09-22</td><td>CARD 4411 BOOKSHOP</td><td data-forma-align="end">-24.99</td><td data-forma-align="end">12,012.95</td><td>PENDING</td></tr>
          <tr><td>2026-09-20</td><td>ATM WITHDRAWAL 0931</td><td data-forma-align="end">-200.00</td><td data-forma-align="end">12,037.94</td><td>POSTED</td></tr>
          <tr><td>2026-09-19</td><td>CHECK 1041</td><td data-forma-align="end">-310.00</td><td data-forma-align="end">12,237.94</td><td>RETURNED</td></tr>
          <tr><td>2026-09-18</td><td>ONLINE PAYMENT CREDIT CARD</td><td data-forma-align="end">-640.00</td><td data-forma-align="end">12,547.94</td><td>POSTED</td></tr>
          <tr><td>2026-09-17</td><td>INTEREST CREDIT</td><td data-forma-align="end">1.37</td><td data-forma-align="end">13,187.94</td><td>POSTED</td></tr>
          <tr><td>2026-09-15</td><td>CARD 4411 PHARMACY</td><td data-forma-align="end">-18.45</td><td data-forma-align="end">13,186.57</td><td>REVERSED</td></tr>
          </tbody>
        </table>
      </div>
      <span class="forma-character-grid__text" id="character-grid-workflow-trnh-position" data-forma-row="19" data-forma-col="2" data-forma-len="15">Rows 1-12 of 37</span>
      <span class="forma-character-grid__text" data-forma-row="19" data-forma-col="72" data-forma-len="7">More: +</span>
      <p class="forma-character-grid__message" id="character-grid-workflow-trnh-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> TRNH000I 37 transactions from 2026-08-01 to 2026-09-27.</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="17"><kbd>Enter</kbd>=Apply dates</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="21" data-forma-len="10"><kbd>PF3</kbd>=Return</button>
        <button class="forma-character-grid__key" type="submit" name="action" value="pf7" formnovalidate data-forma-action="pf7" data-forma-row="22" data-forma-col="33" data-forma-len="8"><kbd>PF7</kbd>=Back</button>
        <button class="forma-character-grid__key" type="submit" name="action" value="pf8" formnovalidate data-forma-action="pf8" data-forma-row="22" data-forma-col="43" data-forma-len="11"><kbd>PF8</kbd>=Forward</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="56" data-forma-len="12"><kbd>PF12</kbd>=Inquiry</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>
        <button class="forma-character-grid__key" type="submit" name="action" value="pf1" formnovalidate data-forma-action="pf1" data-forma-row="23" data-forma-col="17" data-forma-len="8"><kbd>PF1</kbd>=Help</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>
</div>
</forma-character-grid-workflow>

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

Examples

Scenario

Inquiry validation

The application rejected the date of birth after Enter. The field has aria-invalid="true" and is described by its format hint and the message, which becomes role="alert" with the INVALID severity word. The insert cursor (initial focus) would go to this field; that is application behavior.

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.

CINQ

CUSTOMER INQUIRY

Date: 2026-09-30

Enter one or more search criteria, then press Enter.

(YYYY-MM-DD)

READY

HTML · Inquiry validation Raw HTML for HTML · Inquiry validation
<forma-character-grid-workflow 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-workflow-inquiry-validation-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">CINQ</span>
        <h2 class="forma-character-grid__text" id="character-grid-workflow-inquiry-validation-title" data-forma-emphasis="intensified" data-forma-row="1" data-forma-col="33" data-forma-len="16">CUSTOMER INQUIRY</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-30</span>
        <p class="forma-character-grid__text" data-forma-row="4" data-forma-col="2" data-forma-len="52">Enter one or more search criteria, then press Enter.</p>
        <label class="forma-character-grid__label" for="character-grid-workflow-inquiry-validation-last" data-forma-row="6" data-forma-col="2" data-forma-len="23">Last name<span class="forma-character-grid__leader" aria-hidden="true"> . . . . . . .</span></label>
        <input class="forma-character-grid__field" id="character-grid-workflow-inquiry-validation-last" name="last" type="text" maxlength="20" value="RIVERA" autocomplete="off" data-forma-row="6" data-forma-col="26" data-forma-len="20">
        <label class="forma-character-grid__label" for="character-grid-workflow-inquiry-validation-dob" data-forma-row="7" data-forma-col="2" data-forma-len="23">Date of birth<span class="forma-character-grid__leader" aria-hidden="true"> . . . . .</span></label>
        <input class="forma-character-grid__field" id="character-grid-workflow-inquiry-validation-dob" name="dob" type="text" maxlength="10" value="2026-02-30" aria-invalid="true" aria-describedby="character-grid-workflow-inquiry-validation-dob-hint character-grid-workflow-inquiry-validation-message" autocomplete="off" data-forma-row="7" data-forma-col="26" data-forma-len="10">
        <span class="forma-character-grid__text" id="character-grid-workflow-inquiry-validation-dob-hint" data-forma-emphasis="muted" data-forma-row="7" data-forma-col="38" data-forma-len="12">(YYYY-MM-DD)</span>
        <label class="forma-character-grid__label" for="character-grid-workflow-inquiry-validation-postal" data-forma-row="8" data-forma-col="2" data-forma-len="23">Postal code<span class="forma-character-grid__leader" aria-hidden="true"> . . . . . .</span></label>
        <input class="forma-character-grid__field" id="character-grid-workflow-inquiry-validation-postal" name="postal" type="text" maxlength="10" autocomplete="off" data-forma-row="8" data-forma-col="26" data-forma-len="10">
        <p class="forma-character-grid__message" id="character-grid-workflow-inquiry-validation-message" role="alert" data-forma-severity="validation" data-forma-row="21" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>INVALID</span></span> CINQ003E Date of birth 2026-02-30 is not a valid 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="22" data-forma-col="2" data-forma-len="12"><kbd>Enter</kbd>=Search</button>
          <button class="forma-character-grid__key" type="submit" name="action" value="clear" formnovalidate data-forma-action="clear" data-forma-row="22" data-forma-col="16" data-forma-len="11"><kbd>Clear</kbd>=Erase</button>
          <button class="forma-character-grid__key" type="button" data-forma-action="reset" data-forma-row="22" data-forma-col="29" data-forma-len="12"><kbd>Reset</kbd>=Unlock</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="43" data-forma-len="8"><kbd>PF3</kbd>=Exit</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-workflow>

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

Scenario

History with no transactions

Transaction History after the user narrowed the dates. The table states the empty result in one full-width row, the paging position says 0 of 0 and the information message confirms the period. PF7 and PF8 are omitted because there is nothing to page.

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.

TRNH

TRANSACTION HISTORY

Account 00417-2231-09
Transactions for account 00417-2231-09, newest first
DateDescriptionAmountBalanceStatus
No transactions between 2026-09-28 and 2026-09-30.
Rows 0 of 0

INFO TRNH004I No transactions in the selected period.

READY

HTML · History with no transactions Raw HTML for HTML · History with no transactions
<forma-character-grid-workflow 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-workflow-history-empty-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">TRNH</span>
        <h2 class="forma-character-grid__text" id="character-grid-workflow-history-empty-title" data-forma-emphasis="intensified" data-forma-row="1" data-forma-col="31" data-forma-len="19">TRANSACTION HISTORY</h2>
        <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="11">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="14" data-forma-len="14">00417-2231-09</span>
        <label class="forma-character-grid__label" for="character-grid-workflow-history-empty-from" data-forma-row="3" data-forma-col="32" data-forma-len="11">From<span class="forma-character-grid__leader" aria-hidden="true">  . . :</span></label>
        <input class="forma-character-grid__field" id="character-grid-workflow-history-empty-from" name="from" type="text" maxlength="10" value="2026-09-28" required autocomplete="off" data-forma-row="3" data-forma-col="44" data-forma-len="10">
        <label class="forma-character-grid__label" for="character-grid-workflow-history-empty-to" data-forma-row="3" data-forma-col="57" data-forma-len="4">To<span class="forma-character-grid__leader" aria-hidden="true"> :</span></label>
        <input class="forma-character-grid__field" id="character-grid-workflow-history-empty-to" name="to" type="text" maxlength="10" value="2026-09-30" required autocomplete="off" data-forma-row="3" data-forma-col="62" data-forma-len="10">
        <div class="forma-character-grid__table" data-forma-row="5" data-forma-col="2" data-forma-len="77" data-forma-height="13">
          <table data-forma-gutter="2">
            <caption>Transactions for account 00417-2231-09, newest first</caption>
            <thead><tr><th scope="col" data-forma-len="10">Date</th><th scope="col" data-forma-len="27">Description</th><th scope="col" data-forma-len="12" data-forma-align="end">Amount</th><th scope="col" data-forma-len="12" data-forma-align="end">Balance</th><th scope="col" data-forma-len="8">Status</th></tr></thead>
            <tbody>
            <tr><td colspan="5">No transactions between 2026-09-28 and 2026-09-30.</td></tr>
            </tbody>
          </table>
        </div>
        <span class="forma-character-grid__text" data-forma-row="19" data-forma-col="2" data-forma-len="15">Rows 0 of 0</span>
        <p class="forma-character-grid__message" id="character-grid-workflow-history-empty-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> TRNH004I No transactions in the selected period.</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="17"><kbd>Enter</kbd>=Apply dates</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="21" data-forma-len="10"><kbd>PF3</kbd>=Return</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="33" data-forma-len="12"><kbd>PF12</kbd>=Inquiry</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-workflow>

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

Service error on a phone

Transaction History when the transaction service failed, at phone width. The table says the history is unavailable, the error message is an alert, and the Operator Information Area shows X SYSTEM until Reset.

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.

Viewport width

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

What changes at narrow widths

  • Each 80-column screen scrolls horizontally inside its own named viewport; the page scrolls only vertically between screens.
  • The severity word, the Reset key and the status indicator all start at column 2, so the recovery path is visible without scrolling sideways.
  • Rows grow to 44px at the touch pitch, so a 24-row screen is tall; the message and keys are near the bottom and reached by normal page scrolling.
  • Landscape shows more columns of each row; positions and focus order do not change.
HTML · Service error on a phone Raw HTML for HTML · Service error on a phone
<forma-character-grid-workflow 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-workflow-history-error-mobile-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">TRNH</span>
        <h2 class="forma-character-grid__text" id="character-grid-workflow-history-error-mobile-title" data-forma-emphasis="intensified" data-forma-row="1" data-forma-col="31" data-forma-len="19">TRANSACTION HISTORY</h2>
        <span class="forma-character-grid__text" data-forma-row="3" data-forma-col="2" data-forma-len="11">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="14" data-forma-len="14">00417-2231-09</span>
        <div class="forma-character-grid__table" data-forma-row="5" data-forma-col="2" data-forma-len="77" data-forma-height="13">
          <table data-forma-gutter="2">
            <caption>Transactions for account 00417-2231-09, newest first</caption>
            <thead><tr><th scope="col" data-forma-len="10">Date</th><th scope="col" data-forma-len="27">Description</th><th scope="col" data-forma-len="12" data-forma-align="end">Amount</th><th scope="col" data-forma-len="12" data-forma-align="end">Balance</th><th scope="col" data-forma-len="8">Status</th></tr></thead>
            <tbody>
            <tr><td colspan="5">Transaction history is unavailable.</td></tr>
            </tbody>
          </table>
        </div>
        <span class="forma-character-grid__text" data-forma-row="19" data-forma-col="2" data-forma-len="15">Rows unknown</span>
        <p class="forma-character-grid__message" id="character-grid-workflow-history-error-mobile-message" role="alert" data-forma-severity="error" data-forma-row="21" data-forma-col="2" data-forma-len="78"><span class="forma-character-grid__severity"><span>ERROR</span></span> TRNH009E Transaction 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" data-forma-action="enter" data-forma-row="22" data-forma-col="2" data-forma-len="11"><kbd>Enter</kbd>=Retry</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="15" data-forma-len="10"><kbd>PF3</kbd>=Return</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" data-forma-state="inhibited"><span>X SYSTEM</span></span></p>
      </form>
    </div>
  </div>
</forma-character-grid-workflow>

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.

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.

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
valuesubmit keys named actionenter | clear | pf3 | pf5 | pf7 | pf8 | pf12—The submitter value the application reads to choose the next screen.
aria-invalidfieldtrueabsentSet by the application on a field it rejected, together with the message ID in aria-describedby.
colspantd5—Full-width empty or unavailable row in the history table.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
[data-forma-profile]Attribute hook—Every workflow screen uses ibm-3270.
[data-forma-status-rows]Attribute hook—1: the Operator Information Area on row 25.
[data-forma-reveal]Attribute hook—sequential on the CINQ grid only, with data-forma-reveal-rows="1" so only the title row is timed.
[data-forma-action]Attribute hook—Names each key's action; the application maps it to a transition.
[data-forma-severity]Attribute hook—Message severity rendered by the application for the current state.
[data-forma-state]Attribute hook—inhibited on the status indicator while the service is unavailable; missing on ACCD values that are not on file.
.forma-character-grid__tableElement class—The TRNH 12-row positioned table with a two-cell gutter.
.forma-stackBlock class—The canonical pattern stacks the three independent grids vertically.
Keyboard interaction
KeysResult
Tab / Shift+TabCINQ: region, six fields, then keys. ACCD (no fields): region straight to its keys. TRNH: region, two date fields, keys. Tab can always leave each grid.
Enter in a fieldImplicit submission through the Enter key of that screen.
PF keysPresent as buttons; physical F-key mapping is application or Limen behavior.
Events
EventDescription
submitNative event per screen. The application reads event.submitter.dataset.formaAction, asks the domain whether the transition is legal, and renders the next screen or the same screen with a message.

Form behavior

Each screen is its own native form. Clear and PF keys use formnovalidate; the two TRNH date fields are required, so Enter is blocked natively until both have values.

States

Character grid workflow states
StateHow it is expressedPresentation
Defaultcanonical patternCINQ with an information message, ACCD with protected data, TRNH with 12 of 37 rows.
Inquiry validationaria-invalid plus a validation message with role=alertThe invalid field is described by its hint and the message.
Inquiry no criteriaerror message with role=alertCINQ001E asks for at least one criterion.
History emptyone td colspan row and an information messageThe empty period is stated in words; paging shows 0 of 0.
History errorerror message and data-forma-state="inhibited" on the indicatorThe table says history is unavailable and the OIA shows X SYSTEM.

Accessibility

Forma provides

  • Each screen is a separately named region, so screen reader users can move between screens by landmark.
  • Every state passes the conformance checks and axe in the repository's workflow tests.
  • Focus order on every screen is row-major without tabindex.
  • Messages keep visible severity words and shape cues under the 3270 palette and in forced colors.

Your application supplies

  • Implement transitions from the submitter value and keep legality in Ordo or domain state.
  • Set initial focus on each new screen: first invalid field, otherwise first field, otherwise the region.
  • Replace message content in place so the change is announced; do not recreate the message element.
  • Start the CINQ title reveal only when the screen is first presented, and complete it on any input.

Responsive behavior

  • Every screen keeps its 80 columns; each viewport scrolls horizontally on narrow screens and the page never does.
  • At the 44px touch pitch 24-row screens become tall; the page scrolls vertically between and within screens.
  • The history table keeps its columns and widens under text-spacing overrides instead of overlapping.

Motion

  • Only the CINQ title can animate, through SequentialReveal limited to row 1; under reduced motion it is static.
  • Screen transitions have no animation: the application renders the next grid.

Usage guidance

Do

  • Use the canonical screens as a checklist of what each layer owns before building your own flow.
  • Render application states by changing values, attributes and message content, not by restructuring the screen.

Avoid

  • Encoding transition rules or permissions in markup or CSS.
  • Replaying the title reveal when returning to CINQ with PF12.

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.