govuk_publishing_components 23.15.0 → 24.0.0

data/app/assets/images/govuk_publishing_components/chevron-banner/chevron-banner-small-focus.svg

@@ -1,4 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg viewBox="0 0 104 122" xmlns="http://www.w3.org/2000/svg">
-<path d="m0.81268 5.0662l51.363 54.069c1.0996 1.1575 1.1 2.9735 8.258e-4 4.1315l-50.942 53.668c-1.1407 1.2017-1.0912 3.1006 0.11054 4.2412 0.55745 0.52914 1.2967 0.82413 2.0653 0.82413h41.812c0.8157 0 1.5962-0.33215 2.1618-0.91994l55.613-57.799c1.1179-1.1618 1.1176-2.9994-7.29e-4 -4.1609l-56.04-58.201c-0.56552-0.58733-1.3457-0.91919-2.1611-0.91919h-41.809c-1.6569 0-3 1.3431-3 3 0 0.76901 0.29531 1.5087 0.82496 2.0662z" fill-rule="evenodd"/>
-</svg>

data/app/assets/images/govuk_publishing_components/chevron-banner/chevron-banner-small.svg

@@ -1,4 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg viewBox="0 0 104 122" xmlns="http://www.w3.org/2000/svg">
-<path d="m0.81268 5.0662l51.363 54.069c1.0996 1.1575 1.1 2.9735 8.258e-4 4.1315l-50.942 53.668c-1.1407 1.2017-1.0912 3.1006 0.11054 4.2412 0.55745 0.52914 1.2967 0.82413 2.0653 0.82413h41.812c0.8157 0 1.5962-0.33215 2.1618-0.91994l55.613-57.799c1.1179-1.1618 1.1176-2.9994-7.29e-4 -4.1609l-56.04-58.201c-0.56552-0.58733-1.3457-0.91919-2.1611-0.91919h-41.809c-1.6569 0-3 1.3431-3 3 0 0.76901 0.29531 1.5087 0.82496 2.0662z" fill="#FFF" fill-rule="evenodd"/>
-</svg>

data/app/assets/javascripts/govuk_publishing_components/components/header.js

@@ -1,8 +0,0 @@
-// DO NOT MAKE CHANGES TO THIS FILE
-// It is a temporary copy of layout-header.js and will be deleted shortly
-
-// This component relies on JavaScript from GOV.UK Frontend
-// = require govuk/components/header/header.js
-window.GOVUK = window.GOVUK || {}
-window.GOVUK.Modules = window.GOVUK.Modules || {}
-window.GOVUK.Modules.Header = window.GOVUKFrontend

data/app/assets/javascripts/govuk_publishing_components/lib/auto-track-event.js

@@ -1,31 +0,0 @@
-// migrated from govuk_frontend_toolkit
-;(function (global) {
-  'use strict'
-
-  var GOVUK = global.GOVUK || {}
-  GOVUK.Modules = GOVUK.Modules || {}
-
-  GOVUK.Modules.AutoTrackEvent = function () {
-    this.start = function (element) {
-      var options = { nonInteraction: 1 } // automatic events shouldn't affect bounce rate
-      var category = element.data('track-category')
-      var action = element.data('track-action')
-      var label = element.data('track-label')
-      var value = element.data('track-value')
-
-      if (typeof label === 'string') {
-        options.label = label
-      }
-
-      if (value || value === 0) {
-        options.value = value
-      }
-
-      if (GOVUK.analytics && GOVUK.analytics.trackEvent) {
-        GOVUK.analytics.trackEvent(category, action, options)
-      }
-    }
-  }
-
-  global.GOVUK = GOVUK
-})(window)

data/app/assets/stylesheets/govuk_publishing_components/components/_chevron-banner.scss

@@ -1,138 +0,0 @@
-$red: #e61e32;
-$dark-red: #b31424;
-$yellow: #ffdd00;
-
-.gem-c-chevron-banner {
-  position: relative;
-}
-
-.gem-c-chevron-banner__chevron-point,
-.gem-c-chevron-banner__chevron-base {
-  stroke: $red;
-  stroke-width: 2.4;
-}
-
-.gem-c-chevron-banner:hover,
-.gem-c-chevron-banner--hover-border:hover {
-  .gem-c-chevron-banner__text {
-    background-color: $dark-red;
-    border-color: $dark-red;
-  }
-
-  .gem-c-chevron-banner__chevron-point,
-  .gem-c-chevron-banner__chevron-base {
-    fill: $dark-red;
-    stroke: $dark-red;
-  }
-}
-
-.gem-c-chevron-banner--hover-border:hover {
-  .gem-c-chevron-banner__text {
-    border-color: govuk-colour("white");
-  }
-
-  .gem-c-chevron-banner__chevron-point,
-  .gem-c-chevron-banner__chevron-base {
-    stroke: govuk-colour("white");
-  }
-}
-
-.gem-c-chevron-banner__link:focus {
-  background-color: transparent; // This is to override some generic link styling which sets a background colour on focus
-  text-decoration: none;
-  outline: 0;
-
-  .gem-c-chevron-banner__text {
-    color: govuk-colour("black");
-    background-color: $yellow;
-    border-color: govuk-colour("black");
-  }
-
-  .gem-c-chevron-banner__text:after {
-    background-image: image-url("govuk_publishing_components/chevron-banner/chevron-banner-small-focus.svg");
-  }
-
-  .gem-c-chevron-banner__chevron-point,
-  .gem-c-chevron-banner__chevron-base {
-    fill: $yellow;
-    stroke: govuk-colour("black");
-  }
-}
-
-.gem-c-chevron-banner__chevron {
-  display: none;
-
-  @include govuk-media-query(450px) {
-    display: inline-block;
-    height: 100%;
-    position: absolute;
-    left: 70%;
-    margin-left: (45px + govuk-spacing(4));
-    top: 0;
-  }
-
-  @include govuk-media-query($from: 450px, $until: desktop) {
-    margin-left: (25px + govuk-spacing(2));
-  }
-}
-
-.gem-c-chevron-banner__text:after {
-  content: "";
-  position: absolute;
-  right: 15px;
-  top: 0;
-  width: 25px;
-  height: 100%;
-  background-image: image-url("govuk_publishing_components/chevron-banner/chevron-banner-small.svg");
-  background-size: 25px 25px;
-  background-repeat: no-repeat;
-  background-position: center right;
-
-  @include govuk-media-query(450px) {
-    display: none;
-  }
-}
-
-.gem-c-chevron-banner__text {
-  display: block;
-  position: relative;
-  padding: govuk-spacing(4) 45px govuk-spacing(4) govuk-spacing(4);
-  background-color: $red;
-  border-radius: 5px;
-  box-sizing: border-box;
-  width: 100%;
-  border: 2px solid $red;
-  z-index: 1;
-
-  @include govuk-media-query($from: 450px, $until: desktop) {
-    padding: govuk-spacing(2) 25px govuk-spacing(2) govuk-spacing(2);
-  }
-
-  @include govuk-media-query($from: 450px) {
-    border-radius: 5px 0 0 5px;
-    border-right: 0;
-    width: 70%;
-    box-sizing: content-box;
-  }
-}
-
-.gem-c-chevron-banner__link:link,
-.gem-c-chevron-banner__link:visited,
-.gem-c-chevron-banner__link:hover {
-  @include govuk-font(24, $weight: bold);
-  color: govuk-colour("white");
-  text-decoration: none;
-}
-
-// IE "hack" to stop the chevron SVG being stretched
-@media screen and (-ms-high-contrast: active), (-ms-high-contrast: none) {
-  .gem-c-chevron-banner__chevron {
-    max-width: 160px;
-  }
-}
-
-@media screen and (min-width: 0\0) {
-  .gem-c-chevron-banner__chevron {
-    max-width: 160px;
-  }
-}

data/app/assets/stylesheets/govuk_publishing_components/components/_list.scss

@@ -1 +0,0 @@
-@import "govuk/components/list/list";

data/app/assets/stylesheets/govuk_publishing_components/components/helpers/_variables.scss

@@ -1,27 +0,0 @@
-// Forked from GOV.UK Frontend, namespace changed to ensure no conflicts.
-
-$gem-spacing-scale-0: 0;
-$gem-spacing-scale-1: 5px;
-$gem-spacing-scale-2: 10px;
-$gem-spacing-scale-3: 15px;
-$gem-spacing-scale-4: 20px;
-$gem-spacing-scale-5: 30px;
-$gem-spacing-scale-6: 40px;
-$gem-spacing-scale-7: 50px;
-$gem-spacing-scale-8: 60px;
-
-$gem-text-colour: $govuk-text-colour;
-$gem-secondary-text-colour: $govuk-secondary-text-colour;
-
-// Border widths
-$gem-border-width-mobile: 4px;
-$gem-border-width-tablet: 5px;
-$gem-border-width-form-element: 2px;
-$gem-border-width-error: 4px;
-
-// Focus
-$gem-focus-width: 3px;
-$gem-focus-colour: $govuk-focus-colour;
-
-$gem-error-colour: govuk-colour("red");
-$gem-success-colour: govuk-colour("green");

data/app/assets/stylesheets/govuk_publishing_components/components/mixins/_back-arrow.scss

@@ -1,13 +0,0 @@
-// An arrow to represent a "back" link
-
-@mixin back-arrow {
-  border-bottom: 5px solid transparent;
-  border-right: 6px solid;
-  border-top: 5px solid transparent;
-  content: "";
-  display: block;
-  left: 0;
-  margin-top: -6px;
-  position: absolute;
-  top: 50%;
-}

data/app/assets/stylesheets/govuk_publishing_components/components/mixins/_clearfix.scss

@@ -1,8 +0,0 @@
-// Mixin to clear floats
-@mixin gem-h-clearfix {
-  &:after {
-    content: "";
-    display: block;
-    clear: both;
-  }
-}

data/app/views/govuk_publishing_components/components/_chevron_banner.html.erb

@@ -1,19 +0,0 @@
-<%
-  href ||= false
-  text ||= false
-  hover_border ||= false
-
-  data_attributes ||= {}
-  data_attributes[:module] = 'track-click' if data_attributes.any?
-%>
-<% if href && text %>
-  <div class="gem-c-chevron-banner <%= "gem-c-chevron-banner--hover-border" if hover_border %>">
-    <%= link_to href, class: "gem-c-chevron-banner__link", data: data_attributes, role: "link" do %>
-      <span class="gem-c-chevron-banner__text"><%= text %></span>
-      <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 175 109" class="gem-c-chevron-banner__chevron" preserveAspectRatio="xMidYMid meet">
-        <path class="gem-c-chevron-banner__chevron-point" fill="#E61E32" fill-rule="nonzero" d="M91.611 51.664c1.0371 1.1432 1.0375 2.8869.000802 4.0305l-44.991 49.634c-.37092.40919-.33989 1.0416.069307 1.4125.18394.16674.42334.25909.6716.25909h36.892c.55978 0 1.0939-.2346 1.4727-.6468l46.534-50.643c1.0549-1.148 1.0546-2.9127-.000709-4.0604L85.3617.64689c-.37873-.41188-.91268-.64628-1.4722-.64628h-36.891c-.55228 0-1 .44772-1 1 0 .24841.092454.48792.25936.6719l45.352 49.992z" transform="translate(0 1)"></path>
-        <path class="gem-c-chevron-banner__chevron-base" fill="#E61E32" fill-rule="nonzero" d="M-37.997 1l.35768 107h40.408c.55978 0 1.0939-.2346 1.4727-.6468l46.534-50.643c1.0549-1.148 1.0546-2.9127-.0007095-4.0604l-46.898-51.003c-.37873-.41188-.91268-.64628-1.4722-.64628h-40.402z" vector-effect="non-scaling-stroke"></path>
-      </svg>
-    <% end %>
-  </div>
-<% end %>

data/app/views/govuk_publishing_components/components/_subscription-links.html.erb

@@ -1,85 +0,0 @@
-<%
-  # DO NOT MAKE CHANGES TO THIS FILE
-  # It is a temporary copy of _subscription_links.html.erb and will be deleted shortly
-
-  brand ||= false
-  brand_helper = GovukPublishingComponents::AppHelpers::BrandHelper.new(brand)
-
-  sl_helper = GovukPublishingComponents::Presenters::SubscriptionLinksHelper.new(local_assigns)
-  shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new(local_assigns)
-
-  local_assigns[:margin_bottom] ||= 0
-  local_assigns[:margin_bottom] = 0 if local_assigns[:margin_bottom] > 9
-
-  css_classes = %w( gem-c-subscription-links )
-  css_classes << (shared_helper.get_margin_bottom) unless local_assigns[:margin_bottom] == 0
-  css_classes << brand_helper.brand_class
-  css_classes << "gem-c-subscription-links--with-feed-box" if sl_helper.feed_link_box_value
-
-  data = {"module": "gem-toggle"} if sl_helper.feed_link_box_value
-
-  hide_heading ||= false
-
-  email_signup_link_text_locale = local_assigns[:email_signup_link_text_locale].presence
-  feed_link_text_locale = local_assigns[:feed_link_text_locale].presence
-%>
-<% if sl_helper.component_data_is_valid? %>
-  <%= tag.section class: css_classes, data: data do %>
-    <% unless hide_heading %>
-      <h2 class="gem-c-subscription-links__hidden-header visuallyhidden"><%= t("govuk_component.subscription_links.subscriptions", default: "Subscriptions") %></h2>
-    <% end %>
-    <ul
-      class="gem-c-subscription-links__list<%= ' gem-c-subscription-links__list--small' if local_assigns[:small_form] == true %>"
-      <%= "data-module=track-click" if sl_helper.tracking_is_present? %>
-    >
-      <% if sl_helper.email_signup_link.present? %>
-        <li class="gem-c-subscription-links__list-item<%= ' gem-c-subscription-links__list-item--small' if local_assigns[:small_form] == true %>" >
-          <% email_link_text = capture do %>
-           <svg xmlns="http://www.w3.org/2000/svg" width="21" height="15.75" class="gem-c-subscription-links__icon" focusable="false" fill="currentColor" aria-hidden="true"><path d="M19.687 0H1.312C.589 0 0 .587 0 1.313v13.124c0 .726.588 1.313 1.313 1.313h18.374c.725 0 1.313-.587 1.313-1.313V1.313C21 .587 20.412 0 19.687 0zm-2.625 2.625L10.5 7.875l-6.563-5.25h13.126zm1.313 10.5H2.625V3.937L10.5 10.5l7.875-6.563v9.188z"/></svg>
-           <%= sl_helper.email_signup_link_text %>
-          <% end %>
-          <%= link_to email_link_text, sl_helper.email_signup_link, {
-            class: "gem-c-subscription-links__item #{brand_helper.color_class} gem-c-subscription-links__item--link",
-            data: sl_helper.email_signup_link_data_attributes,
-            lang: email_signup_link_text_locale
-          } %>
-        </li>
-      <% end %>
-
-      <% if sl_helper.feed_link_box_value || sl_helper.feed_link %>
-        <li class="gem-c-subscription-links__list-item<%= ' gem-c-subscription-links__list-item--small' if local_assigns[:small_form] == true %>">
-          <% feed_link_text = capture do %>
-            <svg xmlns="http://www.w3.org/2000/svg" width="15" height="15" class="gem-c-subscription-links__icon" focusable="false" fill="currentColor" aria-hidden="true"><path d="M1.996 11A2 2 0 0 0 0 12.993c0 1.101.895 1.99 1.996 1.99 1.106 0 2-.889 2-1.99a2 2 0 0 0-2-1.993zM.002 5.097V7.97c1.872 0 3.632.733 4.958 2.059A6.984 6.984 0 0 1 7.015 15h2.888c0-5.461-4.443-9.903-9.9-9.903zM.006 0v2.876c6.676 0 12.11 5.44 12.11 12.124H15C15 6.731 8.273 0 .006 0z"/></svg>
-           <%= sl_helper.feed_link_text %>
-          <% end %>
-          <%= tag.button feed_link_text, {
-            class: "gem-c-subscription-links__item #{brand_helper.color_class} gem-c-subscription-links__item--button",
-            data: sl_helper.feed_link_data_attributes,
-            lang: feed_link_text_locale
-          } if sl_helper.feed_link_box_value %>
-          <%= link_to feed_link_text, sl_helper.feed_link,
-            {
-              class: "gem-c-subscription-links__item #{brand_helper.color_class} gem-c-subscription-links__item--link",
-              data: sl_helper.feed_link_data_attributes,
-              lang: feed_link_text_locale
-            } unless sl_helper.feed_link_box_value %>
-        </li>
-      <% end %>
-    </ul>
-
-    <% if sl_helper.feed_link_box_value %>
-      <div class="gem-c-subscription-links__feed-box js-hidden" id="<%= sl_helper.feed_box_id %>">
-        <h3 class="gem-c-subscription-links__feed-hidden-description visuallyhidden govuk-!-margin-top-0"><%= sl_helper.feed_link_text %></h3>
-        <div lang="en">
-          <%= render "govuk_publishing_components/components/input", {
-            label: {
-              text: "Copy and paste this URL into your feed reader"
-            },
-            name: "feed-reader-box",
-            value: feed_link_box_value
-          } %>
-        </div>
-      </div>
-    <% end %>
-  <% end %>
-<% end %>

data/app/views/govuk_publishing_components/components/_translation-nav.html.erb

@@ -1,33 +0,0 @@
-<%
-  # DO NOT MAKE CHANGES TO THIS FILE
-  # It is a temporary copy of _translation_nav.html.erb and will be deleted shortly
-
-  brand ||= false
-  brand_helper = GovukPublishingComponents::AppHelpers::BrandHelper.new(brand)
-  translation_helper = GovukPublishingComponents::Presenters::TranslationNavHelper.new(local_assigns)
-%>
-<% if translation_helper.has_translations? %>
-  <nav role="navigation"
-    class="gem-c-translation-nav <%= translation_helper.classes %> <%= brand_helper.brand_class %>"
-    aria-label="<%= t("common.translations") %>"
-    <%= "data-module=\"track-click\"" if translation_helper.tracking_is_present? %>
-  >
-    <ul class="gem-c-translation-nav__list">
-      <% translation_helper.translations.each.with_index do |translation, i| %>
-        <li class="gem-c-translation-nav__list-item">
-          <% if translation[:active] %>
-            <span lang="<%= translation[:locale] %>"><%= translation[:text] %></span>
-          <% else %>
-            <%= link_to translation[:text], translation[:base_path],
-              hreflang: translation[:locale],
-              lang: translation[:locale],
-              rel: "alternate",
-              class: "gem-c-translation-nav__link #{brand_helper.color_class}",
-              data: translation[:data_attributes]
-            %>
-          <% end %>
-        </li>
-      <% end %>
-    </ul>
-  </nav>
-<% end %>

data/app/views/govuk_publishing_components/components/docs/chevron_banner.yml

@@ -1,33 +0,0 @@
-name: Chevron Banner
-description: A branded banner for use on EU Exit campaign pages. This should not be used on non-campaign pages.
-accessibility_criteria: |
-  The component must:
-
-  - accept focus
-  - be focusable with a keyboard
-  - be usable with a keyboard
-  - be usable with touch
-  - indicate when they have focus
-
-shared_accessibility_criteria:
-- link
-examples:
-  default:
-    data:
-      href: '/test-link'
-      text: 'Gwiriwch beth sydd angen i chi wneud os nad oes cytundeb'
-  with_hover_border:
-    data:
-      href: '/test-link'
-      text: 'This is some text'
-      hover_border: true
-    context:
-      dark_background: true
-  with_data_attributes:
-    data:
-      href: '/test-link'
-      text: 'This is some text'
-      data_attributes:
-        track-category: "startButtonClicked"
-        track-action: "/test-link"
-        track-label: "This is some text"

data/app/views/govuk_publishing_components/components/docs/subscription-links.yml

@@ -1,103 +0,0 @@
-# DO NOT MAKE CHANGES TO THIS FILE
-# It is a temporary copy of subscription_links.yml and will be deleted shortly
-
-name: Subscription links
-description: Links to ‘Get emails’ and ‘Subscribe to feed’
-body: |
-  <strong>NOTE: This component includes a h2 heading by default but can be suppressed by using `hide_heading` option (see below)<strong>
-accessibility_criteria: |
-  Icons in subscription links must be presentational and ignored by screen readers.
-
-  Toggle elements in the component must:
-
-  - be usable with a keyboard
-  - be usable with touch
-  - be recognised by screen readers as a button
-  - announce to screen readers whether they are expanded or collapsed
-  - show hidden elements by default when Javascript is disabled
-shared_accessibility_criteria:
-  - link
-examples:
-  default:
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      feed_link: '/foreign-travel-advice/singapore.atom'
-  with_margin:
-    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 no margin bottom, although some margin is supplied by the links themselves (so that when they stack on mobile there is space between them).
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      feed_link: '/foreign-travel-advice/singapore.atom'
-      margin_bottom: 9
-  with_only_email_signup_link:
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-  with_only_feed_link:
-    data:
-      feed_link: '/foreign-travel-advice/singapore.atom'
-  with_custom_text:
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      email_signup_link_text: 'Get notifications'
-      feed_link: '/foreign-travel-advice/singapore.atom'
-      feed_link_text: 'View feed'
-  with_copyable_feed_link:
-    description: |
-      This option changes the feed link to a toggle control, which opens a hidden element containing an input prepopulated with the value passed to the component, usually a URL to an atom feed. This uses the [form input](/component-guide/input) component.
-
-      Note that this option overrides the feed_link option, so if both are passed feed_link is ignored. Note that a value for email_signup_link can also be passed as normal.
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      feed_link_box_value: 'https://www.gov.uk/government/organisations/attorney-generals-office.atom'
-  with_branding:
-    description: Organisation [colour branding](https://github.com/alphagov/govuk_publishing_components/blob/master/docs/component_branding.md) can be added to the component as shown.
-    data:
-      brand: 'attorney-generals-office'
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      feed_link: '/foreign-travel-advice/singapore.atom'
-  with_tracking:
-    description: Data attributes can be passed for each link as shown.
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      email_signup_link_data_attributes: {
-        track_category: 'email_link_category',
-        track_action: 1.1,
-        track_label: 'email_link_label',
-        track_options: {
-          dimension28: 1,
-          dimension29: 'dimension29EmailLink'
-        }
-      }
-      feed_link_box_value: 'https://www.gov.uk/government/organisations/attorney-generals-office.atom'
-      feed_link_data_attributes: {
-        track_category: 'feed_link_category',
-        track_action: 1.2,
-        track_label: 'feed_link_label',
-        track_options: {
-          dimension28: 7,
-          dimension29: 'dimension29feedLink'
-        }
-      }
-  as_small_form:
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      feed_link: '/foreign-travel-advice/singapore.atom'
-      small_form: true
-  without_heading:
-    description: |
-      By default the component includes an h2 heading. The component could be used anywhere on the page and could mean that it produces invalid markup or make the site unaccessible.
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      feed_link: '/foreign-travel-advice/singapore.atom'
-      hide_heading: true
-  with_a_different_language:
-    data:
-      email_signup_link: '/foreign-travel-advice/singapore/email-signup'
-      email_signup_link_text: 'Recevez des notifications'
-      email_signup_link_text_locale: 'fr'
-      feed_link: '/foreign-travel-advice/singapore.atom'
-      feed_link_text: 'Flux RSS'
-      feed_link_text_locale: 'fr'
-    description: |
-      The component is used on translated pages that don't have a translation for the text strings. This means that it could display the fallback English string if the translate method can't find an appropriate translation. This makes sure that the `lang` can be set to ensure that browsers understand which parts of the page are in each language.
-
-      The `lang` attribute **must** be set to a [valid BCP47 string](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang#Language_tag_syntax). A valid code can be the two or three letter language code - for example, English is `en` or `eng`, Korean is `ko` or `kor` - but if in doubt please check.