govuk_publishing_components 18.1.2 → 18.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76671448dbbc374aa50abc3ed74447f29a64e3d251202b9bf9b28b4e3a5270aa
-  data.tar.gz: 0656f8f058bed2e8bc88f598ad7b157a71779de3d6d937840d9f44ce7df49046
+  metadata.gz: 9ac6e954b1c78501866e17af77d1a1ccbe4bdc265a8775a6e9546ab9791f00ab
+  data.tar.gz: 6069d12624e6ad77aa88b817ea746ee21058b315057f65a184ec94621def5215
 SHA512:
-  metadata.gz: f84c45318ba0763c5e2072aa8252d663f38a4382df2a5fab88f0b511709cd98df194f3c5b11100c08521ccd28ed61b01815e069e98966ea887231c3fc37acab9
-  data.tar.gz: bb1930de7843b8736df25f75ababde79d230161f3277e065447898757224a7544ec9de9f639c8af809eaf8298e1c2d4129075a43e2e221acf74af90e03967115
+  metadata.gz: f57d71f018e862dc34d6a3c2a25fb36901443d6463238de63632bd8bca9c02916372a18e4f45338338177de1fe181f10ce73f6fff073b1939ccbea72191863e3
+  data.tar.gz: fed6631e756f445a51f5af976375b250c435067646bb479d6c4224874930fa03d9485422977ec54e7357311f37c16ab2f47cb00a17228c482ee92992058281c3

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

@@ -6,7 +6,7 @@ window.GOVUK.Modules = window.GOVUK.Modules || {};
 (function (Modules) {
   'use strict'
 
-  Modules.Checkboxes = function () {
+  Modules.GovukCheckboxes = function () {
     this.start = function (scope) {
       var _this = this
       this.applyAriaControlsAttributes(scope)

data/app/assets/stylesheets/govuk_publishing_components/_all_components.scss

@@ -75,6 +75,7 @@
 @import "components/step-by-step-nav";
 @import "components/subscription-links";
 @import "components/success-alert";
+@import "components/summary-list";
 @import "components/tabs";
 @import "components/table";
 @import "components/taxonomy-list";

data/app/assets/stylesheets/govuk_publishing_components/components/_image-card.scss

@@ -1,15 +1,10 @@
 .gem-c-image-card {
   @include govuk-clearfix;
   @include govuk-text-colour;
-
-  margin: 0 (- govuk-spacing(3)) govuk-spacing(6) (- govuk-spacing(3));
   position: relative;
 }
 
 .gem-c-image-card__image-wrapper {
-  @include govuk-grid-column($width: one-third, $at: mobile);
-  @include govuk-grid-column($width: full, $at: tablet);
-
   margin: 0;
 
   @include govuk-media-query($from: tablet) {
@@ -23,16 +18,25 @@
   }
 }
 
+@include govuk-media-query($from: mobile, $until: tablet) {
+  .gem-c-image-card {
+    margin: 0 (- govuk-spacing(3)) govuk-spacing(6) (- govuk-spacing(3));
+  }
+
+  .gem-c-image-card__image-wrapper {
+    @include govuk-grid-column($width: one-third, $at: mobile);
+  }
+
+  .gem-c-image-card__text-wrapper {
+    @include govuk-grid-column($width: two-thirds, $at: mobile);
+  }
+}
+
 .gem-c-image-card__image {
   display: block;
   max-width: 100%;
 }
 
-.gem-c-image-card__text-wrapper {
-  @include govuk-grid-column($width: two-thirds, $at: mobile);
-  @include govuk-grid-column($width: full, $at: tablet);
-}
-
 .gem-c-image-card__title {
   @include govuk-font(19, $weight: bold);
   margin: 0;

data/app/assets/stylesheets/govuk_publishing_components/components/_layout-header.scss

@@ -18,11 +18,20 @@
   border-bottom-color: govuk-colour("dark-grey", $legacy: "grey-1");
 }
 
-.govuk-header__logo {
+.gem-c-header__logo {
   white-space: nowrap;
+  width: auto;
 }
 
-.govuk-header__product-name {
+.gem-c-header__content {
+  width: auto;
+
+  @include govuk-media-query($from: desktop) {
+    float: right;
+  }
+}
+
+.gem-c-header__product-name {
   display: none;
 
   @include govuk-media-query($from: tablet) {

data/app/assets/stylesheets/govuk_publishing_components/components/_summary-list.scss

@@ -0,0 +1,27 @@
+@import "govuk/components/summary-list/summary-list";
+
+.gem-c-summary-list {
+  position: relative;
+  border-bottom: 1px solid $govuk-border-colour;
+
+  @include govuk-font(19);
+  @include govuk-responsive-margin(6, "top");
+
+  &:nth-of-type(1) {
+    margin-top: govuk-spacing(0);
+  }
+
+  &:nth-last-of-type(1) {
+    border-bottom: 0;
+  }
+}
+
+.gem-c-summary-list__edit-section-link {
+  position: absolute;
+  top: 0;
+  right: 0;
+}
+
+.gem-c-summary__block {
+  @include govuk-responsive-margin(6, "bottom");
+}

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

@@ -10,7 +10,7 @@
 %>
 <header class="gem-c-layout-header govuk-header gem-c-layout-header--<%= environment %>" role="banner" data-module="govuk-header">
   <div class="govuk-header__container <%= width_class %>">
-    <div class="govuk-header__logo">
+    <div class="govuk-header__logo gem-c-header__logo">
       <a href="/" class="govuk-header__link govuk-header__link--homepage">
         <span class="govuk-header__logotype">
           <svg role="presentation" focusable="false" class="govuk-header__logotype-crown" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 132 97" height="32" width="36">
@@ -24,7 +24,7 @@
           </span>
         </span>
 
-        <span class="govuk-header__product-name">
+        <span class="govuk-header__product-name gem-c-header__product-name">
           <%= product_name %>
         </span>
 
@@ -33,11 +33,11 @@
         </span>
       </a>
 
-    </div><div class="govuk-header__content">
+    </div><div class="govuk-header__content gem-c-header__content">
 
     <% if navigation_items.any? %>
-    <button role="button" class="govuk-header__menu-button govuk-js-header-toggle" aria-controls="navigation" aria-label="Show or hide Top Level Navigation">Menu</button>
-    <nav>
+    <button role="button" class="govuk-header__menu-button gem-c-header__menu-button govuk-js-header-toggle" aria-controls="navigation" aria-label="Show or hide Top Level Navigation">Menu</button>
+    <nav class="gem-c-header__nav">
       <ul id="navigation" class="govuk-header__navigation govuk-header__navigation--end" aria-label="Top Level Navigation">
         <% navigation_items.each_with_index do |item, index| %>
           <li class="govuk-header__navigation-item <%= "govuk-header__navigation-item--active" if item[:active] %>

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

@@ -0,0 +1,67 @@
+<%
+  id ||= nil
+  title ||= nil
+  edit ||= {}
+  items ||= []
+  block ||= yield
+%>
+<% if title || items.any? %>
+  <%= tag.div class: "gem-c-summary-list", id: id do %>
+    <% if title %>
+      <%= tag.h3 title, class: "govuk-heading-m" %>
+      <% if edit.any? %>
+        <%= tag.ul class: "govuk-summary-list__actions-list" do %>
+          <%= tag.li class: "govuk-summary-list__actions-list-item" do %>
+            <%= link_to edit.fetch(:href),
+                      class: "govuk-link gem-c-summary-list__edit-section-link",
+                      title: "Edit #{title}",
+                      data: edit.fetch(:data_attributes, {}) do %>
+               Edit <%= tag.span title, class: "govuk-visually-hidden" %>
+            <% end %>
+          <% end %>
+        <% end %>
+      <% end %>
+    <% end %>
+
+    <% if items.any? %>
+      <%= tag.dl class: "govuk-summary-list" do %>
+        <% items.each do |item| %>
+          <%= tag.div class: "govuk-summary-list__row" do %>
+
+            <%= tag.dt item[:field], class: "govuk-summary-list__key" %>
+            <%= tag.dd item[:value], class: "govuk-summary-list__value" %>
+
+            <% if item.fetch(:edit, {}).any? || item.fetch(:delete, {}).any? %>
+              <%= tag.dd class: "govuk-summary-list__actions" do %>
+                <%= tag.ul class: "govuk-summary-list__actions-list" do %>
+                  <% if item.fetch(:edit, {}).any? %>
+                    <%= tag.li class: "govuk-summary-list__actions-list-item" do %>
+                      <%= link_to item[:edit].fetch(:href),
+                                  class: "govuk-link",
+                                  title: "Edit #{item[:field]}",
+                                  data: item[:edit].fetch(:data_attributes, {}) do %>
+                        Edit <%= tag.span item[:field], class: "govuk-visually-hidden" %>
+                      <% end %>
+                    <% end %>
+                  <% end %>
+                  <% if item.fetch(:delete, {}).any? %>
+                    <%= tag.li class: "govuk-summary-list__actions-list-item" do %>
+                      <%= link_to item[:delete].fetch(:href),
+                                  class: "govuk-link",
+                                  title: "Delete #{item[:field]}",
+                                  data: item[:edit].fetch(:data_attributes, {}) do %>
+                        Delete <%= tag.span item[:field], class: "govuk-visually-hidden" %>
+                      <% end %>
+                    <% end %>
+                  <% end %>
+                <% end %>
+              <% end %>
+            <% end %>
+          <% end %>
+        <% end %>
+      <% end %>
+    <% end %>
+
+    <%= tag.div block, class: "gem-c-summary__block" if block %>
+  <% end %>
+<% end %>

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

@@ -1,6 +1,7 @@
 <%
   average_title_length ||= false
   context ||= false
+  context_locale ||= false
   context_text = context.is_a?(Hash) ? context[:text] : context
   context_href = context.is_a?(Hash) ? context[:href] : false
   context_data = context.is_a?(Hash) ? context[:data] : false
@@ -13,10 +14,11 @@
   classes = %w(gem-c-title govuk-!-margin-top-8)
   classes << "gem-c-title--inverse" if inverse
   classes << (shared_helper.get_margin_bottom)
+
 %>
 <%= content_tag(:div, class: classes) do %>
   <% if context %>
-    <p class="gem-c-title__context">
+    <p class="gem-c-title__context" <%= "lang=#{context_locale}" if context_locale.present? %>>
       <%= context_href ? link_to(context_text, context_href, class: 'gem-c-title__context-link govuk-link', data: context_data) : context_text %>
     </p>
   <% end %>

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

@@ -0,0 +1,66 @@
+name: Summary list
+description: Use the summary list to summarise information, for example, a user’s responses at the end of a form.
+accessibility_criteria: |
+  Action links in the component must:
+
+  * indicate what the action refers to (e.g. Change _name_)
+shared_accessibility_criteria:
+  - link
+govuk_frontend_components:
+  - summary-list
+examples:
+  default:
+    data:
+      title: "Title, summary and body"
+      items:
+      - field: "Title"
+        value: "Ethical standards for public service providers"
+      - field: "Summary"
+        value: "Find out more about our reviews on the subject of ethical standards for public service providers, including our 2014 report, 2015 guidance and 2018 follow-up publication."
+      - field: "Body"
+        value: "After the government decided in 2013 to expand the remit of the Committee to include public service providers, the Committee on Standards in Public Life produced our first report on the issue: Ethical Standards for Providers of Public Services in 2014."
+
+  with_edit_on_section:
+    data:
+      title: "Title, summary and body"
+      edit:
+        href: "edit-title-summary-body"
+        data_attributes:
+          gtm: "edit-title-summary-body"
+      items:
+      - field: "Title"
+        value: "Ethical standards for public service providers"
+      - field: "Summary"
+        value: "Find out more about our reviews on the subject of ethical standards for public service providers, including our 2014 report, 2015 guidance and 2018 follow-up publication."
+      - field: "Body"
+        value: "After the government decided in 2013 to expand the remit of the Committee to include public service providers, the Committee on Standards in Public Life produced our first report on the issue: Ethical Standards for Providers of Public Services in 2014."
+
+  with_edit_on_individual_items:
+    data:
+      title: "Title, summary and body"
+      items:
+      - field: "Title"
+        value: "Ethical standards for public service providers"
+        edit:
+          href: "edit-title"
+          data_attributes:
+            gtm: "edit-title"
+      - field: "Summary"
+        value: "Find out more about our reviews on the subject of ethical standards for public service providers, including our 2014 report, 2015 guidance and 2018 follow-up publication."
+        edit:
+          href: "edit-summary"
+        delete:
+          href: "delete-summary"
+      - field: "Body"
+        value: "After the government decided in 2013 to expand the remit of the Committee to include public service providers, the Committee on Standards in Public Life produced our first report on the issue: Ethical Standards for Providers of Public Services in 2014."
+        edit:
+          href: "edit-body"
+        delete:
+          href: "delete-body"
+
+  with_block:
+    description: Use the summary list with a block when you need to show an empty state message or load another component.
+    data:
+      title: "Topics"
+      block: |
+        <p class="govuk-body">No topics specified for this document.</p>

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

@@ -24,6 +24,15 @@ examples:
     data:
       context: Publication
       title: My page title
+  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
+      title: My page title
   with_context_link:
     description: |
       It’s unclear if links in the context of a title are useful and are being clicked by users. Data attributes are included to track this behaviour.
@@ -69,3 +78,4 @@ examples:
       margin_bottom: 0
     context:
       dark_background: true
+

data/lib/govuk_publishing_components/version.rb

@@ -1,3 +1,3 @@
 module GovukPublishingComponents
-  VERSION = '18.1.2'.freeze
+  VERSION = '18.2.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk_publishing_components
 version: !ruby/object:Gem::Version
-  version: 18.1.2
+  version: 18.2.0
 platform: ruby
 authors:
 - GOV.UK Dev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-15 00:00:00.000000000 Z
+date: 2019-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gds-api-adapters
@@ -410,6 +410,7 @@ files:
 - app/assets/stylesheets/govuk_publishing_components/components/_step-by-step-nav.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_subscription-links.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_success-alert.scss
+- app/assets/stylesheets/govuk_publishing_components/components/_summary-list.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_table.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_tabs.scss
 - app/assets/stylesheets/govuk_publishing_components/components/_taxonomy-list.scss
@@ -534,6 +535,7 @@ files:
 - app/views/govuk_publishing_components/components/_step_by_step_nav_related.html.erb
 - app/views/govuk_publishing_components/components/_subscription-links.html.erb
 - app/views/govuk_publishing_components/components/_success_alert.html.erb
+- app/views/govuk_publishing_components/components/_summary_list.html.erb
 - app/views/govuk_publishing_components/components/_table.html.erb
 - app/views/govuk_publishing_components/components/_tabs.html.erb
 - app/views/govuk_publishing_components/components/_taxonomy_list.html.erb
@@ -604,6 +606,7 @@ files:
 - app/views/govuk_publishing_components/components/docs/step_by_step_nav_related.yml
 - app/views/govuk_publishing_components/components/docs/subscription-links.yml
 - app/views/govuk_publishing_components/components/docs/success_alert.yml
+- app/views/govuk_publishing_components/components/docs/summary_list.yml
 - app/views/govuk_publishing_components/components/docs/table.yml
 - app/views/govuk_publishing_components/components/docs/tabs.yml
 - app/views/govuk_publishing_components/components/docs/taxonomy_list.yml