bulma-phlex-rails 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ccde325abe028d8ab12fb8dfbcd754814274554029fffe1c443c21d0936c6e1
-  data.tar.gz: 0e526e0539626fa8b17780e9ce1db8edc2d81b68c4808fa0fcb108dad44e1944
+  metadata.gz: 44794453fc2f23bad30359fbe4c2334a3f01f492e883d149752eb7855d22926e
+  data.tar.gz: 63fafad11cdb41bb3c26e768bb9042faea483befb1802c0741b9c054cd9262a9
 SHA512:
-  metadata.gz: fca248f599cd3f0793a37864c791e451b8e9019639e093dea13b27dc5a5443dc21b85959201f14763a896edf8f094c22907fd45854b74c6302dce3f5712430e0
-  data.tar.gz: 0e7e6196221edf59fb6c1303d4ef0e74d30522dfbb37e9c7c2ff8a15f3e90f33a6c3f65c142776ce1f9a53d155ab8e6860c909335bafe9ccd464e25c11b3d64e
+  metadata.gz: 88e3734a644ae73ccde892ddbae655a6e3f5e18ae1d3ec5ed951822d4ec3a1c4bd903f0f315e8811860929d4e473894e4dfd536da4c39b12bad59230459036d4
+  data.tar.gz: f36bcded467eacbc374f08b75a8033aa0e9089de882f2363c9d51f547803b7b9586478ddbdb2377ec4bb2f3091b967a6bd901f18a184b85cdeae3d170268b0d4

data/lib/bulma_phlex/rails/components/checkbox.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module BulmaPhlex
+  module Rails
+    # # Checkbox Component
+    #
+    # This component renders a Bulma-styled checkbox within a form. It integrates with Rails' form builder
+    # to ensure proper labeling and value handling.
+    #
+    # The label can be generated automatically based on the attribute name or customized using a block.
+    #
+    # Example usage:
+    #
+    # ```ruby
+    # form_with model: @user do |f|
+    #   f.checkbox :subscribe_newsletter
+    #   f.checkbox :terms_of_service do
+    #     span { "I agree to " }
+    #     a(href: "/terms") { "the terms and conditions" }
+    #   end
+    # end
+    # ```
+    class Checkbox < BulmaPhlex::Base
+      def initialize(form_builder, method, options, delivered, label_block)
+        @form_builder = form_builder
+        @method = method
+        @options = options.dup
+        @delivered = delivered
+        @label_block = label_block
+
+        @options[:class] = Array.wrap(@options[:class]) << "mr-2"
+        @form_field_options = @options.extract!(:column, :grid)
+                                      .with_defaults(column: @form_builder.columns_flag,
+                                                     grid: @form_builder.grid_flag)
+      end
+
+      def view_template
+        render FormField.new(**@form_field_options) do |f|
+          f.control do
+            @form_builder.label(@method, nil, class: "checkbox", skip_label_class: true) do |label_builder|
+              raw @delivered.call(@options)
+              render_label(label_builder)
+            end
+          end
+        end
+      end
+
+      private
+
+      def render_label(label_builder)
+        output = @label_block ? @label_block.call(label_builder) : label_builder.to_s
+
+        # ActiveSupport::SafeBuffer is html safe, strings are not
+        if output.html_safe?
+          raw output
+        else
+          plain output
+        end
+      end
+    end
+  end
+end

data/lib/bulma_phlex/rails/form_builder.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module BulmaPhlex
+  module Rails
+    # # Form Builder
+    #
+    # This form builder wraps inputs with [Bulma Form Fields](https://bulma.io/documentation/form/general/#form-field).
+    #
+    # In addition to standard input options, it supports the following Bulma-specific options:
+    # - `suppress_label`: If true, the label will not be rendered.
+    # - `icon_left`: If set, the specified icon will be rendered on the left side of the input.
+    # - `icon_right`: If set, the specified icon will be rendered on the right side of the input.
+    # - `column`: If true, the input will be wrapped in a Bulma column (only within a `columns` block).
+    # - `grid`: If true, the input will be wrapped in a Bulma grid cell (only within a `grid` block).
+    class FormBuilder < ActionView::Helpers::FormBuilder
+      attr_reader :columns_flag, :grid_flag
+
+      def text_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def password_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def color_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def search_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def telephone_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def phone_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def date_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def time_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def datetime_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def datetime_local_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def month_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def week_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def url_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def email_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def number_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+      def range_field(method, options = {}) = wrap_field(method, options) { |m, opts| super(m, opts) }
+
+      def textarea(method, options = {})
+        wrap_field(method, options, add_class: "textarea") do |m, opts|
+          super(m, opts)
+        end
+      end
+      alias text_area textarea
+
+      def checkbox(method, options = {}, checked_value = "1", unchecked_value = "0", &label_block)
+        delivered = ->(opts) { super(method, opts, checked_value, unchecked_value) }
+        Checkbox.new(self, method, options, delivered, label_block).render_in(@template)
+      end
+      alias check_box checkbox
+
+      # Override label to add Bulma's `label` class by default. Add `:skip_label_class` option
+      # to skip adding the class.
+      def label(method, text = nil, options = {}, &)
+        skip_label_class = options.delete(:skip_label_class)
+        options[:class] = Array.wrap(options[:class]) << :label unless skip_label_class
+        super
+      end
+
+      def select(method, choices = nil, options = {}, html_options = {}, &)
+        wrap_select_field(method, html_options) do |m, html_opts|
+          super(m, choices, options, html_opts, &)
+        end
+      end
+
+      # rubocop:disable Metrics/ParameterLists
+      def collection_select(method, collection, value_method, text_method, options = {}, html_options = {})
+        wrap_select_field(method, html_options) do |m, html_opts|
+          super(m, collection, value_method, text_method, options, html_opts)
+        end
+      end
+      # rubocop:enable Metrics/ParameterLists
+
+      def submit(value = nil, options = {})
+        options = options.dup
+        options[:class] = Array.wrap(options[:class]) << :button
+
+        FormField.new do |field|
+          field.control { super(value, options) }
+        end.render_in(@template)
+      end
+
+      # Fields declared in a column block will be wrapped in a Bulma column and carry
+      # the `column` class by default (fields can use the `column` option to set sizes).
+      def columns(min_breakpoint = nil, &)
+        @columns_flag = true
+        columns = @template.capture(&)
+        @columns_flag = false
+
+        @template.content_tag(:div, class: [:columns, min_breakpoint]) do
+          @template.concat(columns)
+        end
+      end
+
+      # Fields declared in a fixed_grid block will be wrapped in a Bulma fixed grid and
+      # carry the `grid` class by default (fields can use the `grid` option to set sizes).
+      def fixed_grid(&)
+        # TODO: Use BulmaPhlex::FixedGrid for more options
+        @template.content_tag(:div, class: "fixed-grid") do
+          grid(&)
+        end
+      end
+
+      # Fields declared in a grid block will be wrapped in a Bulma fixed grid and carry
+      # the `grid` class by default (fields can use the `grid` option to set sizes).
+      def grid(&)
+        @grid_flag = true
+        cells = @template.capture(&)
+        @grid_flag = false
+
+        # TODO: Use BulmaPhlex::Grid for more options
+        @template.content_tag(:div, class: "grid") do
+          @template.concat(cells)
+        end
+      end
+
+      private
+
+      def wrap_field(method, options, add_class: "input", &delivered)
+        options = options.dup
+        options[:class] = Array.wrap(options[:class]) << add_class if add_class
+
+        form_field_options = options.extract!(:help, :icon_left, :icon_right, :column, :grid)
+                                    .with_defaults(column: @columns_flag, grid: @grid_flag)
+
+        form_field = FormField.new(**form_field_options) do |f|
+          f.label { label(method).html_safe } unless options.delete(:suppress_label)
+          f.control { delivered.call(method, options) }
+        end
+
+        form_field.render_in(@template)
+      end
+
+      def wrap_select_field(method, html_options, &delivered)
+        wrap_field(method, html_options, add_class: false) do |m, html_opts|
+          @template.content_tag(:div, class: "select") do
+            delivered.call(m, html_opts)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bulma_phlex/rails/version.rb

@@ -2,6 +2,6 @@
 
 module BulmaPhlex
   module Rails
-    VERSION = "0.2.1"
+    VERSION = "0.4.0"
   end
 end

data/lib/bulma_phlex/rails.rb

@@ -14,6 +14,7 @@ end
 loader = Zeitwerk::Loader.for_gem_extension(BulmaPhlex)
 loader.collapse("#{__dir__}/rails/components")
 loader.collapse("#{__dir__}/rails/helpers")
+loader.collapse("#{__dir__}/rails/models")
 loader.setup
 
 require "bulma_phlex/rails/engine"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: bulma-phlex-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Todd Kummer
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.9.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.9.0
 - !ruby/object:Gem::Dependency
   name: phlex-rails
   requirement: !ruby/object:Gem::Requirement
@@ -80,7 +80,9 @@ files:
 - config/importmap.rb
 - lib/bulma-phlex-rails.rb
 - lib/bulma_phlex/rails.rb
+- lib/bulma_phlex/rails/components/checkbox.rb
 - lib/bulma_phlex/rails/engine.rb
+- lib/bulma_phlex/rails/form_builder.rb
 - lib/bulma_phlex/rails/helpers/card_helper.rb
 - lib/bulma_phlex/rails/helpers/table_helper.rb
 - lib/bulma_phlex/rails/version.rb