Skip to main content

afrigov is an open-source project. It is not a government website and is not affiliated with any government.

Previewing neutral core Change

afrigov Accessible government design system

Steps

The steps of a process, numbered and in order: what happens at the office, how to apply, what happens after you send a form.

When to use

When the order matters and each step is something that happens or something the person does. On a service page, and under "What happens next" on a confirmation page.

When not to use

For a list of documents to bring, or anything else where order does not matter: that is a bulleted list. For the pages of a form, ask one question per page and do not show a progress bar.

  1. Report the leak

    Tell us where it is, online or by phone. You get a reference number.

  2. An inspector visits

    Within two working days. You do not need to be there.

  3. The repair is scheduled

    We text you the date. Supply may be off for a few hours on the day.

  4. We confirm it is fixed

    Reply to the text if the leak comes back within thirty days.

Show HTML
<ol class="ag-steps ag-mb-0">
  <li class="ag-steps__item">
    <h3 class="ag-steps__title">Report the leak</h3>
    <p>Tell us where it is, online or by phone. You get a reference number.</p>
  </li>
  <li class="ag-steps__item">
    <h3 class="ag-steps__title">An inspector visits</h3>
    <p>Within two working days. You do not need to be there.</p>
  </li>
  <li class="ag-steps__item">
    <h3 class="ag-steps__title">The repair is scheduled</h3>
    <p>We text you the date. Supply may be off for a few hours on the day.</p>
  </li>
  <li class="ag-steps__item">
    <h3 class="ag-steps__title">We confirm it is fixed</h3>
    <p>Reply to the text if the leak comes back within thirty days.</p>
  </li>
</ol>

Without titles

When each step is one sentence, leave the title out.

  1. An officer checks your documents.
  2. Your fingerprints and photograph are taken.
  3. You check the printed details and sign.
  4. Your card is printed and handed to you.
Show HTML
<ol class="ag-steps ag-mb-0">
  <li class="ag-steps__item">An officer checks your documents.</li>
  <li class="ag-steps__item">Your fingerprints and photograph are taken.</li>
  <li class="ag-steps__item">You check the printed details and sign.</li>
  <li class="ag-steps__item">Your card is printed and handed to you.</li>
</ol>

How it works

  • An ordered list. The numbers are counted by the browser, so adding a step never means renumbering.
  • The title is a heading at the level the page needs, and is optional.
  • The column is held to the reading width. A step can hold paragraphs, a link or an inset.
  • Start each step with who acts: "An officer checks", "You pay". Keep to seven steps or fewer.

Accessibility

  • It is a real ol, so a screen reader says "list, 4 items" and the position of each.
  • The number comes from the list's own counter, so it is never read twice.
  • The line and the ring are decoration. The order is in the markup.