ccs-frontend_helpers 0.1.0.rc.1 → 0.1.0.rc.2

data/lib/ccs/components/govuk/header/navigation.rb

@@ -0,0 +1,70 @@
+require_relative '../../base'
+require_relative 'link'
+
+module CCS::Components
+  module GovUK
+    class Header < Base
+      # = GOV.UK Header navigation
+      #
+      # The header navigation section
+      #
+      # @!attribute [r] navigation_links
+      #   @return [Array<Link>] An array of the initialised navigation links
+      # @!attribute [r] navigation_label
+      #   @return [String] The aria label for the navigation
+      # @!attribute [r] navigation_classes
+      #   @return [String] The classes for the navigation
+      # @!attribute [r] menu_button
+      #   @return [Hash] The options for the menu button
+
+      class Navigation
+        include ActionView::Context
+        include ActionView::Helpers
+
+        private
+
+        attr_reader :navigation_links, :navigation_label, :navigation_classes, :menu_button
+
+        public
+
+        # @param navigation [Hash] options for the navigation
+        # @param context [ActionView::Base] the view context
+        # @param menu_button [Hash] options for the menu button
+        #
+        # @option navigation [Array] :items an array of links for the navigation section.
+        #                            See {Components::GovUK::Header::Link#initialize Link#initialize} for details of the items in the array.
+        # @option navigation [String] :classes additional CSS classes for the navigation HTML
+        # @option navigation [String] :label text for the aria-label attribute of the navigation. Defaults to the menu button text
+        #
+        # @option menu_button [String] :text text for the button that opens the mobile navigation menu.
+        #                                    By default, this is set to +Menu+.
+        # @option menu_button [String] :label text for the aria-label attribute of the button that opens the mobile navigation.
+        #                                     Defaults to +Show or hide menu+.
+
+        def initialize(navigation:, context:, menu_button: nil)
+          menu_button ||= {}
+          menu_button[:text] ||= 'Menu'
+          menu_button[:label] ||= 'Show or hide menu'
+
+          @menu_button = menu_button
+          @navigation_links = navigation[:items].map { |navigation_link| Link.new(context: context, **navigation_link) }
+          @navigation_label = navigation[:label] || menu_button[:text]
+          @navigation_classes = "govuk-header__navigation #{navigation[:classes]}".rstrip
+        end
+
+        # Generates the HTML for the GOV.UK Navigation
+        #
+        # @return [ActiveSupport::SafeBuffer]
+
+        def render
+          tag.nav(aria: { label: navigation_label }, class: navigation_classes) do
+            concat(button_tag(menu_button[:text], type: :button, class: 'govuk-header__menu-button govuk-js-header-toggle', aria: { controls: 'navigation', label: menu_button[:label] }, hidden: true))
+            concat(tag.ul(id: 'navigation', class: 'govuk-header__navigation-list') do
+              navigation_links.each { |navigation_link| concat(navigation_link.render) }
+            end)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,105 @@
+require_relative '../base'
+require_relative 'header/navigation'
+
+module CCS::Components
+  module GovUK
+    # = GOV.UK Header
+    #
+    # This is used to generate the header component from the
+    # {https://design-system.service.gov.uk/components/header GDS - Components - Header}
+    #
+    # @!attribute [r] navigation
+    #   @return [Navigation] The initialised navigation section
+    # @!attribute [r] service
+    #   @return [Hash] The options for the service section
+
+    class Header < Base
+      private
+
+      attr_reader :navigation, :service
+
+      public
+
+      # @param navigation [Hash] options for the navigation section of the header.
+      #                          See {Components::GovUK::Header::Navigation#initialize Navigation#initialize} for details of the options.
+      # @param menu_button [Hash] options for the menu button in the header.
+      #                           See {Components::GovUK::Header::Navigation#initialize Navigation#initialize} for details of the options.
+      # @param service [Hash] options for the service name
+      # @param options [Hash] options that will be used in customising the HTML
+      #
+      # @option service [String] :name the name of the service, included in the header
+      # @option service [String] :href URL for the service name anchor
+      #
+      # @option options [String] :classes additional CSS classes for the header HTML
+      # @option options [String] :container_classes classes for the container
+      # @option options [String] :homepage_url URL of the homepage. Defaults to +/+
+      # @option options [String] :product_name product name, used when the product name follows on directly from ‘GOV.UK
+      # @option options [Hash] :attributes additional attributes that will added as part of the header HTML
+
+      def initialize(navigation: nil, menu_button: nil, service: nil, **options)
+        super(**options)
+
+        @options[:attributes][:role] = 'banner'
+        @options[:container_classes] ||= 'govuk-width-container'
+        @options[:homepage_url] ||= '/'
+
+        @navigation = Navigation.new(navigation: navigation, menu_button: menu_button, context: @context) if navigation
+        @service = service
+      end
+
+      # Generates the HTML for the GOV.UK Header component
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def render
+        tag.header(**options[:attributes]) do
+          tag.div(class: "govuk-header__container #{options[:container_classes]}") do
+            concat(header_logo)
+            if service || navigation
+              concat(tag.div(class: 'govuk-header__content') do
+                concat(header_service_name) if service
+                concat(navigation.render) if navigation
+              end)
+            end
+          end
+        end
+      end
+
+      # The default attributes for the breadcrumbs
+
+      DEFAULT_ATTRIBUTES = { class: 'govuk-header', data: { module: 'govuk-header' } }.freeze
+
+      private
+
+      # Generates the logo for header
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def header_logo
+        tag.div(class: 'govuk-header__logo') do
+          link_to(options[:homepage_url], class: 'govuk-header__link govuk-header__link--homepage') do
+            concat(tag.span(class: 'govuk-header__logotype') do
+              concat(tag.svg(class: 'govuk-header__logotype-crown', xmlns: 'http://www.w3.org/2000/svg', height: '30', width: '36', aria: { hidden: 'true' }, focusable: 'false', viewBox: '0 0 132 97') do
+                tag.path(fill: 'currentColor', 'fill-rule': 'evenodd', d: 'M25 30.2c3.5 1.5 7.7-.2 9.1-3.7 1.5-3.6-.2-7.8-3.9-9.2-3.6-1.4-7.6.3-9.1 3.9-1.4 3.5.3 7.5 3.9 9zM9 39.5c3.6 1.5 7.8-.2 9.2-3.7 1.5-3.6-.2-7.8-3.9-9.1-3.6-1.5-7.6.2-9.1 3.8-1.4 3.5.3 7.5 3.8 9zM4.4 57.2c3.5 1.5 7.7-.2 9.1-3.8 1.5-3.6-.2-7.7-3.9-9.1-3.5-1.5-7.6.3-9.1 3.8-1.4 3.5.3 7.6 3.9 9.1zm38.3-21.4c3.5 1.5 7.7-.2 9.1-3.8 1.5-3.6-.2-7.7-3.9-9.1-3.6-1.5-7.6.3-9.1 3.8-1.3 3.6.4 7.7 3.9 9.1zm64.4-5.6c-3.6 1.5-7.8-.2-9.1-3.7-1.5-3.6.2-7.8 3.8-9.2 3.6-1.4 7.7.3 9.2 3.9 1.3 3.5-.4 7.5-3.9 9zm15.9 9.3c-3.6 1.5-7.7-.2-9.1-3.7-1.5-3.6.2-7.8 3.7-9.1 3.6-1.5 7.7.2 9.2 3.8 1.5 3.5-.3 7.5-3.8 9zm4.7 17.7c-3.6 1.5-7.8-.2-9.2-3.8-1.5-3.6.2-7.7 3.9-9.1 3.6-1.5 7.7.3 9.2 3.8 1.3 3.5-.4 7.6-3.9 9.1zM89.3 35.8c-3.6 1.5-7.8-.2-9.2-3.8-1.4-3.6.2-7.7 3.9-9.1 3.6-1.5 7.7.3 9.2 3.8 1.4 3.6-.3 7.7-3.9 9.1zM69.7 17.7l8.9 4.7V9.3l-8.9 2.8c-.2-.3-.5-.6-.9-.9L72.4 0H59.6l3.5 11.2c-.3.3-.6.5-.9.9l-8.8-2.8v13.1l8.8-4.7c.3.3.6.7.9.9l-5 15.4v.1c-.2.8-.4 1.6-.4 2.4 0 4.1 3.1 7.5 7 8.1h.2c.3 0 .7.1 1 .1.4 0 .7 0 1-.1h.2c4-.6 7.1-4.1 7.1-8.1 0-.8-.1-1.7-.4-2.4V34l-5.1-15.4c.4-.2.7-.6 1-.9zM66 92.8c16.9 0 32.8 1.1 47.1 3.2 4-16.9 8.9-26.7 14-33.5l-9.6-3.4c1 4.9 1.1 7.2 0 10.2-1.5-1.4-3-4.3-4.2-8.7L108.6 76c2.8-2 5-3.2 7.5-3.3-4.4 9.4-10 11.9-13.6 11.2-4.3-.8-6.3-4.6-5.6-7.9 1-4.7 5.7-5.9 8-.5 4.3-8.7-3-11.4-7.6-8.8 7.1-7.2 7.9-13.5 2.1-21.1-8 6.1-8.1 12.3-4.5 20.8-4.7-5.4-12.1-2.5-9.5 6.2 3.4-5.2 7.9-2 7.2 3.1-.6 4.3-6.4 7.8-13.5 7.2-10.3-.9-10.9-8-11.2-13.8 2.5-.5 7.1 1.8 11 7.3L80.2 60c-4.1 4.4-8 5.3-12.3 5.4 1.4-4.4 8-11.6 8-11.6H55.5s6.4 7.2 7.9 11.6c-4.2-.1-8-1-12.3-5.4l1.4 16.4c3.9-5.5 8.5-7.7 10.9-7.3-.3 5.8-.9 12.8-11.1 13.8-7.2.6-12.9-2.9-13.5-7.2-.7-5 3.8-8.3 7.1-3.1 2.7-8.7-4.6-11.6-9.4-6.2 3.7-8.5 3.6-14.7-4.6-20.8-5.8 7.6-5 13.9 2.2 21.1-4.7-2.6-11.9.1-7.7 8.8 2.3-5.5 7.1-4.2 8.1.5.7 3.3-1.3 7.1-5.7 7.9-3.5.7-9-1.8-13.5-11.2 2.5.1 4.7 1.3 7.5 3.3l-4.7-15.4c-1.2 4.4-2.7 7.2-4.3 8.7-1.1-3-.9-5.3 0-10.2l-9.5 3.4c5 6.9 9.9 16.7 14 33.5 14.8-2.1 30.8-3.2 47.7-3.2z')
+              end)
+              concat(tag.span('GOV.UK', class: 'govuk-header__logotype-text'))
+            end)
+            concat(tag.span(options[:product_name], class: 'govuk-header__product-name')) if options[:product_name]
+          end
+        end
+      end
+
+      # Generates the service name section
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def header_service_name
+        if service[:href]
+          link_to(service[:name], service[:href], class: 'govuk-header__link govuk-header__service-name')
+        else
+          tag.span(service[:name], class: 'govuk-header__service-name')
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+require_relative '../base'
+
+module CCS::Components
+  module GovUK
+    # = GOV.UK Hint
+    #
+    # This is used to generate the hint text component from the Government Design Systems
+    #
+    # @!attribute [r] text
+    #   @return [String] Text for the hint
+
+    class Hint < Base
+      private
+
+      attr_reader :text
+
+      public
+
+      # @param text [String] the hint text.
+      #                      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 hint HTML
+      # @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 Hint component
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def render
+        tag.div(**options[:attributes]) do
+          text || yield
+        end
+      end
+
+      # The default attributes for the hint
+
+      DEFAULT_ATTRIBUTES = { class: 'govuk-hint' }.freeze
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+require_relative '../base'
+
+module CCS::Components
+  module GovUK
+    # = GOV.UK Inset Text
+    #
+    # This is used to generate the inset text component from the
+    # {https://design-system.service.gov.uk/components/inset-text GDS - Components - Inset text}
+    #
+    # @!attribute [r] text
+    #   @return [String] Text for the inset text
+
+    class InsetText < Base
+      private
+
+      attr_reader :text
+
+      public
+
+      # @param text [String] text to use within the inset text component.
+      #                      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 inset text HTML
+      # @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 Inset text component
+      #
+      # @yield HTML that will be contained within the inset text div. Ignored if inset text is given
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def render
+        tag.div(**options[:attributes]) do
+          text || yield
+        end
+      end
+
+      # The default attributes for the inset text
+
+      DEFAULT_ATTRIBUTES = { class: 'govuk-inset-text' }.freeze
+    end
+  end
+end

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

@@ -0,0 +1,83 @@
+require_relative '../base'
+
+module CCS::Components
+  module GovUK
+    # = GOV.UK Label
+    #
+    # This is used to generate the label component from the Government Design Systems
+    #
+    # @!attribute [r] attribute
+    #   @return [String, Symbol] Attribute of the input that requires a label
+    # @!attribute [r] text
+    #   @return [String] Text for the label
+    # @!attribute [r] form
+    #   @return [ActionView::Helpers::FormBuilder] Form builder used to create the label
+
+    class Label < Base
+      private
+
+      attr_reader :attribute, :text, :form
+
+      public
+
+      # @param attribute [String, Symbol] the attribute of the input that requires a label
+      # @param text [String] (nil) the text for the label
+      #                            If nil, then a block will be rendered
+      # @param form [ActionView::Helpers::FormBuilder] (nil) optional form builder used to create the label
+      # @param options [Hash] options that will be used in customising the HTML
+      #
+      # @option options [String] :classes additional CSS classes for the label HTML
+      # @option options [Boolean] :is_page_heading (false) if the label is also the heading it will rendered in a h1
+      # @option options [Hash] :attributes ({}) any additional attributes that will added as part of the HTML
+
+      def initialize(attribute:, text: nil, form: nil, **options)
+        super(**options)
+
+        @attribute = attribute
+        @text = text
+        @form = form
+      end
+
+      # Generates the HTML for the GOV.UK label component
+      #
+      # @yield HTML that will be generated for the label
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def render(&block)
+        if options[:is_page_heading]
+          tag.h1(class: 'govuk-label-wrapper') do
+            label_html(&block)
+          end
+        else
+          label_html(&block)
+        end
+      end
+
+      # The default attributes for the label
+
+      DEFAULT_ATTRIBUTES = { class: 'govuk-label' }.freeze
+
+      private
+
+      # Generates the HTML for the label.
+      # If +:form+ attribute is present, it will be used to generate the label tag
+      #
+      # @yield HTML that will be used in the label. Ignored if text is passed.
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def label_html
+        if form
+          form.label(attribute, **options[:attributes]) do
+            text || yield
+          end
+        else
+          label_tag(attribute, **options[:attributes]) do
+            text || yield
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,105 @@
+require_relative '../base'
+
+module CCS::Components
+  module GovUK
+    # = GOV.UK Notification Banner
+    #
+    # This helper is used for generating the notification banner component from the
+    # {https://design-system.service.gov.uk/components/notification-banner GDS - Components - Notification banner}
+    #
+    # @!attribute [r] text
+    #   @return [String] Text for the notification banner
+    # @!attribute [r] success_banner
+    #   @return [Boolean] Indicates if this is a success banner
+
+    class NotificationBanner < Base
+      private
+
+      attr_reader :text, :success_banner
+
+      public
+
+      # @param text [String] the text that will be used for the heading in the content section of the banner.
+      #                      It is ignored if a block is given
+      # @param success_banner [Boolean] will use the success banner options if this is set to true
+      # @param options [Hash] options that will be used in customising the HTML
+      #
+      # @option options [String] :classes additional CSS classes for the notification banner HTML
+      # @option options [String] :title_text ('Important') the title text shown at the top of the banner
+      # @option options [String] :title_id ('govuk-notification-banner-title') the ID for the title text
+      # @option options [String] :role ('region') the role for the banner
+      # @option options [String] :heading_level (2) the heading level for the title text
+      # @option options [Hash] :attributes ({}) any additional attributes that will added as part of the HTML
+
+      def initialize(text: nil, success_banner: nil, **options)
+        super(**options)
+
+        @text = text
+        @success_banner = success_banner || false
+
+        set_additional_options_for_banner
+      end
+
+      # Generates the HTML for the GOV.UK Notification banner component
+      #
+      # @yield HTML that will be contained within the 'govuk-notification-banner__content' div
+      #
+      # @return [ActiveSupport::SafeBuffer]
+
+      def render
+        tag.div(**options[:attributes]) do
+          concat(tag.div(class: 'govuk-notification-banner__header') do
+            tag.send(:"h#{options[:heading_level] || 2}", options[:title_text], class: 'govuk-notification-banner__title', id: options[:title_id])
+          end)
+          concat(tag.div(class: 'govuk-notification-banner__content') do
+            if block_given?
+              yield
+            else
+              tag.p(text, class: 'govuk-notification-banner__heading')
+            end
+          end)
+        end
+      end
+
+      # The default attributes for the notifaction banner
+
+      DEFAULT_ATTRIBUTES = { class: 'govuk-notification-banner', data: { module: 'govuk-notification-banner' } }.freeze
+
+      # Default options used in normal versions of the notification banner
+
+      DEFAULT_OPTIONS = {
+        title_text: 'Important',
+        title_id: 'govuk-notification-banner-title',
+        role: 'region'
+      }.freeze
+
+      # Specific options for the success version of the notification banner
+
+      SUCCESS_BANNER_OPTIONS = {
+        classes: ' govuk-notification-banner--success',
+        title_text: 'Success',
+        role: 'alert'
+      }.freeze
+
+      private
+
+      # rubocop:disable Metrics/AbcSize
+
+      # Determines the banner options to be used for the notification banner
+
+      def set_additional_options_for_banner
+        banner_options = DEFAULT_OPTIONS.dup
+
+        banner_options.merge!(SUCCESS_BANNER_OPTIONS) if success_banner
+
+        options[:title_text] ||= banner_options[:title_text]
+        options[:title_id] ||= banner_options[:title_id]
+        options[:attributes][:role] ||= banner_options[:role]
+        options[:attributes][:class] << banner_options[:classes].to_s
+        (options[:attributes][:aria] ||= {})[:labelledby] = options[:title_id]
+      end
+
+      # rubocop:enable Metrics/AbcSize
+    end
+  end
+end

data/lib/ccs/components/govuk/pagination/increment/next.rb

@@ -0,0 +1,42 @@
+require_relative '../increment'
+
+module CCS::Components
+  module GovUK
+    class Pagination < Base
+      class Increment < Base
+        # = GOV.UK Pagination Next
+        #
+        # This generates the HTML for the pagination next link
+
+        class Next < Increment
+          # @param (see Increment#initialize)
+          #
+          # @option (see Increment#initialize)
+
+          def initialize(text: 'Next', **options)
+            super(type: :next, text: text, **options)
+          end
+
+          # Generates the HTML for the next link in the pagination
+          #
+          # @return [ActiveSupport::SafeBuffer]
+
+          def render
+            tag.div(class: 'govuk-pagination__next') do
+              super() do
+                concat(pagination_icon) if block_is_level
+                concat(tag.span(text, class: pagination_text_classes))
+                pagination_icon_label_text
+                concat(pagination_icon) unless block_is_level
+              end
+            end
+          end
+
+          # The path for the pagination next icon
+
+          PAGINATION_ICON_PATH = 'm8.107-0.0078125-1.4136 1.414 4.2926 4.293h-12.986v2h12.896l-4.1855 3.9766 1.377 1.4492 6.7441-6.4062-6.7246-6.7266z'.freeze
+        end
+      end
+    end
+  end
+end

data/lib/ccs/components/govuk/pagination/increment/previous.rb

@@ -0,0 +1,41 @@
+require_relative '../increment'
+
+module CCS::Components
+  module GovUK
+    class Pagination < Base
+      class Increment < Base
+        # = GOV.UK Pagination Previous
+        #
+        # This generates the HTML for the pagination previous link
+
+        class Previous < Increment
+          # @param (see Increment#initialize)
+          #
+          # @option (see Increment#initialize)
+
+          def initialize(text: 'Previous', **options)
+            super(type: :prev, text: text, **options)
+          end
+
+          # Generates the HTML for the previous link in the pagination
+          #
+          # @return [ActiveSupport::SafeBuffer]
+
+          def render
+            tag.div(class: 'govuk-pagination__prev') do
+              super() do
+                concat(pagination_icon)
+                concat(tag.span(text, class: pagination_text_classes))
+                pagination_icon_label_text
+              end
+            end
+          end
+
+          # The path for the pagination previous icon
+
+          PAGINATION_ICON_PATH = 'm6.5938-0.0078125-6.7266 6.7266 6.7441 6.4062 1.377-1.449-4.1856-3.9768h12.896v-2h-12.984l4.2931-4.293-1.414-1.414z'.freeze
+        end
+      end
+    end
+  end
+end

data/lib/ccs/components/govuk/pagination/increment.rb

@@ -0,0 +1,96 @@
+require_relative '../../base'
+
+module CCS::Components
+  module GovUK
+    class Pagination < Base
+      # = GOV.UK Pagination Increment
+      #
+      # This generates the HTML for a  pagination increment, that is {Previous} and {Next}
+      #
+      # @!attribute [r] type
+      #   @return [Symbol] The type of pagination increment
+      # @!attribute [r] text
+      #   @return [String] Text for the pagination increment
+      # @!attribute [r] block_is_level
+      #   @return [Boolean] Flag to indicate if previous and next blocks are level
+      # @!attribute [r] label_text
+      #   @return [Boolean] Additional label text for when +block_is_level == true+
+
+      class Increment < Base
+        private
+
+        attr_reader :type, :text, :block_is_level, :label_text
+
+        public
+
+        # @param type [Symbol] the type of increment, either +:prev+ or +:next+
+        # @param text [String] the text for the pagination increment
+        # @param block_is_level [Boolean] when there are no items, this will be true and will add extra classes
+        #                                 to the link to make the next and previous pagination links level
+        # @param label_text [String] additional text for the link when the pagination block is level
+        # @param options [Hash] options that will be used in customising the HTML
+        #
+        # @option options [String] :href the URL for the link
+        # @option options  [ActionView::Helpers::FormBuilder] :form optional form builder used to create the button
+        # @option options [Hash] :attributes any additional attributes that will added as part of the HTML
+
+        def initialize(type:, text:, block_is_level:, label_text: nil, **options)
+          super(**options)
+
+          @options[:attributes][:class] = "govuk-link govuk-pagination__link #{'pagination--button_as_link' if @options[:form]}".rstrip
+          @options[:attributes][:rel] = type.to_s
+
+          @type = type
+          @text = text
+          @block_is_level = block_is_level
+          @label_text = label_text
+        end
+
+        # Generates the HTML for the pagination increment link/button
+        #
+        # @yield the HTML for the increment button/link
+        #
+        # @return [ActiveSupport::SafeBuffer]
+
+        def render(&block)
+          if options[:form]
+            options[:form].button(**options[:attributes], &block)
+          else
+            link_to(options[:href], **options[:attributes], &block)
+          end
+        end
+
+        private
+
+        # Returns the classes for the link/button label
+        #
+        # @return [String]
+
+        def pagination_text_classes
+          "govuk-pagination__link-title #{'govuk-pagination__link-title--decorated' if block_is_level && !label_text}".rstrip
+        end
+
+        # Generates the icon for the pagination increment
+        #
+        # @return [ActiveSupport::SafeBuffer]
+
+        def pagination_icon
+          tag.svg(class: "govuk-pagination__icon govuk-pagination__icon--#{type}", xmlns: 'http://www.w3.org/2000/svg', height: '13', width: '15', aria: { hidden: 'true' }, focusable: 'false', viewBox: '0 0 15 13') do
+            tag.path(d: self.class::PAGINATION_ICON_PATH)
+          end
+        end
+
+        # Generates the label text for when the block is level
+        #
+        # @return [ActiveSupport::SafeBuffer]
+
+        def pagination_icon_label_text
+          return unless block_is_level && label_text
+
+          concat(tag.span(':', class: 'govuk-visually-hidden'))
+          concat(tag.span(label_text, class: 'govuk-pagination__link-label'))
+        end
+      end
+    end
+  end
+end

data/lib/ccs/components/govuk/pagination/item/ellipsis.rb

@@ -0,0 +1,26 @@
+require 'action_view'
+
+module CCS::Components
+  module GovUK
+    class Pagination < Base
+      class Item < Base
+        # = GOV.UK Pagination Item ellipsis
+        #
+        # This generates the HTML for a  pagination ellipsis
+
+        class Ellipsis
+          extend ActionView::Context
+          extend ActionView::Helpers
+
+          # Generates the HTML for the GOV.UK Pagination Item ellipsis
+          #
+          # @return [ActiveSupport::SafeBuffer]
+
+          def self.render
+            tag.li('⋯', class: 'govuk-pagination__item govuk-pagination__item--ellipses')
+          end
+        end
+      end
+    end
+  end
+end