govuk_design_system_formbuilder 2.7.6 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16dd3a6e9641b3d0aa7e91ee6318bcd0f993d10c00105e1c977f54120eb966d9
-  data.tar.gz: 5aa914a964cac5770d3e1c002aa9e38a20b4bf21c612a9c78c5edfa503c8e98f
+  metadata.gz: 84999693662af580363425f17c82d516d675c30d000ccd7e46a3d4607b63b32e
+  data.tar.gz: fe9b2a8f8cd05ec1eb56d915223a387ba4d86390dbee1e771f9c32263afd054a
 SHA512:
-  metadata.gz: 870971ada7f130cd54a13cff52f852d07e1581dd8ebf04f802ae93ca2103325fa2e283e9812170c282da4c5b1a056490799828f0f8d374a7b8d92a053bc6114e
-  data.tar.gz: 7e931f7fe3966909bdd2c4ff16ee3fe7d06e0c52925c03d36fb300a99d7105a842ee6f5aeac165b3824495efd7b3d189ac925378c4a10b7e57c37f8d4230eeb2
+  metadata.gz: f48bdf7f824047df1dccc6b53412cb454f3f30af9805ba5b6fafa91d89454e03ef929d534919b0695ca0db0804d84de18a01779074382d96e7c457c2e4a727cf
+  data.tar.gz: c5d24743fa044cf0b71b3b3609239c0787ed0551a6993f74f238385217782f4167439470070c4dd0f4d24b1bdcb1446cb6c996d3aef51f001c016dde55945800

data/lib/govuk_design_system_formbuilder/builder.rb

@@ -912,6 +912,7 @@ module GOVUKDesignSystemFormBuilder
     # @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
     # @param omit_day [Boolean] do not render a day input, only capture month and year
+    # @param maxlength_enabled [Boolean] adds maxlength attribute to day, month and year inputs (2, 2, and 4, respectively)
     # @param wildcards [Boolean] add an 'X' to the day and month patterns so users can add approximate dates
     # @param form_group [Hash] configures the form group
     # @option form_group classes [Array,String] sets the form group's classes
@@ -936,8 +937,8 @@ module GOVUKDesignSystemFormBuilder
     # @example A date input with legend supplied as a proc
     #  = f.govuk_date_field :finishes_on,
     #    legend: -> { tag.h3('Which category do you belong to?') }
-    def govuk_date_field(attribute_name, hint: {}, legend: {}, caption: {}, date_of_birth: false, omit_day: false, form_group: {}, wildcards: false, **kwargs, &block)
-      Elements::Date.new(self, object_name, attribute_name, hint: hint, legend: legend, caption: caption, date_of_birth: date_of_birth, omit_day: omit_day, form_group: form_group, wildcards: wildcards, **kwargs, &block).html
+    def govuk_date_field(attribute_name, hint: {}, legend: {}, caption: {}, date_of_birth: false, omit_day: false, maxlength_enabled: false, form_group: {}, wildcards: false, **kwargs, &block)
+      Elements::Date.new(self, object_name, attribute_name, hint: hint, legend: legend, caption: caption, date_of_birth: date_of_birth, omit_day: omit_day, maxlength_enabled: maxlength_enabled, form_group: form_group, wildcards: wildcards, **kwargs, &block).html
     end
 
     # Generates a summary of errors in the form, each linking to the corresponding

data/lib/govuk_design_system_formbuilder/elements/date.rb

@@ -6,21 +6,23 @@ module GOVUKDesignSystemFormBuilder
       include Traits::Error
       include Traits::Hint
       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:, form_group:, wildcards:, date_of_birth: false, **kwargs, &block)
+      def initialize(builder, object_name, attribute_name, legend:, caption:, hint:, omit_day:, maxlength_enabled:, form_group:, wildcards:, date_of_birth: false, **kwargs, &block)
         super(builder, object_name, attribute_name, &block)
 
-        @legend          = legend
-        @caption         = caption
-        @hint            = hint
-        @date_of_birth   = date_of_birth
-        @omit_day        = omit_day
-        @form_group      = form_group
-        @wildcards       = wildcards
-        @html_attributes = kwargs
+        @legend            = legend
+        @caption           = caption
+        @hint              = hint
+        @date_of_birth     = date_of_birth
+        @omit_day          = omit_day
+        @maxlength_enabled = maxlength_enabled
+        @form_group        = form_group
+        @wildcards         = wildcards
+        @html_attributes   = kwargs
       end
 
       def html
@@ -47,6 +49,10 @@ module GOVUKDesignSystemFormBuilder
         @omit_day
       end
 
+      def maxlength_enabled?
+        @maxlength_enabled
+      end
+
       def day
         return if omit_day?
 
@@ -104,7 +110,8 @@ module GOVUKDesignSystemFormBuilder
           pattern: pattern(segment),
           inputmode: 'numeric',
           value: value,
-          autocomplete: date_of_birth_autocomplete_value(segment)
+          autocomplete: date_of_birth_autocomplete_value(segment),
+          maxlength: (width if maxlength_enabled?),
         )
       end
 
@@ -115,10 +122,12 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def classes(width)
-        %w(input date-input__input).prefix(brand).tap do |classes|
-          classes.push(%(#{brand}-input--width-#{width}))
-          classes.push(%(#{brand}-input--error)) if has_errors?
-        end
+        build_classes(
+          %(input),
+          %(date-input__input),
+          %(input--width-#{width}),
+          %(input--error) => has_errors?,
+        ).prefix(brand)
       end
 
       # if the field has errors we want the govuk_error_summary to
@@ -148,7 +157,7 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def label_classes
-        %w(label date-input__label).prefix(brand)
+        build_classes(%(label), %(date-input__label)).prefix(brand)
       end
     end
   end

data/lib/govuk_design_system_formbuilder/elements/error_message.rb

@@ -20,7 +20,7 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def message
-        @builder.object.errors.messages[@attribute_name]&.first
+        set_message_safety(@builder.object.errors.messages[@attribute_name]&.first)
       end
     end
   end

data/lib/govuk_design_system_formbuilder/elements/error_summary.rb

@@ -81,7 +81,9 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def list_item(attribute, message, url = nil)
-        tag.li(link_to(message, url || same_page_link(field_id(attribute)), **link_options))
+        target = url || same_page_link(field_id(attribute))
+
+        tag.li(link_to(set_message_safety(message), target, **link_options))
       end
 
       def same_page_link(target)

data/lib/govuk_design_system_formbuilder/elements/file.rb

@@ -8,6 +8,7 @@ module GOVUKDesignSystemFormBuilder
       include Traits::Label
       include Traits::Supplemental
       include Traits::HTMLAttributes
+      include Traits::HTMLClasses
 
       def initialize(builder, object_name, attribute_name, hint:, label:, caption:, form_group:, **kwargs, &block)
         super(builder, object_name, attribute_name, &block)
@@ -40,9 +41,7 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def classes
-        %w(file-upload).prefix(brand).tap do |c|
-          c.push(%(#{brand}-file-upload--error)) if has_errors?
-        end
+        build_classes(%(file-upload), %(file-upload--error) => has_errors?).prefix(brand)
       end
     end
   end

data/lib/govuk_design_system_formbuilder/elements/text_area.rb

@@ -8,6 +8,7 @@ module GOVUKDesignSystemFormBuilder
       include Traits::Label
       include Traits::Supplemental
       include Traits::HTMLAttributes
+      include Traits::HTMLClasses
 
       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)
@@ -42,10 +43,7 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def classes
-        %w(textarea).prefix(brand).tap do |classes|
-          classes.push(%(#{brand}-textarea--error))    if has_errors?
-          classes.push(%(#{brand}-js-character-count)) if limit?
-        end
+        build_classes(%(textarea), %(textarea--error) => has_errors?, %(js-character-count) => limit?).prefix(brand)
       end
 
       def options
@@ -86,7 +84,7 @@ module GOVUKDesignSystemFormBuilder
       end
 
       def limit_description_classes
-        %w(hint character-count__message).prefix(brand)
+        build_classes(%(hint), %(character-count__message)).prefix(brand)
       end
 
       def limit_description_id

data/lib/govuk_design_system_formbuilder/traits/error.rb

@@ -12,6 +12,10 @@ module GOVUKDesignSystemFormBuilder
       def error_element
         @error_element ||= Elements::ErrorMessage.new(*bound)
       end
+
+      def set_message_safety(message)
+        config.trust_error_messages ? message.html_safe : message
+      end
     end
   end
 end

data/lib/govuk_design_system_formbuilder/traits/html_classes.rb

@@ -0,0 +1,36 @@
+module GOVUKDesignSystemFormBuilder
+  module Traits
+    module HTMLClasses
+      # combine all the classes in *args with any keys from **kwargs
+      # where the value is true. Roughly based on the behaviour from
+      # Rails' class_names, but recreated here as that returns a string
+      # where we want an array.
+      def build_classes(*args, **kwargs)
+        # FIXME: we need to handle the arguments differently for Ruby 2.6.x because
+        #        Ruby 2.7.0 brought the separation of positional and keyword
+        #        arguments.
+        #
+        #        This can be removed once support for 2.6.x is dropped.
+        #
+        #        https://www.ruby-lang.org/en/news/2019/12/12/separation-of-positional-and-keyword-arguments-in-ruby-3-0/
+        return ruby_2_6_build_classes_fallback(*args) if RUBY_VERSION < "2.7.0"
+
+        (args + kwargs.map { |k, v| k if v }).compact
+      end
+
+    private
+
+      def ruby_2_6_build_classes_fallback(*args)
+        [].tap do |classes|
+          args.each do |arg|
+            if arg.is_a?(Hash)
+              arg.each { |k, v| classes.append(k) if v }
+            else
+              classes.append(arg)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/govuk_design_system_formbuilder/version.rb

@@ -1,3 +1,3 @@
 module GOVUKDesignSystemFormBuilder
-  VERSION = '2.7.6'.freeze
+  VERSION = '2.8.0'.freeze
 end

data/lib/govuk_design_system_formbuilder.rb

@@ -71,6 +71,10 @@ module GOVUKDesignSystemFormBuilder
   #
   # * +:enable_logger+ controls whether or not the library will emit log
   #   messages via Rails.logger.warn, defaults to +true+
+  #
+  # * +:trust_error_messages+ call html_safe on error messages before they're
+  #   rendered. This allows formatting markup to be used to change the display
+  #   of the error message. Defaults to +false+
   # ===
   DEFAULTS = {
     brand: 'govuk',
@@ -95,7 +99,8 @@ module GOVUKDesignSystemFormBuilder
     localisation_schema_legend: nil,
     localisation_schema_caption: nil,
 
-    enable_logger: true
+    enable_logger: true,
+    trust_error_messages: false,
   }.freeze
 
   DEFAULTS.each_key { |k| config_accessor(k) { DEFAULTS[k] } }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govuk_design_system_formbuilder
 version: !ruby/object:Gem::Version
-  version: 2.7.6
+  version: 2.8.0
 platform: ruby
 authors:
 - Peter Yates
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-17 00:00:00.000000000 Z
+date: 2021-12-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: deep_merge
@@ -340,6 +340,7 @@ files:
 - lib/govuk_design_system_formbuilder/traits/fieldset_item.rb
 - lib/govuk_design_system_formbuilder/traits/hint.rb
 - lib/govuk_design_system_formbuilder/traits/html_attributes.rb
+- lib/govuk_design_system_formbuilder/traits/html_classes.rb
 - lib/govuk_design_system_formbuilder/traits/input.rb
 - lib/govuk_design_system_formbuilder/traits/label.rb
 - lib/govuk_design_system_formbuilder/traits/localisation.rb