govuk_publishing_components 46.3.1 → 47.0.0

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

@@ -15,7 +15,7 @@ accessibility_criteria: |
   - be part of a correct heading structure for a page
   - be semantically represented as a heading
   - convey the heading level
-uses_component_wrapper_helper: true  
+uses_component_wrapper_helper: true
 examples:
   default:
     data:
@@ -26,7 +26,7 @@ examples:
       heading_level: 3
   different_font_sizes:
     description: |
-      Set a different font size for the heading. Uses the [GOV.UK Frontend heading sizes](https://design-system.service.gov.uk/styles/typography/#headings) but defaults to 27px for legacy reasons. Valid options are `xl`, `l`, `m` and `s`.
+      Set a different font size for the heading. Uses the [GOV.UK Frontend heading sizes](https://design-system.service.gov.uk/styles/headings/) but defaults to 27px for legacy reasons. Valid options are `xl`, `l`, `m` and `s`.
 
       This option is not tied to the `heading_level` option in order to give flexibility.
     data:
@@ -47,14 +47,6 @@ examples:
     data:
       text: 'Really big bottom margin'
       margin_bottom: 9
-  with_mobile_top_margin:
-    description: |
-      On publications and consultations the layout of the page requires that the heading component have spacing above it on mobile. Since this is a specific use case, this is now an option on the component rather than the default behaviour.
-
-      It is intended that this option will ultimately be deprecated once more of the frontend is componentised and a general component model of margins is implemented.
-    data:
-      text: 'Consultation description'
-      mobile_top_margin: true
   with_border:
     description: A top border can be applied to the component of different thicknesses. Accepted values are `1` (`1px`), `2` (`2px`) and `5` (`5px`). Note that this works best with padding applied.
     data:
@@ -82,3 +74,35 @@ examples:
     data:
       text: "Ein gweinidogion"
       lang: "cy"
+  with_context:
+    description: Context is applied sometimes where the heading is used as a page title H1. Note that the text size of the context is larger than the default size of the heading, so a larger `font_size` should be applied as shown.
+    data:
+      text: I like toast
+      context: Food opinion
+      font_size: "xl"
+  with_context_inside:
+    description: |
+      If the context should be considered part of the page heading, you can nest the context within the <code><h1></code>.
+    data:
+      context: Publication
+      text: My page title
+      font_size: "xl"
+      context_inside: true
+  with_context_language_labelled:
+    description: |
+      Sometimes this component appears on a page that has been translated. The title will naturally be supplied in the required language but the context string may fall back to the default. In these instances we need to label the language so the page remains semantic and screenreaders can handle the switch.
+
+      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.
+    data:
+      context: Publication
+      context_locale: en
+      text: My page title
+      font_size: "xl"
+  with_context_inverted:
+    data:
+      context: Publication
+      text: My page title
+      font_size: "xl"
+      inverse: true
+    context:
+      dark_background: true

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

@@ -3,7 +3,7 @@ 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/typography/#links-on-dark-backgrounds).
+  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:

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

@@ -183,6 +183,15 @@ examples:
         brand: cabinet-office
         crest: 'single-identity'
       inline: true
+  no_underline_until_hover:
+    description: Remove the underline text-decoration unless hovered. Useful when combined with the `inverse` option.
+    data:
+      organisation:
+        name: Cabinet Office
+        url: '/government/organisations/cabinet-office'
+        brand: cabinet-office
+        crest: 'single-identity'
+      hide_underline: true
   on_a_dark_background:
     data:
       organisation:

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

@@ -11,6 +11,7 @@ accessibility_criteria: |
   - is the first items that screen readers hear and that keyboard users tab to
 accessibility_excluded_rules:
   - skip-link # This component is creating a reference to #content which is part of the layout
+uses_component_wrapper_helper: true
 examples:
   default:
     data:

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

@@ -11,6 +11,7 @@ body: |
   - creating a new component allows further iteration without impacting the accordion
 
   Background information relating to the testing and research behind this component can be found on the [Modelling Services wiki](https://gov-uk.atlassian.net/wiki/spaces/MS/pages) in Q2 to Q4, 2017/18.
+uses_component_wrapper_helper: true
 accessibility_criteria: |
   The step by step navigation must:
 

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

@@ -12,6 +12,7 @@ accessibility_criteria: |
   Always place the step by step navigation header at the top of a page, before the `<main>` element. Placing the component here means that the "Skip to main content" link allows the user to skip all navigation links, including the step by step navigation header.
 shared_accessibility_criteria:
   - link
+uses_component_wrapper_helper: true
 examples:
   default:
     data:

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

@@ -16,6 +16,7 @@ accessibility_criteria: |
   - display multiple links outside of a heading in a separate list
 shared_accessibility_criteria:
   - link
+uses_component_wrapper_helper: true
 examples:
   default:
     data:

data/config/locales/ar.yml

@@ -36,14 +36,6 @@ ar:
       type:
         characters: أحرف
         words: كلمات
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: أو
     contents_list:

data/config/locales/az.yml

@@ -32,14 +32,6 @@ az:
       type:
         characters: simvol
         words: söz
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: və ya
     contents_list:

data/config/locales/be.yml

@@ -34,14 +34,6 @@ be:
       type:
         characters: знакаў
         words: словаў
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: або
     contents_list:

data/config/locales/bg.yml

@@ -32,14 +32,6 @@ bg:
       type:
         characters: символа
         words: думи
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: или
     contents_list:

data/config/locales/bn.yml

@@ -32,14 +32,6 @@ bn:
       type:
         characters: ক্যারেক্টার
         words: শব্দসমষ্টি
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: অথবা
     contents_list:

data/config/locales/cs.yml

@@ -33,14 +33,6 @@ cs:
       type:
         characters: znaky
         words: slova
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: nebo
     contents_list:

data/config/locales/cy.yml

@@ -36,14 +36,6 @@ cy:
       type:
         characters: nodau
         words: geiriau
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: neu
     contents_list:

data/config/locales/da.yml

@@ -32,14 +32,6 @@ da:
       type:
         characters: Tegn
         words: ord
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: eller
     contents_list:

data/config/locales/de.yml

@@ -32,14 +32,6 @@ de:
       type:
         characters: Zeichen
         words: Wörter
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: oder
     contents_list:

data/config/locales/dr.yml

@@ -35,14 +35,6 @@ dr:
       type:
         characters: ارقام
         words: کلمات
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: یا
     contents_list:

data/config/locales/el.yml

@@ -32,14 +32,6 @@ el:
       type:
         characters: χαρακτήρες
         words: λέξεις
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: ή
     contents_list:

data/config/locales/en.yml

@@ -32,14 +32,6 @@ en:
       type:
         characters: characters
         words: words
-    chart:
-      table_dropdown: View data as a table
-      accessibility_html: This chart is a visual representation of the data available in the table.
-      accessibility_link: Skip to "%{chart_heading}" data table
-      accessibility_heading: Data table for "%{chart_heading}"
-    chat_entry:
-      heading: Ask GOV.UK Chat
-      description: Get quick, tailored answers to your business questions with GOV.UK’s new AI tool
     checkboxes:
       or: or
     contents_list:

data/config/locales/es-419.yml

@@ -32,14 +32,6 @@ es-419:
       type:
         characters: caracteres
         words: palabras
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: o
     contents_list:

data/config/locales/es.yml

@@ -32,14 +32,6 @@ es:
       type:
         characters: caracteres
         words: palabras
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: o bien
     contents_list:

data/config/locales/et.yml

@@ -32,14 +32,6 @@ et:
       type:
         characters: tähemärki
         words: sõnu
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: või
     contents_list:

data/config/locales/fa.yml

@@ -32,14 +32,6 @@ fa:
       type:
         characters: کاراکتر
         words: کلمه
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: یا
     contents_list:

data/config/locales/fi.yml

@@ -32,14 +32,6 @@ fi:
       type:
         characters: merkkejä
         words: sanoja
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: tai
     contents_list:

data/config/locales/fr.yml

@@ -32,14 +32,6 @@ fr:
       type:
         characters: caractères
         words: mots
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: ou
     contents_list:

data/config/locales/gd.yml

@@ -34,14 +34,6 @@ gd:
       type:
         characters: Figiúr
         words: Carachtar
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: Cá háit
     contents_list:

data/config/locales/gu.yml

@@ -32,14 +32,6 @@ gu:
       type:
         characters: અક્ષરો
         words: શબ્દો
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: અથવા
     contents_list:

data/config/locales/he.yml

@@ -32,14 +32,6 @@ he:
       type:
         characters: תווים
         words: מילים
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: או
     contents_list:

data/config/locales/hi.yml

@@ -32,14 +32,6 @@ hi:
       type:
         characters: अक्षर
         words: शब्द
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: या
     contents_list:

data/config/locales/hr.yml

@@ -33,14 +33,6 @@ hr:
       type:
         characters: znakova
         words: riječi
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: ili
     contents_list:

data/config/locales/hu.yml

@@ -32,14 +32,6 @@ hu:
       type:
         characters: karakterek
         words: szavak
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: vagy
     contents_list:

data/config/locales/hy.yml

@@ -34,14 +34,6 @@ hy:
       type:
         characters: նիշ
         words: բառ
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: կամ
     contents_list:

data/config/locales/id.yml

@@ -31,14 +31,6 @@ id:
       type:
         characters: karakter
         words: kata
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: atau
     contents_list:

data/config/locales/is.yml

@@ -32,14 +32,6 @@ is:
       type:
         characters: stafi
         words: orð
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: eða
     contents_list:

data/config/locales/it.yml

@@ -32,14 +32,6 @@ it:
       type:
         characters: caratteri
         words: parole
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: o
     contents_list:

data/config/locales/ja.yml

@@ -31,14 +31,6 @@ ja:
       type:
         characters: 文字
         words: 単語
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: または
     contents_list:

data/config/locales/ka.yml

@@ -32,14 +32,6 @@ ka:
       type:
         characters: სიმბოლოები
         words: სიტყვები
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: ან
     contents_list:

data/config/locales/kk.yml

@@ -32,14 +32,6 @@ kk:
       type:
         characters: таңба
         words: сөз
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: немесе
     contents_list:

data/config/locales/ko.yml

@@ -31,14 +31,6 @@ ko:
       type:
         characters:
         words:
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or:
     contents_list:

data/config/locales/lt.yml

@@ -33,14 +33,6 @@ lt:
       type:
         characters: spaudos ženklų
         words: žodžių
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: arba
     contents_list:

data/config/locales/lv.yml

@@ -32,14 +32,6 @@ lv:
       type:
         characters: rakstzīmes
         words: vārdi
-    chart:
-      accessibility_heading:
-      accessibility_html:
-      accessibility_link:
-      table_dropdown:
-    chat_entry:
-      description:
-      heading:
     checkboxes:
       or: vai
     contents_list: