name: Inverse header
description: A wrapper to contain header content in white text
body: |
  This component can be passed a block of template code and will wrap it in a blue header. This is as light-touch as possible and doesn't attempt to deal with the margins and paddings of its content. White text is enforced on content and would need to be overridden where unwanted. Implemented to accommodate topic and list page headings but unopinionated about its contents.

  If passing links to the block make sure to add [the inverse modifier](https://design-system.service.gov.uk/styles/links/#links-on-dark-backgrounds).
uses_component_wrapper_helper: true
accessibility_criteria: |
  The component must:

  * be used in conjunction with content that renders a text contrast ratio higher than 4.5:1 against the header colour to meet WCAG AA.
examples:
  default:
    data:
      block: |
        <!-- example content -->
          <%= render "govuk_publishing_components/components/title", {
            title: "Education, Training and Skills",
            inverse: true
          } %>
          <!-- end of example content -->
  for_full_page_width:
    description: "Used when the header covers the full width of the page, but it's content is in the grid layout. The left-right padding is removed to make the contents line up with the other items on the page."
    data:
        full_width: true
        block: |
          <!-- example content -->
            <%= render "govuk_publishing_components/components/title", {
              title: "Education, Training and Skills",
              inverse: true
            } %>
            <!-- end of example content -->
  html_publication_header:
    description: "The inverse header component is used on HTML publications. [See example on GOV.UK here](https://www.gov.uk/government/publications/ln5-0at-jackson-homes-scopwick-ltd-environmental-permit-application-advertisement/ln5-0at-jackson-homes-scopwick-ltd-environmental-permit-application)"
    data:
      block: |
        <!-- example content -->
          <%= render "govuk_publishing_components/components/title", {
            title: "LN5 0AT, Jackson Homes (Scopwick) Ltd: environmental permit application",
            inverse: true,
            context: "Notice",
          } %>
          <p class="publication-header__last-changed">Published 22 April 2016</p>
          <!-- end of example content -->
  with_paragraph_and_link:
    data:
      block: |
        <p class="gem-c-lead-paragraph gem-c-lead-paragraph--inverse">
          Schools and academies, further and higher education, apprenticeships and <a href="#other-skills" class="govuk-link govuk-link--inverse">other skills</a> training, student funding, early years.
        </p>