Skip to content

Process steps

Numbered steps that say how something works, side by side or as a list of rows.

<div class="cap-process" id="pr-columns">
  <ol class="cap-process-list">
    <li class="cap-process-step"><h3 class="cap-process-title">Connect a site</h3><p class="cap-process-text">Add example.com and the checks start within five minutes.</p></li>
    <li class="cap-process-step"><h3 class="cap-process-title">Read the report</h3><p class="cap-process-text">Every failing check names the page and the fix.</p></li>
    <li class="cap-process-step"><h3 class="cap-process-title">Publish with confidence</h3><p class="cap-process-text">A required check that fails holds the publish until it passes.</p></li>
  </ol>
</div>

Installation

// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/process.css";

Usage

<div class="cap-process" data-layout="rows">   <!-- data-layout omitted: columns; data-flush on rows: no card per row -->
  <ol class="cap-process-list">
    <li class="cap-process-step">
      <h3 class="cap-process-title">Connect your account</h3>
      <span class="cap-process-tag">[a pill]</span>   <!-- optional -->
      <p class="cap-process-text">One line saying what happens.</p>
      <span class="cap-process-end">[timing, a pill]</span>   <!-- optional; at the line's end in rows -->
    </li>
  </ol>
</div>

Examples

Rows with a tag

<div class="cap-process" data-layout="rows" id="pr-rows">
  <ol class="cap-process-list">
    <li class="cap-process-step"><h3 class="cap-process-title">Draft</h3><span class="cap-process-tag"><span class="cap-pill" data-variant="outline">Draft</span></span><p class="cap-process-text">The post is being written. Nothing is public.</p></li>
    <li class="cap-process-step"><h3 class="cap-process-title">In review</h3><span class="cap-process-tag"><span class="cap-pill" data-tone="info">In review</span></span><p class="cap-process-text">Waiting for Sam Lee to read it.</p></li>
    <li class="cap-process-step"><h3 class="cap-process-title">Published</h3><span class="cap-process-tag"><span class="cap-pill" data-tone="ok">Published</span></span><p class="cap-process-text">Live on example.com since Monday.</p></li>
  </ol>
</div>

Flush rows, each with its timing and status at the end

<div class="cap-process" data-layout="rows" data-flush id="pr-flush">
  <ol class="cap-process-list">
    <li class="cap-process-step"><h3 class="cap-process-title">Retry in four hours</h3><span class="cap-process-end"><span class="cap-mono">+4h</span><span class="cap-pill" data-tone="crit">Retry failed</span></span></li>
    <li class="cap-process-step"><h3 class="cap-process-title">Send the first reminder</h3><span class="cap-process-end"><span class="cap-mono">+1d</span><span class="cap-pill" data-variant="outline">Pending</span></span></li>
    <li class="cap-process-step"><h3 class="cap-process-title">Retry after three days</h3><span class="cap-process-end"><span class="cap-mono">+3d</span><span class="cap-pill" data-variant="outline">Pending</span></span></li>
  </ol>
</div>

Narrow space

<div class="cap-process process-demo-narrow" id="pr-narrow">
  <ol class="cap-process-list">
    <li class="cap-process-step"><h3 class="cap-process-title">Write</h3><p class="cap-process-text">Field notes, saved as you type.</p></li>
    <li class="cap-process-step"><h3 class="cap-process-title">Check</h3><p class="cap-process-text">Links and headings, checked on save.</p></li>
  </ol>
</div>

API reference

ProcessSteps

PropTypeRequiredDoes
stepsProcessStep[]Yes
layout"columns" | "rows""columns": side by side where there is room (how it works). "rows": a list of rows, the number at the left.
flushbooleanRows only: no card per row, a rule between rows.
headingLevel"h2" | "h3" | "h4" | "p"The level of each step's title.
labelstring

CSS variables

VariableDefault
--cap-process-start0

Parts and data attributes

ClassIs
.cap-processthe root
.cap-process-enda part
.cap-process-lista part
.cap-process-stepa part
.cap-process-taga part
.cap-process-texta part
.cap-process-titlea part
AttributeValues
data-flushpresent or absent
data-layoutrows

Accessibility

Nothing to operate; links inside a step are in reading order.

  • An ol, so the position is announced; the drawn number's alternative text is empty.
  • Title in --text, text in --muted, number in --accent-text: all in the contrast report.