name: Previous and next navigation
description: Navigational links that allow users to navigate within a series of pages
  or elements.
body: |
  This component accepts 2 optional parameters, previous and next.

  Each optional parameter accepts:

  - an URL for the link
  - a title for the URL
  - a label that can add extra info (ie page number) that will be displayed under the title

  If one of the 2 parameters is nil, no link will appear.
accessibility_criteria: |
  Icons in the component must not be announced by screen readers.

  The component must:

  - identify itself as pagination navigation
  - provide a distinction between the navigation text and label text of the links both visually and for screenreaders

uses_component_wrapper_helper: true
shared_accessibility_criteria:
  - link
accessibility_excluded_rules:
  - landmark-unique # aria-label attributes will be duplicated in component examples list
examples:
  default:
    data:
      previous_page:
        url: previous-page
        title: Previous page
        label: 1 of 3
  only_next:
    data:
      next_page:
        url: next-page
        title: Next page
        label: Tax disc
  both_previous_and_next:
    data:
      previous_page:
        url: previous-page
        title: Previous page
        label: 1 of 3
      next_page:
        url: next-page
        title: Next page
        label: 3 of 3
  both_previous_and_next_no_labels:
    data:
      previous_page:
        url: previous-page
        title: Previous page
      next_page:
        url: next-page
        title: Next page
  become_a_lorry_bus_driver_example:
    data:
      previous_page:
        url: previous-page
        title: Previous
        label: Applying for a provisional lorry or bus licence
      next_page:
        url: next-page
        title: Next
        label: 'Driver CPC part 1 test: theory'
  without_ga4_tracking:
    description: Disables the GA4 link tracker on the links. Tracking is enabled by default.
    data:
      disable_ga4: true
      previous_page:
        url: previous-page
        title: Previous
        label: Applying for a provisional lorry or bus licence
      next_page:
        url: next-page
        title: Next
        label: 'Driver CPC part 1 test: theory'