Workflow and diagrams

Lane board

<forma-lane-board>

Preserves item-to-lane membership in a bounded board with narrow-screen containment.

Authoring tag
<forma-lane-board>
Behavior owner
Application content
Canonical source
patterns/lane-board.html

Purpose

A lane board shows items grouped into named lanes, such as workflow stages or owners, laid out as columns. Membership is structural: each lane is a labelled section with a heading, a count and an ordered list of items, so which lane an item is in is announced and survives any width. The board scrolls horizontally inside itself when the lanes do not fit, instead of squeezing them or overflowing the page. Moving items between lanes, drag and drop, and deciding which moves are legal are application behavior; Forma only provides the columns and inherits the shared direct-manipulation hooks for items the application is moving.

Use when

  • Work moves through a small number of named stages and people scan by stage, as in a kanban or release board.
  • Lane membership is the key fact, and the count per lane matters.
  • The board must remain usable on a phone by scrolling lanes, not by losing them.

Avoid when

  • Items need sorting, filtering or bulk actions across many fields: use Data grid or Work queue.
  • The order within a single list is what the user decides: use Ranking.
  • Relationships between items matter more than grouping: use Diagram.
  • There is only one lane: use a plain list or Work queue.

Behavior to know

  • Lanes are grid columns of minmax(min(18rem, 85vw), 1fr): at least 18rem wide on large screens, 85% of the viewport on phones so the next lane peeks in.
  • The board scrolls horizontally inside itself with contained overscroll and shows a 2px outline when focused.
  • Each lane header pairs the lane heading with a text count.
  • Items are list items, so their count and position within a lane are exposed by the list semantics.

Basic example

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

Canonical

Minimal lane board

Rendered from the canonical pattern file.

Ready

2 items
  1. Prepare release

    Owner: Build team

Review

1 item
  1. Verify evidence

    State: blocked

HTML · Minimal lane board Raw HTML for HTML · Minimal lane board
<forma-lane-board class="forma-component-tag">
<section class="forma-lane-board" aria-label="Work board">
  <section class="forma-lane-board__lane" aria-labelledby="lane-ready">
    <header class="forma-lane-board__header"><h2 id="lane-ready">Ready</h2><span>2 items</span></header>
    <ol class="forma-lane-board__items"><li><article class="forma-surface"><h3>Prepare release</h3><p>Owner: Build team</p></article></li></ol>
  </section>
  <section class="forma-lane-board__lane" aria-labelledby="lane-review">
    <header class="forma-lane-board__header"><h2 id="lane-review">Review</h2><span>1 item</span></header>
    <ol class="forma-lane-board__items"><li><article class="forma-surface"><h3>Verify evidence</h3><p>State: blocked</p></article></li></ol>
  </section>
</section>
</forma-lane-board>

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

Examples

Scenario

Release board with an empty lane

Three stages with counts. The empty Blocked lane keeps its heading and says it is empty, so users can tell "nothing blocked" from "lane missing". The board is focusable because it can scroll.

To do

2 items
  1. Update migration guide

    Owner: Docs

  2. Rotate signing key

    Owner: Platform

In progress

1 item
  1. Bulk export to Parquet

    Owner: Data

    Due tomorrow

Blocked

0 items

Nothing is blocked.

HTML · Release board with an empty lane Raw HTML for HTML · Release board with an empty lane
<forma-lane-board class="forma-component-tag">
  <section class="forma-lane-board" aria-label="Release 4.2 board" tabindex="0">
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-release-board-todo">
      <header class="forma-lane-board__header"><h2 id="lane-board-release-board-todo">To do</h2><span>2 items</span></header>
      <ol class="forma-lane-board__items">
        <li><article class="forma-surface"><h3>Update migration guide</h3><p>Owner: Docs</p></article></li>
        <li><article class="forma-surface"><h3>Rotate signing key</h3><p>Owner: Platform</p></article></li>
      </ol>
    </section>
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-release-board-doing">
      <header class="forma-lane-board__header"><h2 id="lane-board-release-board-doing">In progress</h2><span>1 item</span></header>
      <ol class="forma-lane-board__items">
        <li><article class="forma-surface"><h3>Bulk export to Parquet</h3><p>Owner: Data</p><p><span class="forma-status-lozenge" data-state="attention">Due tomorrow</span></p></article></li>
      </ol>
    </section>
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-release-board-blocked">
      <header class="forma-lane-board__header"><h2 id="lane-board-release-board-blocked">Blocked</h2><span>0 items</span></header>
      <p>Nothing is blocked.</p>
    </section>
  </section>
</forma-lane-board>

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

Scenario

Moving an item without dragging

Each item has a native button that moves it to the next lane, the non-drag path the application must provide. The target lane shows the shared data-forma-drop="candidate" cue (a dashed outline, not only color) and a live message reports the outcome in text. A light motion weight keeps any settle of moved cards quick.

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.

Screening

1 candidate
  1. Amara Okafor

    Backend engineer

Interview

1 candidate
  1. Luis Ferreira

    Backend engineer

Luis Ferreira moved from Screening to Interview.

HTML · Moving an item without dragging Raw HTML for HTML · Moving an item without dragging
<forma-lane-board class="forma-component-tag">
  <section class="forma-lane-board" aria-label="Hiring pipeline" tabindex="0" data-forma-motion-weight="light">
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-move-without-drag-screen">
      <header class="forma-lane-board__header"><h2 id="lane-board-move-without-drag-screen">Screening</h2><span>1 candidate</span></header>
      <ol class="forma-lane-board__items">
        <li><article class="forma-surface"><h3>Amara Okafor</h3><p>Backend engineer</p><button type="button">Move Amara Okafor to Interview</button></article></li>
      </ol>
    </section>
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-move-without-drag-interview" data-forma-drop="candidate">
      <header class="forma-lane-board__header"><h2 id="lane-board-move-without-drag-interview">Interview</h2><span>1 candidate</span></header>
      <ol class="forma-lane-board__items">
        <li><article class="forma-surface"><h3>Luis Ferreira</h3><p>Backend engineer</p><button type="button">Move Luis Ferreira to Offer</button></article></li>
      </ol>
    </section>
  </section>
  <p role="status">Luis Ferreira moved from Screening to Interview.</p>
</forma-lane-board>

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 scrolling lanes

On a phone each lane takes most of the screen width and the next lane peeks in, showing that the board continues sideways.

Viewport width

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

What changes at narrow widths

  • Lanes are min(18rem, 85vw) wide, so at 320px each lane is about 272px and the edge of the next lane is visible as a scroll cue.
  • Horizontal scrolling is contained in the board with overscroll-behavior-inline: contain; the page does not scroll sideways.
  • The board is focusable (tabindex="0") so it can also be scrolled from a keyboard; lane membership is still announced from the lane heading.
  • Portrait shows about one lane at a time; landscape shows more. Consider offering a lane filter or a list view for boards with many lanes.
HTML · Mobile scrolling lanes Raw HTML for HTML · Mobile scrolling lanes
<forma-lane-board class="forma-component-tag">
  <section class="forma-lane-board" aria-label="Support board" tabindex="0">
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-mobile-new">
      <header class="forma-lane-board__header"><h2 id="lane-board-mobile-new">New</h2><span>1 ticket</span></header>
      <ol class="forma-lane-board__items"><li><article class="forma-surface"><h3>SUP-2291</h3><p>Invoice PDF missing line items</p></article></li></ol>
    </section>
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-mobile-waiting">
      <header class="forma-lane-board__header"><h2 id="lane-board-mobile-waiting">Waiting on customer</h2><span>1 ticket</span></header>
      <ol class="forma-lane-board__items"><li><article class="forma-surface"><h3>SUP-2280</h3><p>Export stuck at 90%</p></article></li></ol>
    </section>
    <section class="forma-lane-board__lane" aria-labelledby="lane-board-mobile-done">
      <header class="forma-lane-board__header"><h2 id="lane-board-mobile-done">Resolved</h2><span>0 tickets</span></header>
      <p>No resolved tickets today.</p>
    </section>
  </section>
</forma-lane-board>

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
aria-labelroot sectionstring—Names the board.
tabindexroot section0—Makes the horizontally scrolling board focusable so keyboard users can scroll it; Forma draws a focus outline for it.
aria-labelledbylane sectionid of the lane heading—Names each lane by its heading, which is what makes lane membership announced.
data-forma-droplane or itemcandidate | accepted | rejectedabsentShared drop presentation written by the application during a move: dashed, solid or dashed-with-fill outline. See Reorder states.
data-forma-motion-weightrootlight | standard | heavystandardPresentation-only mass for settling of items the application is moving inside the board.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
.forma-lane-boardBlock class—Root: a column-flow grid of lanes that scrolls horizontally inside itself.
.forma-lane-board__headerElement class—Lane heading and count on one baseline, spaced apart.
.forma-lane-board__itemsElement class—Unstyled list of items with a small gap.
.forma-lane-board__laneElement class—One lane: a vertical grid of header and items that can shrink.
[data-forma-motion-weight]Attribute hook"heavy", "light", "standard"Light, standard or heavy mass for the shared direct-manipulation settle of items inside the board (items carrying data-forma-manipulation). The board itself does not animate. Never encodes importance.
Keyboard interaction
KeysResult
Tab / Shift+TabMoves to the board, then through links and buttons inside items, lane by lane in source order.
Arrow keys (board focused)Scroll the board. Native scrolling of a focused overflow region.
Moving itemsNot provided. The application must offer buttons or a menu to move items between lanes; drag must never be the only path.

Form behavior

Not a form control.

States

Lane board states
StateHow it is expressedPresentation
Overflowingmore lanes than fitThe board scrolls horizontally inside itself; lanes keep their minimum width.
Board focus:focus-visible on the board2px outline in the current text color.
Empty laneno items in the laneApplication writes a zero count and a sentence in place of the list.
Drop targetdata-forma-drop on a laneCandidate is a dashed outline, accepted solid, rejected dashed with a fill.
Item movingdata-forma-manipulation on an itemApplication-written shared hook: dragging tracks directly, settling returns with damped motion.

Accessibility

Forma provides

  • Keeps lanes as columns at every width and contains horizontal scrolling in the board, so page reflow is not broken.
  • Draws a visible focus outline on the board when it is focused for scrolling.
  • Uses list semantics for items, so each lane's item count and item position are available to assistive technology.

Your application supplies

  • Give each lane a heading and name the lane section with it.
  • Write counts as text and keep them in sync.
  • Provide a non-drag way to move items (buttons or a menu), announce the result in a live region, and keep focus on the moved item.
  • Enforce which moves are legal in application or Ordo state; never infer legality from lane position.
  • Add tabindex="0" to the board when it can scroll, or ensure it contains focusable content.

Responsive behavior

  • Lanes are implicit grid columns of minmax(min(18rem, 85vw), 1fr), so they share extra width on large screens and never shrink below 18rem (or 85vw on phones).
  • The board has max-inline-size: 100% and overflow-x: auto, keeping overflow inside itself.
  • There are no breakpoints; lanes never stack, which keeps lane membership visually stable across widths.
  • Lane content wraps within the lane; long titles in items wrap rather than widening the lane.

Motion

  • The board and lanes do not animate.
  • Items the application is moving use the shared direct-manipulation hooks: dragging tracks with no transition, settling returns with the damped inertial model and never overshoots.
  • data-forma-motion-weight on the board sets the mass those settles inherit.
  • Under prefers-reduced-motion: reduce the settle duration becomes effectively instant and items appear at their final position.

Motion weights

Forma motion is physics-derived: perceived mass changes how a surface accelerates and settles, never what state it is in. Compare the three presentation weights of the same markup:

lightpresentation only

Ready

2 items
  1. Prepare release

    Owner: Build team

Review

1 item
  1. Verify evidence

    State: blocked

standardpresentation only

Ready

2 items
  1. Prepare release

    Owner: Build team

Review

1 item
  1. Verify evidence

    State: blocked

heavypresentation only

Ready

2 items
  1. Prepare release

    Owner: Build team

Review

1 item
  1. Verify evidence

    State: blocked

Usage guidance

Do

  • Keep the number of lanes small enough to scan, typically three to six.
  • Show a count per lane and an explicit empty message.

Avoid

  • Using lane color as the only way to show stage.
  • Relying on drag and drop as the only way to move work.
  • Hiding lanes on phones; scroll to them instead.

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.