formular 0.2.0

data/lib/formular/element/bootstrap4/horizontal.rb

@@ -0,0 +1,87 @@
+require 'formular/element'
+require 'formular/elements'
+require 'formular/element/module'
+require 'formular/element/bootstrap4'
+require 'formular/element/bootstrap4/checkable_control'
+require 'formular/element/bootstrap4/custom_control'
+require 'formular/element/bootstrap3/horizontal'
+module Formular
+  class Element
+    module Bootstrap4
+      module Horizontal
+        class Label < Formular::Element::Label
+          set_default :class, :column_class
+
+          def column_class
+            builder.class.column_classes[:left_column] + ['col-form-label']
+          end
+        end # class Label
+
+        class Legend < Formular::Element::Legend
+          set_default :class, :column_class
+
+          def column_class
+            builder.class.column_classes[:left_column] + ['col-form-legend']
+          end
+        end # class Legend
+
+        class Input < Formular::Element::Bootstrap4::Input
+          include Formular::Element::Bootstrap3::Horizontal::WrappedControl
+        end # class Input
+
+        class CustomFile < Formular::Element::Bootstrap4::CustomFile
+          include Formular::Element::Bootstrap3::Horizontal::WrappedControl
+        end # class CustomFile
+
+        class CustomSelect < Formular::Element::Bootstrap4::CustomSelect
+          include Formular::Element::Bootstrap3::Horizontal::WrappedControl
+        end # class CustomFile
+
+        class Submit < Formular::Element::Bootstrap4::Submit
+          self.html_context = :wrapped
+
+          html(:wrapped) do |input|
+            input.wrapper do |wrapper|
+              wrapper.input_column_wrapper(
+                        class: input.builder.class.column_classes[:left_offset],
+                        content: input.to_html(context: :default)
+                      )
+            end
+          end
+        end # class Submit
+
+        class Checkbox < Formular::Element::Bootstrap4::StackedCheckbox
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class Checkbox
+
+        class CustomStackedCheckbox < Formular::Element::Bootstrap4::CustomStackedCheckbox
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class CustomStackedCheckbox
+
+        class Radio < Formular::Element::Bootstrap4::StackedRadio
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class Radio
+
+        class CustomStackedRadio < Formular::Element::Bootstrap4::CustomStackedRadio
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class CustomStackedRadio
+
+        class InlineCheckbox < Formular::Element::Bootstrap4::InlineCheckbox
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class InlineCheckbox
+
+        class CustomCheckbox < Formular::Element::Bootstrap4::Inline::CustomCheckbox
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class CustomCheckbox
+
+        class InlineRadio < Formular::Element::Bootstrap4::InlineRadio
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class InlineRadio
+
+        class CustomRadio < Formular::Element::Bootstrap4::Inline::CustomRadio
+          include Formular::Element::Bootstrap3::Horizontal::WrappedCheckableControl
+        end # class CustomRadio
+      end # module Horizontal
+    end # module Bootstrap4
+  end # class Element
+end # module Formular

data/lib/formular/element/foundation6.rb

@@ -0,0 +1,69 @@
+require 'formular/elements'
+require 'formular/element/modules/wrapped_control'
+require 'formular/element/module'
+require 'formular/element/foundation6/checkable_control'
+require 'formular/element/foundation6/wrapped_control'
+module Formular
+  class Element
+    module Foundation6
+      include CheckableControl
+
+      class ErrorNotification < Formular::Element::ErrorNotification
+        set_default :class, ['callout alert']
+      end
+
+      module InputWithErrors
+        include Formular::Element::Module
+        set_default :class, ['is-invalid-input'], if: :has_errors?
+      end # module InputWithErrors
+
+      class Submit < Formular::Element::Button
+        set_default :class, ['success', 'button']
+        set_default :type, 'submit'
+      end # class Submit
+
+      class LabelWithError < Formular::Element::Label
+        set_default :class, ['is-invalid-label']
+      end # class LabelWithError
+
+      class Error < Formular::Element::Error
+        tag :span
+        set_default :class, ['form-error', 'is-visible']
+      end # class Error
+
+      class Hint < Formular::Element::P
+        set_default :class, ['help-text']
+      end # class Hint
+
+      class Input < Formular::Element::Input
+        include WrappedControl
+        include InputWithErrors
+      end # class Input
+
+      class File < Input
+        set_default :type, 'file'
+        set_default :class, ['show-for-sr']
+        set_default :label_options, { class: ['button'] }
+
+        self.html_context = :wrapped
+
+        html(:wrapped) do |input|
+          concat input.label
+          concat input.to_html(context: :default)
+          concat input.hint
+          concat input.error
+        end
+      end # class File
+
+      class Select < Formular::Element::Select
+        include WrappedControl
+        include InputWithErrors
+      end # class Select
+
+      class Textarea < Formular::Element::Textarea
+        include WrappedControl
+        include InputWithErrors
+      end # class Textarea
+    end # module Foundation6
+  end # class Element
+end # module Formular

data/lib/formular/element/foundation6/checkable_control.rb

@@ -0,0 +1,72 @@
+require 'formular/elements'
+require 'formular/element/module'
+require 'formular/element/foundation6/wrapped_control'
+module Formular
+  class Element
+    module Foundation6
+      module CheckableControl
+        module Checkable
+          include Formular::Element::Module
+          include Formular::Element::Foundation6::WrappedControl
+
+          set_default :label_options, { class: ['is-invalid-label'] }, if: :has_errors?
+          set_default :control_label_options, { class: ['is-invalid-label'] }, if: :has_errors?
+
+          html(:wrapped) do |input|
+            input.wrapper do
+              concat input.group_label
+              concat input.hidden_tag unless input.collection?
+              concat input.to_html(context: :collection)
+              concat input.hidden_tag if input.collection?
+              concat input.hint
+              concat input.error
+            end
+          end
+
+          module InstanceMethods
+            def wrapper(&block)
+              builder.fieldset(Attributes[options[:wrapper_options]], &block)
+            end
+          end
+        end # class Checkable
+
+        module StackedCheckable
+          include Formular::Element::Module
+          include Checkable
+
+          html(:collection) do |input|
+            input.collection.map { |control|
+              input.builder.div(content: control.to_html(context: :checkable_label))
+            }.join('')
+          end
+        end # class StackedCheckable
+
+        class Checkbox < Formular::Element::Checkbox
+          include Checkable
+
+          set_default :value, '1' # instead of reader value
+          set_default :label_options, { class: ['is-invalid-label'] }, if: :has_errors?
+          set_default :control_label_options, { class: ['is-invalid-label'] }, if: :has_errors?
+
+          html { closed_start_tag }
+        end # class Checkbox
+
+        class Radio < Formular::Element::Radio
+          include Checkable
+
+          def hidden_tag
+            ''
+          end
+        end # class Radio
+
+        class StackedRadio < Radio
+          include StackedCheckable
+        end # class StackedRadio
+
+        class StackedCheckbox < Checkbox
+          include StackedCheckable
+        end # class StackedCheckbox
+      end # module CheckableControls
+    end #module Foundation6
+  end # class Element
+end # module Formular

data/lib/formular/element/foundation6/input_group.rb

@@ -0,0 +1,88 @@
+require 'formular/elements'
+require 'formular/element/modules/container'
+require 'formular/element/modules/wrapped_control'
+module Formular
+  class Element
+    module Foundation6
+      class InputGroup < Formular::Element::Input
+        module WrappedGroup
+          include Formular::Element::Module
+          include Formular::Element::Modules::WrappedControl
+
+          def wrapper(&block)
+            builder.fieldset(Attributes[options[:wrapper_options]], &block)
+          end
+        end # module WrappedGroup
+
+
+        class Wrapper < Formular::Element::Div
+          set_default :class, ['input-group']
+        end # class Wrapper
+
+        class Label < Formular::Element::Span
+          set_default :class, ['input-group-label']
+        end # class Label
+
+        class Button < Formular::Element::Div
+          set_default :class, ['input-group-button']
+        end # class Button
+
+        include WrappedGroup
+        include Formular::Element::Modules::Container
+
+        set_default :class, :input_class # we need to do classes better...
+
+        add_option_keys :left_label, :right_label, :left_button, :right_button
+
+        html(:raw_input) { closed_start_tag }
+
+        html do |input|
+          content = input.has_content? ? input.content : input.to_html(context: :with_options)
+          Wrapper.(content: content)
+        end
+
+        def group_label(content = nil, option_key: nil)
+          return '' unless content || option_key
+          addon_content = content || options[option_key]
+          return '' unless addon_content
+          label_options = { content: addon_content }
+          label_options[:class] = ['is-invalid-label'] if has_errors?
+
+          Label.(label_options)
+        end
+
+        def group_button(content = nil, option_key: nil)
+          return '' unless content || option_key
+          addon_content = content || options[option_key]
+          return '' unless addon_content
+
+          Button.(content: addon_content)
+        end
+
+        def group_input
+          to_html(context: :raw_input)
+        end
+
+        def input_class
+          return ['input-group-field'] unless has_errors?
+
+          ['input-group-field', 'is-invalid-input']
+        end
+
+        def label_options
+          return super unless has_errors?
+
+          @label_options ||= Attributes[options[:label_options]].merge(class: ['is-invalid-label'])
+        end
+
+        html(:with_options) do |input|
+          concat input.group_label(option_key: :left_label)
+          concat input.group_button(option_key: :left_button)
+          concat input.group_input
+          concat input.group_label(option_key: :right_label)
+          concat input.group_button(option_key: :right_button)
+        end
+      end # class InputGroup
+    end #module Foundation6
+  end #class Element
+end # module Foundation

data/lib/formular/element/foundation6/wrapped_control.rb

@@ -0,0 +1,21 @@
+require 'formular/element/module'
+require 'formular/element/modules/wrapped_control'
+module Formular
+  class Element
+    module Foundation6
+      module WrappedControl
+        include Formular::Element::Module
+        include Formular::Element::Modules::WrappedControl
+
+        html(:wrapped) do |input|
+          input.wrapper do
+            concat input.label_text
+            concat input.to_html(context: :default)
+            concat input.hint
+            concat input.error
+          end.to_s
+        end
+      end # module WrappedControl
+    end # module Foundation6
+  end # class Element
+end # module Formular

data/lib/formular/element/module.rb

@@ -0,0 +1,35 @@
+# Include this in every module that gets further included.
+# This is literally a copy and past from reform. Could we dry this up ??
+# https://github.com/apotonick/reform/blob/master/lib/reform/form/module.rb
+
+# require 'declarative/heritage'
+module Formular
+  class Element
+    module Module
+      # DISCUSS: could this be part of Declarative?
+      def self.included(base)
+        base.extend ClassMethods
+        base.extend Declarative::Heritage::DSL # ::heritage
+        # base.extend Declarative::Heritage::Included # ::included
+        base.extend Included
+      end
+
+      module Included
+        # Gets imported into your module and will be run when including it.
+        def included(includer)
+          super
+          # first, replay all declaratives like ::property on includer.
+          heritage.(includer) # this normally happens via Heritage::Included.
+          # then, include optional accessors.
+          includer.send(:include, self::InstanceMethods) if const_defined?(:InstanceMethods)
+        end
+      end # module Included
+
+      module ClassMethods
+        def method_missing(method, *args, &block)
+          heritage.record(method, *args, &block)
+        end
+      end # module ClassMethods
+    end # module Module
+  end # class Element
+end # module Formular

data/lib/formular/element/modules/checkable.rb

@@ -0,0 +1,96 @@
+require 'formular/element/module'
+require 'formular/element/modules/collection'
+require 'formular/element/modules/label'
+
+module Formular
+  class Element
+    module Modules
+      # this module is used to correctly set the :checked attribute
+      # based on the reader value.
+      # It also provides an API to assist in generating checkable html (e.g. checkable labels)
+      # and create collections of checkable controls from an enumerable variable.
+      module Checkable
+        include Formular::Element::Module
+        include Collection
+        include Label
+
+        add_option_keys :control_label_options
+
+        set_default :checked, 'checked', if: :is_checked?
+
+        html(:checkable_label) do |input|
+          Formular::Element::Label.(input.label_options) do
+            if has_label?
+              concat input.to_html(context: :default)
+              concat " #{input.label_text}"
+            else
+              to_html(context: :default)
+            end
+          end
+        end
+
+        html(:collection) do |input|
+          input.collection.map { |item|
+            item.to_html(context: :checkable_label)
+          }.join('')
+        end
+
+        module InstanceMethods
+          def group_label
+            return '' unless has_group_label?
+            label_options[:content] = label_text
+            builder.checkable_group_label(label_options).to_s
+          end
+
+          def has_group_label?
+            collection.size > 1 && has_label?
+          end
+
+          def collection
+            unless collection?
+              options[:label_options] = options[:control_label_options]
+              return [self]
+            end
+
+            base_options = collection_base_options
+
+            @collection ||= options[:collection].map do |item|
+              opts = base_options.dup
+              opts[:value] = item.send(options[:value_method])
+              opts[:label] = item.send(options[:label_method])
+
+              opts[:id] = if attributes[:id]
+                            "#{attributes[:id]}_#{opts[:value]}"
+                          else
+                            "#{attribute_name || attributes[:name].gsub('[]', '')}_#{opts[:value]}"
+                          end
+
+              self.class.(opts)
+            end
+          end
+
+          def collection?
+            options[:collection]
+          end
+
+          private
+
+          # we can't access other defaults
+          def is_checked?
+            !options[:checked].nil? || reader_value == attributes[:value]
+          end
+
+          def collection_base_options
+            opts = attributes.select { |k, v| ![:name, :id, :checked, :class].include?(k) } #FIXME due to class merging, we'll end up with duplicate classes...
+            opts[:attribute_name] = attribute_name if attribute_name
+            opts[:builder]        = builder if builder
+            opts[:label_options]  = options[:control_label_options] if options[:control_label_options]
+            opts[:name]           = attributes[:name] if attributes[:name]
+
+            opts
+          end
+        end
+      end
+    end # module Modules
+  end # class Element
+end # module Formular