VERIFICATION-0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
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>- Category
- Command and keyboard-first
- 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.
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.
<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
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.
<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.
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.
<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.
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.
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.
<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.
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.
| Attribute | On | Values | Default | Description |
|---|---|---|---|---|
value | submit keys named action | enter | clear | pf3 | pf5 | pf7 | pf8 | pf12 | — | The submitter value the application reads to choose the next screen. |
aria-invalid | field | true | absent | Set by the application on a field it rejected, together with the message ID in aria-describedby. |
colspan | td | 5 | — | Full-width empty or unavailable row in the history table. |
| Hook | Kind | Values or default | Description |
|---|---|---|---|
[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__table | Element class | — | The TRNH 12-row positioned table with a two-cell gutter. |
.forma-stack | Block class | — | The canonical pattern stacks the three independent grids vertically. |
| Keys | Result |
|---|---|
| Tab / Shift+Tab | CINQ: 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 field | Implicit submission through the Enter key of that screen. |
| PF keys | Present as buttons; physical F-key mapping is application or Limen behavior. |
| Event | Description |
|---|---|
submit | Native 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
| State | How it is expressed | Presentation |
|---|---|---|
| Default | canonical pattern | CINQ with an information message, ACCD with protected data, TRNH with 12 of 37 rows. |
| Inquiry validation | aria-invalid plus a validation message with role=alert | The invalid field is described by its hint and the message. |
| Inquiry no criteria | error message with role=alert | CINQ001E asks for at least one criterion. |
| History empty | one td colspan row and an information message | The empty period is stated in words; paging shows 0 of 0. |
| History error | error message and data-forma-state="inhibited" on the indicator | The 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.