1. Government Frontend Component Guide
  2. Translation navigation

Component

Translation navigation

A list of links to available translations

The active property indicates the current language.

Search for usage of this component on GitHub

How it looks (preview all)

How to call this component

<%= render "govuk_publishing_components/components/translation-nav", {
  translations: [
    {
      locale: "en",
      base_path: "/en",
      text: "English",
      active: true
    },
    {
      locale: "hi",
      base_path: "/hi",
      text: "हिंदी"
    }
  ]
} %>

Accessibility acceptance criteria

The component must:

The translation links must:

Links in the component must:

  • accept focus
  • be focusable with a keyboard
  • be usable with a keyboard
  • indicate when they have focus
  • change in appearance when touched (in the touch-down state)
  • change in appearance when hovered
  • be usable with touch
  • be usable with voice commands
  • have visible text

Other examples

Multiple translations (preview)

<%= render "govuk_publishing_components/components/translation-nav", {
  translations: [
    {
      locale: "en",
      base_path: "/en",
      text: "English",
      active: true
    },
    {
      locale: "fr",
      base_path: "/fr",
      text: "Français"
    },
    {
      locale: "hi",
      base_path: "/hi",
      text: "हिंदी"
    },
    {
      locale: "ja",
      base_path: "/ja",
      text: "日本語"
    },
    {
      locale: "ur",
      base_path: "/ur",
      text: "اردو"
    },
    {
      locale: "zh",
      base_path: "/zh",
      text: "中文"
    }
  ]
} %>

Right to left (preview)

<%= render "govuk_publishing_components/components/translation-nav", {
  translations: [
    {
      locale: "en",
      base_path: "/en",
      text: "English"
    },
    {
      locale: "ar",
      base_path: "/ar",
      text: "العربية",
      active: true
    }
  ]
} %>

With branding (preview)

Organisation colour branding can be added to the component as shown.

<%= render "govuk_publishing_components/components/translation-nav", {
  brand: "wales-office",
  translations: [
    {
      locale: "en",
      base_path: "/en",
      text: "English",
      active: true
    },
    {
      locale: "cy",
      base_path: "/cy",
      text: "Cymraeg"
    }
  ]
} %>

With no top margin (preview)

<%= render "govuk_publishing_components/components/translation-nav", {
  no_margin_top: true,
  translations: [
    {
      locale: "en",
      base_path: "/en",
      text: "English",
      active: true
    },
    {
      locale: "cy",
      base_path: "/cy",
      text: "Cymraeg"
    }
  ]
} %>

With tracking (preview)

Data attributes can be passed for each link as shown.

<%= render "govuk_publishing_components/components/translation-nav", {
  translations: [
    {
      locale: "en",
      base_path: "/en",
      text: "English",
      active: true,
      data_attributes: {
        track_category: "categoryEnglish",
        track_action: 1.1,
        track_label: "labelEnglish",
        track_options: {
          dimension28: 1,
          dimension29: "dimension29English"
        }
      }
    },
    {
      locale: "cy",
      base_path: "/cy",
      text: "Cymraeg",
      data_attributes: {
        track_category: "categoryWelsh",
        track_action: 1.2,
        track_label: "labelWelsh",
        track_options: {
          dimension28: 1,
          dimension29: "dimension29Welsh"
        }
      }
    }
  ]
} %>