name: Step by step navigation header
description: Shows that a content page is part of a step by step navigation
body: |
  The component indicates to the user that the current page is part of a [step by step navigation](/component-guide/step_by_step_nav), and can provide a link to it.
accessibility_criteria: |
  The component is designed to go into the top of an existing content page. This component looks like a heading so uses a heading level 2 element.

  An earlier version of the component did not use a heading element – this failed WCAG 2.1 Success Criterion 1.3.1 ("Information, structure, and relationships conveyed through presentation can be programmatically determined or are available in text.")

  An early version of the component contained a hidden skip link for keyboard and screen reader users, that jumped to the step by step navigation component in the sidebar (similar to the 'skip to content' link at the top of all GOV.UK pages). User testing suggested that rather than helping users it confused them, so this has been removed.

  Always place the step by step navigation header at the top of a page, before the `<main>` element. Placing the component here means that the "Skip to main content" link allows the user to skip all navigation links, including the step by step navigation header.
shared_accessibility_criteria:
  - link
uses_component_wrapper_helper: true
examples:
  default:
    data:
      title: 'Learn to drive a car: step by step'
  with_a_link:
    data:
      title: 'Having children: step by step'
      path: /childcare-parenting/pregnancy-and-birth
  with_a_long_text:
    data:
      title: 'Coronavirus: businesses and self-employed people'
      path: /childcare-parenting/pregnancy-and-birth
  with_margin_bottom:
    description: |
      The component accepts a number for margin bottom from `0` to `9` (`0px` to `60px`) using the [GOV.UK Frontend spacing scale](https://design-system.service.gov.uk/styles/spacing/#the-responsive-spacing-scale). It defaults to having a margin bottom of `30px`.
    data:
      title: 'Learn to practice flexible spacing: step by step'
      margin_bottom: 9
  without_ga4_tracking:
    description: Disables GA4 tracking on the header. Tracking is enabled by default. This includes the `ga4-link-tracker` module and `data-ga4-link` attributes. See the [ga4-link-tracker docs](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) for more information.
    data:
      disable_ga4: true
      title: 'Learn to drive a motorbike: step by step'
      path: /learn-to-drive-a-motorbike