ccs-frontend_helpers 0.1.0.rc.7 → 0.1.0

data/lib/ccs/components/govuk/tabs/tab.rb

@@ -1,56 +0,0 @@
-require_relative '../../base'
-
-module CCS
-  module Components
-    module GovUK
-      class Tabs < Base
-        # = GOV.UK Tabs tab
-        #
-        # The individual tab
-        #
-        # @!attribute [r] index
-        #   @return [Integer] The index of the tab
-        # @!attribute [r] label
-        #   @return [String] Text for the tab
-        # @!attribute [r] href
-        #   @return [String] The href for the tab panel
-
-        class Tab < Base
-          private
-
-          attr_reader :index, :label, :href
-
-          public
-
-          # @param index [Integer] the index of the tab
-          # @param id_prefix [Integer] prefix used for the id of a panel if no id is specified
-          # @param label [String] the text for the tab
-          # @param panel [Hash] used to find the id of the panel. See {Components::GovUK::Tabs::Panel#initialize Panel#initialize} for more details
-          # @param options [Hash] options that will be used in customising the HTML
-          #
-          # @option options [Hash] :attributes any additional attributes that will added as part of the HTML
-
-          def initialize(index:, id_prefix:, label:, panel:, **options)
-            super(**options)
-
-            @options[:attributes][:class] = 'govuk-tabs__tab'
-
-            @index = index
-            @label = label
-            @href = "##{panel.dig(:attributes, :id) || "#{id_prefix}-#{index}"}"
-          end
-
-          # Generates the HTML for the GOV.UK Tabs tab
-          #
-          # @return [ActiveSupport::SafeBuffer]
-
-          def render
-            tag.li(class: "govuk-tabs__list-item #{'govuk-tabs__list-item--selected' if index == 1}".rstrip) do
-              link_to(label, href, **options[:attributes])
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ccs/components/govuk/tabs.rb

@@ -1,66 +0,0 @@
-require_relative '../base'
-require_relative 'tabs/tab'
-require_relative 'tabs/panel'
-
-module CCS
-  module Components
-    module GovUK
-      # = GOV.UK Tabs
-      #
-      # This is used to generate the tabs component from the
-      # {https://design-system.service.gov.uk/components/tabs GDS - Components - Tabs}
-      #
-      # @!attribute [r] title
-      #   @return [String] Title for the tabs table of contents
-      # @!attribute [r] tabs
-      #   @return [Array<Tabs::Tab>] an array of initialised tabs
-      # @!attribute [r] panels
-      #   @return [Array<Tabs::Panel>] an array of initialised panel
-
-      class Tabs < Base
-        private
-
-        attr_reader :title, :tabs, :panels
-
-        public
-
-        # @param items [Array<Hash>] array of the tab items.
-        #                            See {Components::GovUK::Tabs::Tab#initialize Tab#initialize}
-        #                            and {Components::GovUK::Tabs::Panel#initialize Panel#initialize} for details of the items in the array.
-        # @param title [NilClass,String] title for the tabs table of contents
-        # @param id_prefix [String] prefix id for each tab item if no id is specified on each item
-        # @param options [Hash] options that will be used in customising the HTML
-        #
-        # @option options [String] :classes additional CSS classes for the tabs HTML
-        # @option options [Hash] :attributes ({}) any additional attributes that will be added as part of the HTML
-
-        def initialize(items:, title: nil, id_prefix: nil, **options)
-          super(**options)
-
-          @title = title || 'Contents'
-          id_prefix ||= sanitize_to_id(@title.downcase)
-          @tabs = items.map.with_index(1) { |item, index| Tab.new(index: index, id_prefix: id_prefix, context: @context, **item) }
-          @panels = items.map.with_index(1) { |item, index| Panel.new(index: index, id_prefix: id_prefix, context: @context, **item[:panel]) }
-        end
-
-        # Generates the HTML for the GOV.UK Tabs component
-        #
-        # @return [ActiveSupport::SafeBuffer]
-
-        def render
-          tag.div(**options[:attributes]) do
-            concat(tag.h2(title, class: 'govuk-tabs__title'))
-            concat(tag.ul(class: 'govuk-tabs__list') do
-              @tabs.each { |tab| concat(tab.render) }
-            end)
-            @panels.each { |panel| concat(panel.render) }
-          end
-        end
-
-        # The default attributes for the tabs
-
-        DEFAULT_ATTRIBUTES = { class: 'govuk-tabs', data: { module: 'govuk-tabs' } }.freeze
-      end
-    end
-  end
-end

data/lib/ccs/components/govuk/tag.rb

@@ -1,51 +0,0 @@
-require_relative '../base'
-
-module CCS
-  module Components
-    module GovUK
-      # = GOV.UK Tag
-      #
-      # This is used to generate the tag component from the
-      # {https://design-system.service.gov.uk/components/tag GDS - Components - Tag}
-      #
-      # @!attribute [r] text
-      #   @return [String] Text for the tag
-
-      class Tag < Base
-        private
-
-        attr_reader :text
-
-        public
-
-        # @param text [String] the text for the tag
-        # @param colour [String] optional colour for the tag,
-        #                        see {https://design-system.service.gov.uk/components/tag/#additional-colours Tag - Additional colours}
-        #                        for available colours in GOV.UK Frontend
-        # @param options [Hash] options that will be used in customising the HTML
-        #
-        # @option options [String] :classes additional CSS classes for the tag HTML
-        # @option options [Hash] :attributes ({}) any additional attributes that will added as part of the HTML
-
-        def initialize(text:, colour: nil, **options)
-          super(**options)
-          @options[:attributes][:class][..8] = "govuk-tag govuk-tag--#{colour}" if colour
-
-          @text = text
-        end
-
-        # Generates the HTML for the GOV.UK Tag component
-        #
-        # @return [ActiveSupport::SafeBuffer]
-
-        def render
-          tag.strong(text, **options[:attributes])
-        end
-
-        # The default attributes for the tag
-
-        DEFAULT_ATTRIBUTES = { class: 'govuk-tag' }.freeze
-      end
-    end
-  end
-end

data/lib/ccs/components/govuk/warning_text.rb

@@ -1,61 +0,0 @@
-require_relative '../base'
-
-module CCS
-  module Components
-    module GovUK
-      # = GOV.UK Warning text
-      #
-      # This helper is used for generating the warning text component from the
-      # {https://design-system.service.gov.uk/components/warning-text GDS - Components - Warning text}
-      #
-      # @!attribute [r] text
-      #   @return [String] Text for the warning text
-
-      class WarningText < Base
-        private
-
-        attr_reader :text
-
-        public
-
-        # @param text [String] (nil) the text for the warning
-        #                            If nil, then a block will be rendered
-        # @param options [Hash] options that will be used in customising the HTML
-        #
-        # @option options [String] :classes additional CSS classes for the tag HTML
-        # @option options [String] :icon_fallback_text the fallback text for the icon (default: +'Warning'+)
-        # @option options [Hash] :attributes ({}) any additional attributes that will added as part of the HTML
-
-        def initialize(text: nil, **options)
-          super(**options)
-
-          @text = text
-        end
-
-        # Generates the HTML for the GOV.UK Warning text component
-        #
-        # @yield HTML that will be used in the warning text. Ignored if text is passed.
-        #
-        # @return [ActiveSupport::SafeBuffer]
-
-        def render
-          tag.div(**options[:attributes]) do
-            concat(tag.span('!', class: 'govuk-warning-text__icon', aria: { hidden: true }))
-            concat(tag.strong(class: 'govuk-warning-text__text') do
-              concat(tag.span(options[:icon_fallback_text] || 'Warning', class: 'govuk-warning-text__assistive'))
-              if text
-                concat(text)
-              else
-                yield
-              end
-            end)
-          end
-        end
-
-        # The default attributes for the warning text
-
-        DEFAULT_ATTRIBUTES = { class: 'govuk-warning-text' }.freeze
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/ccs_frontend/dashboard_section.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/ccs/dashboard_section'
-
-module CCS
-  module FrontendHelpers
-    module CCSFrontend
-      # = CCS Dashboard Section
-      #
-      # This helper is used for generating the dashboard section component
-
-      module DashboardSection
-        # Generates the HTML for the CCS Dashboard Section component
-        #
-        # @param (see CCS::Components::CCS::DashboardSection#initialize)
-        #
-        # @option (see CCS::Components::CCS::DashboardSection#initialize)
-        #
-        # @return (see CCS::Components::CCS::DashboardSection#render)
-
-        def ccs_dashboard_section(dashboard_section_panels, title_text = nil, **options)
-          Components::CCS::DashboardSection.new(context: self, dashboard_section_panels: dashboard_section_panels, title_text: title_text, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/character_count.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/input/character_count'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK Character count
-      #
-      # This helper is used for generating the character count component from the
-      # {https://design-system.service.gov.uk/components/character-count GDS - Components - Character count}
-
-      module CharacterCount
-        # Generates the HTML for the GOV.UK Character count component
-        #
-        # @param (see CCS::Components::GovUK::Input::CharacterCount#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Input::CharacterCount#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Input::CharacterCount#render)
-
-        def govuk_character_count(attribute, character_count_options, **options)
-          Components::GovUK::Field::Input::CharacterCount.new(context: self, attribute: attribute, character_count_options: character_count_options, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/checkboxes.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/inputs/checkboxes'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK Checkboxes
-      #
-      # This helper is used for generating the checkboxes component from the
-      # {https://design-system.service.gov.uk/components/checkboxes GDS - Components - Checkboxes}
-
-      module Checkboxes
-        # Generates the HTML for the GOV.UK Checkboxes component
-        #
-        # @param (see CCS::Components::GovUK::Inputs::Checkboxes#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Inputs::Checkboxes#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Inputs::Checkboxes#render)
-
-        def govuk_checkboxes(attribute, checkbox_items, **options)
-          Components::GovUK::Field::Inputs::Checkboxes.new(context: self, attribute: attribute, checkbox_items: checkbox_items, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/date_input.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/inputs/date_input'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK Date Input
-      #
-      # This helper is used for generating the date input component from the
-      # {https://design-system.service.gov.uk/components/date-input GDS - Components -  Date Input}
-
-      module DateInput
-        # Generates the HTML for the GOV.UK Date Input component
-        #
-        # @param (see CCS::Components::GovUK::Inputs::DateInput#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Inputs::DateInput#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Inputs::DateInput#render)
-
-        def govuk_date_input(attribute, **options)
-          Components::GovUK::Field::Inputs::DateInput.new(context: self, attribute: attribute, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/file_upload.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/input/file_upload'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK File Upload
-      #
-      # This helper is used for generating the file upload component from the
-      # {https://design-system.service.gov.uk/components/file-upload GDS - Components - File Upload}
-
-      module FileUpload
-        # Generates the HTML for the GOV.UK File Upload component
-        #
-        # @param (see CCS::Components::GovUK::Input::FileUpload#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Input::FileUpload#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Input::FileUpload#render)
-
-        def govuk_file_upload(attribute, **options)
-          Components::GovUK::Field::Input::FileUpload.new(context: self, attribute: attribute, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/input.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/input/text_input'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK Input
-      #
-      # This helper is used for generating the input component from the
-      # {https://design-system.service.gov.uk/components/text-input GDS - Components - Text Input}
-
-      module Input
-        # Generates the HTML for the GOV.UK Text Input component
-        #
-        # @param (see CCS::Components::GovUK::Input::TextInput#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Input::TextInput#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Input::TextInput#render)
-
-        def govuk_input(attribute, **options)
-          Components::GovUK::Field::Input::TextInput.new(context: self, attribute: attribute, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/radios.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/inputs/radios'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK Radios
-      #
-      # This helper is used for generating the radios component from the
-      # {https://design-system.service.gov.uk/components/radios GDS - Components - Radios}
-
-      module Radios
-        # Generates the HTML for the GOV.UK Radios component
-        #
-        # @param (see CCS::Components::GovUK::Inputs::Radios#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Inputs::Radios#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Inputs::Radios#render)
-
-        def govuk_radios(attribute, radio_items, **options)
-          Components::GovUK::Field::Inputs::Radios.new(context: self, attribute: attribute, radio_items: radio_items, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/select.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/input/select'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK Select
-      #
-      # This helper is used for generating the select component from the
-      # {https://design-system.service.gov.uk/components/select GDS - Components - Select}
-
-      module Select
-        # Generates the HTML for the GOV.UK Select component
-        #
-        # @param (see CCS::Components::GovUK::Input::Select#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Input::Select#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Input::Select#render)
-
-        def govuk_select(attribute, items, **options)
-          Components::GovUK::Field::Input::Select.new(context: self, attribute: attribute, items: items, **options).render
-        end
-      end
-    end
-  end
-end

data/lib/ccs/frontend_helpers/govuk_frontend/textarea.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../components/govuk/field/input/textarea'
-
-module CCS
-  module FrontendHelpers
-    module GovUKFrontend
-      # = GOV.UK Textarea
-      #
-      # This helper is used for generating the textarea component from the
-      # {https://design-system.service.gov.uk/components/textarea GDS - Components - Textarea}
-
-      module Textarea
-        # Generates the HTML for the GOV.UK Textarea component
-        #
-        # @param (see CCS::Components::GovUK::Input::Textarea#initialize)
-        #
-        # @option (see CCS::Components::GovUK::Input::Textarea#initialize)
-        #
-        # @return (see CCS::Components::GovUK::Input::Textarea#render)
-
-        def govuk_textarea(attribute, **options)
-          Components::GovUK::Field::Input::Textarea.new(context: self, attribute: attribute, **options).render
-        end
-      end
-    end
-  end
-end