name: "Organisation logo"
description: "Organisation text with crest and branded border colour"
body: |
  Organisation name must be provided with pre-formatted line breaks.
  These cannot be inferred from the name alone.

  Alternatively a custom organisation logo can be provided as an image.

  The logo can optionally be wrapped in a heading.

  The logo can be set to not take up the full width of the parent container with the `inline` option.

accessibility_criteria: |
  The crest image itself must be presentational and ignored by screen readers.

shared_accessibility_criteria:
  - link
examples:
  default:
    data:
      organisation:
        name: 'Organisation<br>Name'
        url: 'http://www.gov.uk'
  single_identity:
    data:
      organisation:
        name: 'Single Identity'
        url: 'http://www.gov.uk'
        crest: 'single-identity'
  attorney_generals_office:
    data:
      organisation:
        name: 'Attorney <br>General’s <br>Office'
        url: '/government/organisations/attorney-generals-office'
        brand: 'attorney-generals-office'
        crest: 'single-identity'
  department_for_business_innovation_and_skills:
    data:
      organisation:
        name: 'Department <br>for Business<br>Innovation &amp; Skills'
        url: '/government/organisations/department-for-business-innovation-skills'
        brand: 'department-for-business-innovation-skills'
        crest: 'bis'
  department_for_international_trade:
    data:
      organisation:
        name: 'Department for<br>International Trade'
        url: '/government/organisations/department-for-international-trade'
        brand: 'department-for-international-trade'
        crest: 'dit'
  executive_office:
    data:
      organisation:
        name: Prime Minister's Office, 10 Downing Street
        url: '/government/organisations/prime-ministers-office-10-downing-street'
        brand: 'executive-office'
        crest: 'eo'
  home_office:
    data:
      organisation:
        name: 'Home Office'
        url: '/government/organisations/home-office'
        brand: 'home-office'
        crest: 'ho'
  ministry_of_defence:
    data:
      organisation:
        name: 'Ministry<br>of Defence'
        url: '/government/organisations/ministry-of-defence'
        brand: 'ministry-of-defence'
        crest: 'mod'
  office_of_the_advocate_general_for_scotland:
    data:
      organisation:
        name: 'Office of the<br>Advocate General<br>for Scotland'
        url: '/government/organisations/office-of-the-advocate-general-for-scotland'
        brand: 'office-of-the-advocate-general-for-scotland'
        crest: 'so'
  office_of_the_leader_of_the_house_of_commons:
    data:
      organisation:
        name: 'Office of the <br>Leader of the <br>House of Commons'
        url: '/government/organisations/the-office-of-the-leader-of-the-house-of-commons'
        brand: 'the-office-of-the-leader-of-the-house-of-commons'
        crest: 'portcullis'
  wales_office:
    data:
      organisation:
        name: 'Wales Office<br>Swyddfa Cymru'
        url: '/government/organisations/wales-office'
        brand: 'wales_office'
        crest: 'wales'
  uk_atomic_energy_authority:
    data:
      organisation:
        name: 'UK Atomic <br>Energy <br>Authority'
        url: '/government/organisations/uk-atomic-energy-authority'
        brand: 'department-for-business-innovation-skills'
        crest: 'ukaea'
  wales_office:
    data:
      organisation:
        name: 'Wales Office<br>Swyddfa Cymru'
        url: '/government/organisations/wales-office'
        brand: 'wales_office'
        crest: 'wales'
  hm_revenue_customs:
    data:
      organisation:
        name: 'HM Revenue<br>&amp; Customs'
        url: '/government/organisations/hm-revenue-customs'
        brand: 'hm-revenue-customs'
        crest: 'hmrc'
  bona_vacantia:
    data:
      organisation:
        name: 'Bona Vacantia'
        url: '/government/organisations/bona-vacantia'
        brand: 'attorney-generals-office'
        crest: 'org'
  treasury_solicitors_office:
    data:
      organisation:
        name: 'Treasury <br>Solicitor’s <br>Department'
        url: '/government/organisations/treasury-solicitor-s-department'
        brand: 'attorney-generals-office'
        crest: 'org'
  land_registry:
    data:
      organisation:
        name: 'Land Registry'
        url: '/government/organisations/land-registry'
        brand: 'department-for-business-innovation-skills'
        crest: null
        image:
          url: 'https://assets.publishing.service.gov.uk/government/uploads/system/uploads/organisation/logo/69/HMLR_logo.png'
          alt_text: 'Land Registry'
  hm_prison_service:
    data:
      organisation:
        name: 'HM Prison Service'
        url: '/government/organisations/hm-prison-service'
        brand: 'ministry-of-justice'
        image:
          url: 'https://assets.publishing.service.gov.uk/government/uploads/system/uploads/organisation/logo/321/HMPS.jpg'
          alt_text: 'HM Prison Service'
  with_data_attributes:
    description: Data attributes can be applied as required. Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
    data:
      organisation:
        name: Cabinet Office
        url: '/government/organisations/cabinet-office'
        brand: cabinet-office
        crest: 'single-identity'
        data_attributes:
          track_category: "navOrganisationLinkClicked"
          track_action: 1
          track_label: '/government/organisations/cabinet-office'
          track_options:
            dimension28: 2
            dimension29: Cabinet Office
  without_a_link:
    data:
      organisation:
        name: Cabinet Office
        brand: cabinet-office
        crest: 'single-identity'
  as_a_heading:
    description: The `heading_level` option takes a number from 1 to 6.
    data:
      organisation:
        name: Cabinet Office
        url: '/government/organisations/cabinet-office'
        brand: cabinet-office
        crest: 'single-identity'
      heading_level: 1
  as_a_heading_without_a_link:
    data:
      organisation:
        name: Cabinet Office
        brand: cabinet-office
        crest: 'single-identity'
      heading_level: 1
  inline-block:
    description: This option is useful to stop a large selectable area.
    data:
      organisation:
        name: Cabinet Office
        url: '/government/organisations/cabinet-office'
        brand: cabinet-office
        crest: 'single-identity'
      inline: true