govuk_design_system_formbuilder 5.2.0 → 5.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee29cb5609e4c2624e66de9a8f4458f4998eb999078635e4b8be3028fe4d07ed
-  data.tar.gz: 8a4d5a2e0190649716e5b2f20612f410a227b551ff1fc1654fd0ff2086cef429
+  metadata.gz: 51a139b376822ea5bfdbeef995d5b8daef3d0a67fa6d035165253dbfafe2496f
+  data.tar.gz: 8a2a50e44d2ecf48edba85535cf876f95fc6a22f89188a219edba6c97570f5eb
 SHA512:
-  metadata.gz: 6c382d9cc75632a6fc44353a94d0fb91662c3fd4da19dc28b25af151f7bbcfd120d22c7d2eda10f85f7cfa1010b800bfb7ab3d1d8f4b4644381b1f4dcdae2afb
-  data.tar.gz: dca5669205b2086610ef538c4e0d1f37f068787489aa1363599e4d2482c781763725315f5701dbf834759b4bacc361d32bca892b930d11616a85ebc2253dc18e
+  metadata.gz: 6c1052d946ea83b6d301c1acf02e6c9b6f8da14fd70409ef91bd0908d47fc57e25e130e214e12b0fa22fb7fe63adf85b809a76d8f78708f4e1da12990bfa0fd2
+  data.tar.gz: b543d521fe7fd10597942fc70c8a45513d876e28a624e3064f51d6e7a303031cec3e5e01e66e399717eacae5a1a714fcc0fb4c3c4981ffb62ac3edd18a33a2a9

data/README.md

@@ -6,7 +6,7 @@
 [![Gem](https://img.shields.io/gem/dt/govuk_design_system_formbuilder?logo=rubygems)](https://rubygems.org/gems/govuk_design_system_formbuilder)
 [![Test Coverage](https://api.codeclimate.com/v1/badges/110136fb22341d3ba646/test_coverage)](https://codeclimate.com/github/x-govuk/govuk-form-builder/test_coverage)
 [![GitHub license](https://img.shields.io/github/license/x-govuk/govuk-form-builder)](https://github.com/x-govuk/govuk-form-builder/blob/main/LICENSE)
-[![GOV.UK Design System version](https://img.shields.io/badge/GOV.UK%20Design%20System-5.1.0-brightgreen)](https://design-system.service.gov.uk)
+[![GOV.UK Design System version](https://img.shields.io/badge/GOV.UK%20Design%20System-5.3.0-brightgreen)](https://design-system.service.gov.uk)
 [![Rails](https://img.shields.io/badge/Rails-6.1.7%20%E2%95%B1%207.1.3-E16D6D)](https://weblog.rubyonrails.org/releases/)
 [![Ruby](https://img.shields.io/badge/Ruby-3.1.4%20%20%E2%95%B1%203.2.3%20%20%E2%95%B1%203.3.0-E16D6D)](https://www.ruby-lang.org/en/downloads/)
 

data/lib/govuk_design_system_formbuilder/builder.rb

@@ -162,57 +162,6 @@ module GOVUKDesignSystemFormBuilder
       Elements::Inputs::Email.new(self, object_name, attribute_name, hint:, label:, caption:, width:, extra_letter_spacing:, form_group:, prefix_text:, suffix_text:, **kwargs, &block).html
     end
 
-    # Generates a input of type +password+
-    #
-    # @param attribute_name [Symbol] The name of the attribute
-    # @param hint [Hash,Proc] The content of the hint. No hint will be added if 'text' is left +nil+. When a +Proc+ is
-    #   supplied the hint will be wrapped in a +div+ instead of a +span+
-    # @option hint text [String] the hint text
-    # @option hint kwargs [Hash] additional arguments are applied as attributes to the hint
-    # @param width [Integer,String] sets the width of the input, can be +2+, +3+ +4+, +5+, +10+ or +20+ characters
-    #   or +one-quarter+, +one-third+, +one-half+, +two-thirds+ or +full+ width of the container
-    # @param extra_letter_spacing [Boolean] when true adds space between characters to increase the readability of
-    #   sequences of letters and numbers. Defaults to +false+.
-    # @param label [Hash,Proc] configures or sets the associated label content
-    # @option label text [String] the label text
-    # @option label size [String] the size of the label font, can be +xl+, +l+, +m+, +s+ or nil
-    # @option label tag [Symbol,String] the label's wrapper tag, intended to allow labels to act as page headings
-    # @option label hidden [Boolean] control the visability of the label. Hidden labels will stil be read by screenreaders
-    # @option label kwargs [Hash] additional arguments are applied as attributes on the +label+ element
-    # @param caption [Hash] configures or sets the caption content which is inserted above the label
-    # @option caption text [String] the caption text
-    # @option caption size [String] the size of the caption, can be +xl+, +l+ or +m+. Defaults to +m+
-    # @option caption kwargs [Hash] additional arguments are applied as attributes on the caption +span+ element
-    # @option kwargs [Hash] kwargs additional arguments are applied as attributes to the +input+ element
-    # @param form_group [Hash] configures the form group
-    # @option form_group kwargs [Hash] additional attributes added to the form group
-    # @param prefix_text [String] the text placed before the input. No prefix will be added if left +nil+
-    # @param suffix_text [String] the text placed after the input. No suffix will be added if left +nil+
-    # @param block [Block] arbitrary HTML that will be rendered between the hint and the input
-    # @return [ActiveSupport::SafeBuffer] HTML output
-    # @see https://design-system.service.gov.uk/components/text-input/ GOV.UK Text input
-    # @see https://design-system.service.gov.uk/patterns/passwords/ GOV.UK Password patterns
-    # @see https://design-system.service.gov.uk/styles/typography/#headings-with-captions Headings with captions
-    #
-    # @example A password field
-    #   = f.govuk_password_field :password,
-    #     label: { text: 'Enter your password' }
-    #
-    # @example A password field with injected content
-    #   = f.govuk_password_field :password,
-    #     label: { text: 'Password' } do
-    #
-    #     p.govuk-inset-text
-    #       | Ensure your password is at least 16 characters long
-    #
-    # @example A password field with the label supplied as a proc
-    #   = f.govuk_password_field :passcode,
-    #     label: -> { tag.h3('What is your secret pass code?') }
-    #
-    def govuk_password_field(attribute_name, hint: {}, label: {}, width: nil, extra_letter_spacing: false, form_group: {}, caption: {}, prefix_text: nil, suffix_text: nil, **kwargs, &block)
-      Elements::Inputs::Password.new(self, object_name, attribute_name, hint:, label:, caption:, width:, extra_letter_spacing:, form_group:, prefix_text:, suffix_text:, **kwargs, &block).html
-    end
-
     # Generates a input of type +url+
     #
     # @param attribute_name [Symbol] The name of the attribute
@@ -320,6 +269,70 @@ module GOVUKDesignSystemFormBuilder
       Elements::Inputs::Number.new(self, object_name, attribute_name, hint:, label:, caption:, width:, extra_letter_spacing:, form_group:, prefix_text:, suffix_text:, **kwargs, &block).html
     end
 
+    # Generates a password input
+    #
+    # @param attribute_name [Symbol] The name of the attribute
+    # @param hint [Hash,Proc] The content of the hint. No hint will be added if 'text' is left +nil+. When a +Proc+ is
+    #   supplied the hint will be wrapped in a +div+ instead of a +span+
+    # @option hint text [String] the hint text
+    # @option hint kwargs [Hash] additional arguments are applied as attributes to the hint
+    # @param label [Hash,Proc] configures or sets the associated label content
+    # @option label text [String] the label text
+    # @option label size [String] the size of the label font, can be +xl+, +l+, +m+, +s+ or nil
+    # @option label tag [Symbol,String] the label's wrapper tag, intended to allow labels to act as page headings
+    # @option label hidden [Boolean] control the visability of the label. Hidden labels will stil be read by screenreaders
+    # @option label kwargs [Hash] additional arguments are applied as attributes on the +label+ element
+    # @param caption [Hash] configures or sets the caption content which is inserted above the label
+    # @option caption text [String] the caption text
+    # @option caption size [String] the size of the caption, can be +xl+, +l+ or +m+. Defaults to +m+
+    # @option caption kwargs [Hash] additional arguments are applied as attributes on the caption +span+ element
+    # @option kwargs [Hash] kwargs additional arguments are applied as attributes to the +input+ element
+    # @param form_group [Hash] configures the form group
+    # @option form_group kwargs [Hash] additional attributes added to the form group
+    # @param show_password_text [String] button text when the password is hidden. Defaults to "Show"
+    # @param hide_password_text [String] button text when the password is shown. Defaults to "Hide"
+    # @param show_password_aria_label_text [String] button text exposed to assistive technologies, like screen readers, when the password is hidden. Defaults to "Show password"
+    # @param hide_password_aria_label_text [String] button text exposed to assistive technologies, like screen readers, when the password is visible. Defaults to "Hide password"
+    # @param password_shown_announcement_text [String] Announcement made to screen reader users when their password has become visible in plain text. Defaults to "Your password is visible"
+    # @param password_hidden_announcement_text [String] Announcement made to screen reader users when their password has been obscured and is not visible. Defaults to "Your password is hidden"
+    #
+    # @example A password field
+    #   = f.govuk_password_field :password
+    #
+    def govuk_password_field(
+      attribute_name,
+      hint: {},
+      label: {},
+      caption: {},
+      form_group: {},
+      show_password_text: config.default_show_password_text,
+      hide_password_text: config.default_hide_password_text,
+      show_password_aria_label_text: config.default_show_password_aria_label_text,
+      hide_password_aria_label_text: config.default_hide_password_aria_label_text,
+      password_shown_announcement_text: config.default_password_shown_announcement_text,
+      password_hidden_announcement_text: config.default_password_hidden_announcement_text,
+      **kwargs,
+      &block
+    )
+      Elements::Password.new(
+        self,
+        object_name,
+        attribute_name,
+        hint:,
+        label:,
+        caption:,
+        form_group:,
+        show_password_text:,
+        hide_password_text:,
+        show_password_aria_label_text:,
+        hide_password_aria_label_text:,
+        password_shown_announcement_text:,
+        password_hidden_announcement_text:,
+        **kwargs,
+        &block
+      ).html
+    end
+
     # Generates a +textarea+ element with a label, optional hint. Also offers
     # the ability to add the GOV.UK character and word counting components
     # automatically
@@ -655,7 +668,7 @@ module GOVUKDesignSystemFormBuilder
     # @example A custom divider
     #   = govuk_radio_divider 'Alternatively'
     def govuk_radio_divider(text = config.default_radio_divider_text)
-      tag.div(text, class: %w(govuk-radios__divider))
+      tag.div(text, class: %(#{config.brand}-radios__divider))
     end
 
     # Generate a list of check boxes from a collection

data/lib/govuk_design_system_formbuilder/elements/date.rb

@@ -8,7 +8,6 @@ module GOVUKDesignSystemFormBuilder
       include Traits::Supplemental
       include Traits::HTMLClasses
 
-      SEGMENTS = { day: '3i', month: '2i', year: '1i' }.freeze
       MULTIPARAMETER_KEY = { day: 3, month: 2, year: 1 }.freeze
 
       def initialize(builder, object_name, attribute_name, legend:, caption:, hint:, omit_day:, maxlength_enabled:, form_group:, date_of_birth: false, **kwargs, &block)
@@ -34,6 +33,10 @@ module GOVUKDesignSystemFormBuilder
 
     private
 
+      def segments
+        config.default_date_segments
+      end
+
       def fieldset_options
         { legend: @legend, caption: @caption, described_by: [error_id, hint_id, supplemental_id] }
       end
@@ -136,7 +139,7 @@ module GOVUKDesignSystemFormBuilder
         if has_errors? && link_errors
           field_id(link_errors:)
         else
-          [@object_name, @attribute_name, SEGMENTS.fetch(segment)].join("_")
+          [@object_name, @attribute_name, segments.fetch(segment)].join("_")
         end
       end
 
@@ -145,7 +148,7 @@ module GOVUKDesignSystemFormBuilder
           "%<object_name>s[%<input_name>s(%<segment>s)]",
           object_name: @object_name,
           input_name: @attribute_name,
-          segment: SEGMENTS.fetch(segment)
+          segment: segments.fetch(segment)
         )
       end
 

data/lib/govuk_design_system_formbuilder/elements/password.rb

@@ -0,0 +1,106 @@
+module GOVUKDesignSystemFormBuilder
+  module Elements
+    class Password < Base
+      using PrefixableArray
+
+      include Traits::Error
+      include Traits::Hint
+      include Traits::Label
+      include Traits::HTMLAttributes
+      include Traits::HTMLClasses
+
+      I18nAttr = Struct.new(:key, :text, :default)
+
+      def initialize(builder, object_name, attribute_name, label:, caption:, hint:, form_group:, show_password_text:, hide_password_text:, show_password_aria_label_text:, hide_password_aria_label_text:, password_hidden_announcement_text:, password_shown_announcement_text:, **kwargs, &block)
+        super(builder, object_name, attribute_name, &block)
+
+        @label           = label
+        @caption         = caption
+        @hint            = hint
+        @form_group      = form_group
+        @html_attributes = kwargs
+
+        @show_password_text = show_password_text
+        @hide_password_text = hide_password_text
+
+        @show_password_aria_label_text = show_password_aria_label_text
+        @hide_password_aria_label_text = hide_password_aria_label_text
+
+        @password_shown_announcement_text = password_shown_announcement_text
+        @password_hidden_announcement_text = password_hidden_announcement_text
+      end
+
+      def html
+        Containers::FormGroup.new(*bound, **form_group_options).html do
+          safe_join([label_element, hint_element, error_element, password_input_and_button])
+        end
+      end
+
+    private
+
+      def password_input_and_button
+        tag.div(class: wrapper_classes) do
+          safe_join([password_input, button])
+        end
+      end
+
+      def options
+        {
+          id: field_id(link_errors: true),
+          class: classes,
+          spellcheck: "false",
+          autocomplete: "current-password",
+          autocapitalize: "none",
+          aria: { describedby: combine_references(hint_id, error_id) }
+        }
+      end
+
+      def form_group_options
+        {
+          **@form_group,
+          **i18n_data,
+          class: %(#{brand}-password-input),
+          data: { module: %(#{brand}-password-input) },
+        }
+      end
+
+      def password_input
+        @builder.password_field(@attribute_name, attributes(@html_attributes))
+      end
+
+      def classes
+        build_classes('input', 'password-input__input', 'js-password-input-input', %(password-input--error) => has_errors?).prefix(brand)
+      end
+
+      def wrapper_classes
+        %w(input__wrapper password-input__wrapper).prefix(brand)
+      end
+
+      def button
+        tag.button(@show_password_text, **button_options)
+      end
+
+      def button_options
+        {
+          data: { module: %(#{brand}-button) },
+          aria: { label: "Show password", controls: field_id(link_errors: true) },
+          type: 'button',
+          class: %w(button button--secondary password-input__toggle js-password-input-toggle).prefix(brand)
+        }
+      end
+
+      def i18n_data
+        [
+          I18nAttr.new("data-i18n.show-password",                @show_password_text,                config.default_show_password_text),
+          I18nAttr.new("data-i18n.hide-password",                @hide_password_text,                config.default_hide_password_text),
+          I18nAttr.new("data-i18n.show-password-aria-label",     @show_password_aria_label_text,     config.default_show_password_aria_label_text),
+          I18nAttr.new("data-i18n.hide-password-aria-label",     @hide_password_aria_label_text,     config.default_hide_password_aria_label_text),
+          I18nAttr.new("data-i18n.password-shown-announcement",  @password_shown_announcement_text,  config.default_password_shown_announcement_text),
+          I18nAttr.new("data-i18n.password-hidden-announcement", @password_hidden_announcement_text, config.default_password_hidden_announcement_text),
+        ].each_with_object({}) do |attr, h|
+          h[attr.key] = attr.text unless attr.text == attr.default
+        end
+      end
+    end
+  end
+end

data/lib/govuk_design_system_formbuilder/elements/text_area.rb

@@ -13,6 +13,8 @@ module GOVUKDesignSystemFormBuilder
       def initialize(builder, object_name, attribute_name, hint:, label:, caption:, rows:, max_words:, max_chars:, threshold:, form_group:, **kwargs, &block)
         super(builder, object_name, attribute_name, &block)
 
+        fail ArgumentError, 'limit can be words or chars' if max_words && max_chars
+
         @label           = label
         @caption         = caption
         @hint            = hint
@@ -25,19 +27,13 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def html
-        Containers::CharacterCount.new(@builder, **character_count_options).html do
-          Containers::FormGroup.new(*bound, **@form_group).html do
-            safe_join([label_element, supplemental_content, hint_element, error_element, text_area, limit_description])
-          end
+        Containers::FormGroup.new(*bound, **@form_group.merge(limit_form_group_options)).html do
+          safe_join([label_element, supplemental_content, hint_element, error_element, text_area, limit_description])
         end
       end
 
     private
 
-      def character_count_options
-        { max_words: @max_words, max_chars: @max_chars, threshold: @threshold }
-      end
-
       def text_area
         @builder.text_area(@attribute_name, **attributes(@html_attributes))
       end
@@ -92,6 +88,27 @@ module GOVUKDesignSystemFormBuilder
 
         limit_id
       end
+
+      def limit_form_group_options
+        return {} unless limit?
+
+        {
+          class: %(#{brand}-character-count),
+          data: { module: %(#{brand}-character-count) }.merge(**limit_max_options, **limit_threshold_options).compact
+        }
+      end
+
+      def limit_max_options
+        if @max_words
+          { maxwords: @max_words }
+        elsif @max_chars
+          { maxlength: @max_chars }
+        end
+      end
+
+      def limit_threshold_options
+        { threshold: @threshold }
+      end
     end
   end
 end

data/lib/govuk_design_system_formbuilder/version.rb

@@ -1,3 +1,3 @@
 module GOVUKDesignSystemFormBuilder
-  VERSION = '5.2.0'.freeze
+  VERSION = '5.3.1'.freeze
 end

data/lib/govuk_design_system_formbuilder.rb

@@ -27,16 +27,17 @@ module GOVUKDesignSystemFormBuilder
   # * +:default_submit_button_text+ sets the value assigned to +govuk_submit+,
   #   defaults to 'Continue'.
   #
+  # * +:default_date_segments+ allows the date segments used by Rails'
+  #   multiparameter attributes to be configured. This is useful if you want to
+  #   override the standard behaviour where Rails tries to cast the values
+  #   into a +Date+. Defaults to +{ day: '3i', month: '2i', year: '1i' }+
+  #
   # * +:default_radio_divider_text+ sets the text automatically added to the
   #   radio button divider, defaults to 'or'
   #
   # * +:default_check_box_divider_text+ sets the text automatically added to the
   #   checkbox divider, defaults to 'or'
   #
-  # * +:default_submit_button_text+ sets the text used to divide the last radio
-  #   button in radio button fieldsets. As per the GOV.UK Design System spec,
-  #   it defaults to 'or'.
-  #
   # * +:default_collection_check_boxes_include_hidden+ controls whether or not
   #   a hidden field is added when rendering a collection of check boxes
   #
@@ -92,6 +93,7 @@ module GOVUKDesignSystemFormBuilder
     default_legend_tag: nil,
     default_caption_size: 'm',
     default_submit_button_text: 'Continue',
+    default_date_segments: { day: '3i', month: '2i', year: '1i' },
     default_radio_divider_text: 'or',
     default_check_box_divider_text: 'or',
     default_error_summary_title: 'There is a problem',
@@ -102,7 +104,12 @@ module GOVUKDesignSystemFormBuilder
     default_collection_radio_buttons_include_hidden: true,
     default_collection_radio_buttons_auto_bold_labels: true,
     default_submit_validate: false,
-
+    default_show_password_text: "Show",
+    default_hide_password_text: "Hide",
+    default_show_password_aria_label_text: "Show password",
+    default_hide_password_aria_label_text: "Hide password",
+    default_password_shown_announcement_text: "Your password is visible",
+    default_password_hidden_announcement_text: "Your password is hidden",
     localisation_schema_fallback: %i(helpers __context__),
     localisation_schema_label: nil,
     localisation_schema_hint: nil,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk_design_system_formbuilder
 version: !ruby/object:Gem::Version
-  version: 5.2.0
+  version: 5.3.1
 platform: ruby
 authors:
 - Peter Yates
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-22 00:00:00.000000000 Z
+date: 2024-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: html-attributes-utils
@@ -134,14 +134,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.14.0
+        version: 4.16.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.14.0
+        version: 4.16.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -310,7 +310,6 @@ files:
 - lib/govuk_design_system_formbuilder/builder.rb
 - lib/govuk_design_system_formbuilder/builder_helper.rb
 - lib/govuk_design_system_formbuilder/containers/button_group.rb
-- lib/govuk_design_system_formbuilder/containers/character_count.rb
 - lib/govuk_design_system_formbuilder/containers/check_boxes.rb
 - lib/govuk_design_system_formbuilder/containers/check_boxes_fieldset.rb
 - lib/govuk_design_system_formbuilder/containers/fieldset.rb
@@ -331,13 +330,13 @@ files:
 - lib/govuk_design_system_formbuilder/elements/hint.rb
 - lib/govuk_design_system_formbuilder/elements/inputs/email.rb
 - lib/govuk_design_system_formbuilder/elements/inputs/number.rb
-- lib/govuk_design_system_formbuilder/elements/inputs/password.rb
 - lib/govuk_design_system_formbuilder/elements/inputs/phone.rb
 - lib/govuk_design_system_formbuilder/elements/inputs/text.rb
 - lib/govuk_design_system_formbuilder/elements/inputs/url.rb
 - lib/govuk_design_system_formbuilder/elements/label.rb
 - lib/govuk_design_system_formbuilder/elements/legend.rb
 - lib/govuk_design_system_formbuilder/elements/null.rb
+- lib/govuk_design_system_formbuilder/elements/password.rb
 - lib/govuk_design_system_formbuilder/elements/radios/collection.rb
 - lib/govuk_design_system_formbuilder/elements/radios/collection_radio_button.rb
 - lib/govuk_design_system_formbuilder/elements/radios/fieldset_radio_button.rb

data/lib/govuk_design_system_formbuilder/containers/character_count.rb

@@ -1,46 +0,0 @@
-module GOVUKDesignSystemFormBuilder
-  module Containers
-    class CharacterCount < Base
-      def initialize(builder, max_words:, max_chars:, threshold:)
-        super(builder, nil, nil)
-
-        fail ArgumentError, 'limit can be words or chars' if max_words && max_chars
-
-        @max_words = max_words
-        @max_chars = max_chars
-        @threshold = threshold
-      end
-
-      def html(&block)
-        return yield unless limit?
-
-        tag.div(**options, &block)
-      end
-
-    private
-
-      def options
-        {
-          class: %(#{brand}-character-count),
-          data: { module: %(#{brand}-character-count) }.merge(**limit, **threshold).compact
-        }
-      end
-
-      def limit
-        if @max_words
-          { maxwords: @max_words }
-        elsif @max_chars
-          { maxlength: @max_chars }
-        end
-      end
-
-      def threshold
-        { threshold: @threshold }
-      end
-
-      def limit?
-        @max_words || @max_chars
-      end
-    end
-  end
-end

data/lib/govuk_design_system_formbuilder/elements/inputs/password.rb

@@ -1,20 +0,0 @@
-module GOVUKDesignSystemFormBuilder
-  module Elements
-    module Inputs
-      class Password < Base
-        include Traits::Input
-        include Traits::Error
-        include Traits::Hint
-        include Traits::Label
-        include Traits::Supplemental
-        include Traits::HTMLAttributes
-
-      private
-
-        def builder_method
-          :password_field
-        end
-      end
-    end
-  end
-end