Step List
Vertical numbered step list with active, complete, incomplete, disabled, error, and warning states. Combine modifier classes (-active, -complete, -disabled, -error, -warning) on .step-list-item to express each state.
Link or button?
Use an <a class="step-list-link"> when the step navigates to a URL. When it activates a step in place — the common case inside a wizard — render a <button class="step-list-link"> instead: focus, Enter and Space then come from the platform rather than hand-rolled tabindex and keydown on the <li>. .step-list-link already neutralizes the user-agent button box, so nothing else is needed.
Disabled steps stay focusable
Mark a blocked step with aria-disabled="true" on the link rather than the disabled attribute, and keep it in the tab order. A keyboard user has to be able to reach the tooltip that explains why the step is blocked — which is also why -disabled dims the step's own parts (marker, link, subtext) rather than the whole <li>: ancestor opacity can't be undone by a descendant, so dimming the item would fade the tooltip too.