Data display

Identifier & critical value

<forma-identifier>

Low-context identifiers, codes, numeric values, and consequential values with stronger glyph distinction and verification cues.

Authoring tag
<forma-identifier>
Category
Data display
Behavior owner
Application content
Canonical source
patterns/identifier.html

Purpose

Identifiers, hashes, account numbers, amounts and other low-context values get little help from language: a reader cannot guess that 0O1I is wrong the way they can spot a misspelled word. .forma-identifier and .forma-critical-value are inline text treatments that set these values in the monospace family with tabular, slashed-zero numerals, slight letter spacing and break-anywhere wrapping. .forma-critical-value adds weight for values that carry consequence, and data-forma-verify="true" adds a double underline that invites deliberate checking. Both remain ordinary selectable text; neither states validity, authority or state.

Use when

  • Users read, copy or compare codes such as invoice numbers, execution IDs, commit hashes, IBANs or license keys.
  • A value such as an amount, dose, limit or destination account must be checked before a consequential action.
  • Long unbroken tokens must wrap inside narrow containers instead of overflowing.

Avoid when

  • The text is a multi-line code sample or configuration: use Code sample.
  • The value is ordinary prose, a person's name or a heading: body text is easier to read.
  • You need to show whether the value is valid, current or approved: state that in text or a Status lozenge; typography is not a state channel.
  • The whole screen follows recognize, verify, act: compose the values inside Verification frame.

Behavior to know

  • Monospace family with tabular-nums and slashed-zero (plus the tnum and zero OpenType features), so 0 and O, and digit columns, are distinguishable.
  • overflow-wrap: anywhere lets hashes and IDs break at any character.
  • .forma-identifier is set at 0.9375em so it sits comfortably in running text; .forma-critical-value is set at weight 750.
  • data-forma-verify="true" on a critical value adds inline padding and a double bottom border; in forced-colors mode the border uses CanvasText.

Basic example

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

Canonical

Minimal identifier & critical value

Rendered from the canonical pattern file.

Reference values

Invoice
INV-10O2-7B51
Execution
EXE-20260926T045512Z-0O1I
Amount to verify
$10,001.00

Low-context values use stronger glyph distinction and remain selectable text. Labels and surrounding prose still carry the meaning.

HTML · Minimal identifier & critical value Raw HTML for HTML · Minimal identifier & critical value
<forma-identifier class="forma-component-tag">
<section class="forma-stack" aria-labelledby="identifier-title">
  <h3 id="identifier-title">Reference values</h3>
  <dl class="forma-key-value-list">
    <div><dt>Invoice</dt><dd><span class="forma-identifier">INV-10O2-7B51</span></dd></div>
    <div><dt>Execution</dt><dd><span class="forma-identifier">EXE-20260926T045512Z-0O1I</span></dd></div>
    <div><dt>Amount to verify</dt><dd><span class="forma-critical-value" data-forma-verify="true">$10,001.00</span></dd></div>
  </dl>
  <p>Low-context values use stronger glyph distinction and remain selectable text. Labels and surrounding prose still carry the meaning.</p>
</section>
</forma-identifier>

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

Examples

Scenario

Codes with confusable characters

Support identifiers containing O/0, I/1/l and B/8 in running text. The slashed zero and monospace shapes separate the characters, and the surrounding sentence still says what each code is.

Quote reference Q-B8O0-1Il7 replaces Q-B80O-I1l7. Give the new reference to the customer; the old one no longer resolves.

HTML · Codes with confusable characters Raw HTML for HTML · Codes with confusable characters
<forma-identifier class="forma-component-tag">
  <p>Quote reference <span class="forma-identifier">Q-B8O0-1Il7</span> replaces <span class="forma-identifier">Q-B80O-I1l7</span>. Give the new reference to the customer; the old one no longer resolves.</p>
</forma-identifier>

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

Scenario

Transfer amount and destination to verify

Before approving a transfer, the destination account and amount are marked for deliberate verification. The reference is only an identifier; the fee is consequential but not flagged for verification. The double underline invites checking; it does not mean the value is correct.

Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.

Confirm outgoing transfer

Reference
TRF-20260929-004117
Destination IBAN
DE89 3704 0044 0532 0130 00
Amount
€48,000.00
Fee
€0.00

Compare the IBAN with the supplier's signed payment instruction before approving.

HTML · Transfer amount and destination to verify Raw HTML for HTML · Transfer amount and destination to verify
<forma-identifier class="forma-component-tag">
  <section aria-labelledby="identifier-transfer-verification-title">
    <h3 id="identifier-transfer-verification-title">Confirm outgoing transfer</h3>
    <dl class="forma-key-value-list">
      <div><dt>Reference</dt><dd><span class="forma-identifier">TRF-20260929-004117</span></dd></div>
      <div><dt>Destination IBAN</dt><dd><span class="forma-critical-value" data-forma-verify="true">DE89 3704 0044 0532 0130 00</span></dd></div>
      <div><dt>Amount</dt><dd><span class="forma-critical-value" data-forma-verify="true">€48,000.00</span></dd></div>
      <div><dt>Fee</dt><dd><span class="forma-critical-value">€0.00</span></dd></div>
    </dl>
    <p>Compare the IBAN with the supplier's signed payment instruction before approving.</p>
    <button type="button">Approve transfer</button>
  </section>
</forma-identifier>

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

Scenario

Long hash in a narrow column

A 64-character digest has no spaces. overflow-wrap: anywhere lets it break at any character inside its container instead of forcing horizontal scrolling.

Artifact digest (SHA-256)
9d2f4c1a7e0b83f56a1c9e02d4b7f3a8c6e15d90b2a47f8e3c1d06b59a2e7f4c
Signed by
release-signing@builds
HTML · Long hash in a narrow column Raw HTML for HTML · Long hash in a narrow column
<forma-identifier class="forma-component-tag">
  <dl class="forma-key-value-list">
    <div><dt>Artifact digest (SHA-256)</dt><dd><span class="forma-identifier">9d2f4c1a7e0b83f56a1c9e02d4b7f3a8c6e15d90b2a47f8e3c1d06b59a2e7f4c</span></dd></div>
    <div><dt>Signed by</dt><dd>release-signing@builds</dd></div>
  </dl>
</forma-identifier>

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

Mobile execution reference

An execution ID and a critical limit at phone width. The ID wraps across lines and the verified value keeps its double underline on each line.

Viewport width

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

What changes at narrow widths

  • Long identifiers break at any character (overflow-wrap: anywhere), so a 30-character ID wraps at 320px instead of overflowing.
  • The verified critical value is inline-block; if it is wider than the line it wraps inside its own box and the double underline stays at its bottom edge.
  • Values remain selectable text, so long-press copy works on touch devices.
  • Nothing changes with orientation other than where lines break.
HTML · Mobile execution reference Raw HTML for HTML · Mobile execution reference
<forma-identifier class="forma-component-tag">
  <section aria-labelledby="identifier-mobile-execution-id-title">
    <h3 id="identifier-mobile-execution-id-title">Job run</h3>
    <p>Execution <span class="forma-identifier">EXE-20260929T081402Z-7B51-0O1I-A9Q2</span> stopped at the configured limit of <span class="forma-critical-value" data-forma-verify="true">2,500 records</span>.</p>
  </section>
</forma-identifier>

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

Baseline

Mobile · 320px

The canonical pattern in a true 320px viewport, the minimum width every Forma component must support without page-level horizontal scrolling.

Viewport width

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

API and configuration

Forma components have no JavaScript API. Their public contract is the markup: native elements and attributes you write, and the CSS hooks below. The CSS hook table is generated from the built stylesheet, so it always matches the shipped implementation.

Native and ARIA attributes
AttributeOnValuesDefaultDescription
data-forma-verify.forma-critical-valuetrueabsentAdds the deliberate-verification cue (inline padding and a double bottom border). Descriptive presentation only; it does not assert validity.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
.forma-identifierBlock class—Inline treatment for low-context identifiers and codes: monospace, tabular slashed-zero numerals, slight tracking, break-anywhere wrapping, 0.9375em.
.forma-critical-valueBlock class—Inline treatment for consequential values: the same glyph treatment as identifiers at weight 750.
[data-forma-verify]Attribute hook"true"On .forma-critical-value, true shows the verification cue: inline-block with 0.25em inline padding and a 0.15em double bottom border in currentColor.
Keyboard interaction
KeysResult
NonePlain inline text; not focusable. Standard text selection and copy apply.

Form behavior

Not a form control. For entering identifiers use a Text field; the class may be applied to the input for the same glyph treatment.

States

Identifier & critical value states
StateHow it is expressedPresentation
Identifierclass="forma-identifier"Distinct glyphs, regular weight, slightly smaller than body text.
Critical valueclass="forma-critical-value"Distinct glyphs at heavy weight.
Marked for verificationdata-forma-verify="true" on .forma-critical-valueDouble underline and inline padding; CanvasText border in forced colors.

Accessibility

Forma provides

  • Keeps values as selectable, copyable text; nothing is drawn with images or CSS content.
  • Improves glyph differentiation (slashed zero, monospace shapes) without relying on color.
  • The verification cue is a border style, not a hue, and survives forced-colors mode.

Your application supplies

  • Keep a visible label (a dt, header or sentence) that says what the value is; the class does not name it.
  • State validity, freshness and approval separately in text; the verify cue is an invitation to check, not a result.
  • Group long numbers the way users read them (IBAN in fours, amounts with separators).
  • Where screen-reader users must verify character by character, offer the value in a form they can step through, such as a read-only input.

Responsive behavior

  • Inline and intrinsic: the treatment adds no layout of its own except inline-block for verified critical values.
  • overflow-wrap: anywhere keeps long tokens inside any container down to 320px.
  • Sizes are relative (em), so values scale with the surrounding text and with user zoom.

Motion

  • No animation: both classes are static typography.

Usage guidance

Do

  • Use .forma-identifier for references users will copy or read aloud, and .forma-critical-value for the few values that carry consequence.
  • Reserve data-forma-verify="true" for values the user must actively check before acting.

Avoid

  • Marking every value for verification; the cue loses its meaning.
  • Truncating identifiers with an ellipsis where users must compare the full value.
  • Using weight or the double underline to imply that a value is approved or authoritative.

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.