view_component-form 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 303f19a27ddf8ea02dfcaa077fb20686c5100dda7be4f4338db348de5da11958
-  data.tar.gz: 3c33a63d1d96faa2fb67d32d12b0d90af844099e19157402487ebdc84a17fb5f
+  metadata.gz: 7f547b2b85b760834bd94eeb1e4b4fefbed6d79a0cc666f79e1f01acf53cc9db
+  data.tar.gz: 4e5a9a6eb4cf27b54e0d64af4bc8a232755e45a2c875c9e7f16dbf5b3c4d12d5
 SHA512:
-  metadata.gz: b52a03445c25fffd9f96d84748c5cb0b242b567f1671403578816b384f4b8e64666bdf2f2f645a336708940e0243b7edc8f80915a151294dc82324fc9af776ba
-  data.tar.gz: 2e9f447ac870c23cce962c909123aff114fe92024a98282f79fa329499e4aa42a737246fd59d157e9c6e6f026842090cc6a87296360062f1ef3ea43a260a486f
+  metadata.gz: 93a65ae988497a89ab9eed80e4724860aa8caa0d0fb7301820b9d36ed85b9931062db60e9cd44468412124848fe7cb0b791524deb7806b3d14d9a6ea0c25b17d
+  data.tar.gz: c944cf76b14524c771773b4bc9872bc1d922753a3783917be7b9f8aae7cb527ff1f98b61f28082535d9bc64f49bb019ecc9d9dee4b442c28f186773372fbd7ac

data/CHANGELOG.md

@@ -5,6 +5,33 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+Nothing yet
+
+## [0.4.0] - 2026-11-11
+### Added
+- Support for plain Ruby objects not implementing ActiveModel::Validations (#190)
+- Forward keyword arguments in `render_component` to the component (#238)
+- Support for Ruby 4.0
+### Changed
+- Make rich_textarea accept block (#231)
+- `form_with` test helper names the form after the object's model, falling back to `:user` (#165)
+### Fixed
+- Prevent eager loading `test_helpers.rb` from altering `ActionController::Live` behavior (#243)
+- Handle `false` form object in `FieldComponent` (#233)
+- Fix `TestView` test helper with ActionText on Rails 8.2 (#234)
+- Fix `select` with a block (#236)
+- Render the `label` block argument as its translation, like Rails (#240)
+### Removed
+- Drop Ruby 3.2 support (EOL)
+- Drop Rails 7.2 support (EOL)
+- Drop Rails 8.0 support (EOL)
+- Drop view_component 3 (incompatible with Rails 8.1+)
+
+## [0.3.1] - 2026-08-07
+### Fixed
+- Detect required association validators for `_id` and `_ids` fields (#229)
+### Changed
+- Remove upper bound for Rails dependencies (#206)
 
 ## [0.3.0] - 2025-10-24
 ### Added
@@ -145,7 +172,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add CHANGELOG (#50)
 - Add CI (#2)
 
-[Unreleased]: https://github.com/pantographe/view_component-form/compare/v0.2.11...HEAD
+[Unreleased]: https://github.com/pantographe/view_component-form/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/pantographe/view_component-form/compare/v0.3.1...v0.4.0
+[0.3.1]: https://github.com/pantographe/view_component-form/compare/v0.3.0...v0.3.1
+[0.3.0]: https://github.com/pantographe/view_component-form/compare/v0.2.11...v0.3.0
 [0.2.11]: https://github.com/pantographe/view_component-form/compare/v0.2.10...v0.2.11
 [0.2.10]: https://github.com/pantographe/view_component-form/compare/v0.2.9...v0.2.10
 [0.2.9]: https://github.com/pantographe/view_component-form/compare/v0.2.8...v0.2.9

data/README.md

@@ -13,8 +13,8 @@ Development of this gem is sponsored by:
 
 This gem is tested on:
 
-- Rails 7.2+ (with or without ActionText)
-- Ruby 3.2+
+- Rails 8.1+ (with or without ActionText)
+- Ruby 3.3+
 
 ## Installation
 
@@ -168,6 +168,28 @@ class Form::YearFieldComponent < ViewComponent::Form::FieldComponent # or ViewCo
 end
 ```
 
+`render_component` also passes keyword arguments on to your component:
+
+```rb
+# app/helpers/form_builder.rb
+class FormBuilder < ViewComponent::Form::Builder
+  def badge(method, label:, **options)
+    render_component(:badge, @object_name, method, label:, **objectify_options(options))
+  end
+end
+```
+
+```rb
+# app/components/form/badge_component.rb
+class Form::BadgeComponent < ViewComponent::Form::FieldComponent
+  def initialize(form, object_name, method_name, label:, **options)
+    @label = label
+
+    super(form, object_name, method_name, options)
+  end
+end
+```
+
 When inheriting from `ViewComponent::Form::FieldComponent`, you get access to the following helpers:
 
 #### `#label_text`
@@ -352,6 +374,34 @@ You'll most likely want to use either:
 
 [`fields_for`](https://api.rubyonrails.org/v6.1.4/classes/ActionView/Helpers/FormHelper.html#method-i-fields_for) may also be of interest. To make consistent use of `view_component-form`, you'll want to be using these three helpers to build your forms wherever possible.
 
+### Using a plain Ruby object as model
+
+The form object doesn't have to implement the ActiveModel API: a plain Ruby object works too. It has no errors or validators, so its fields are never shown with errors nor marked as required.
+
+As Rails can't infer the param key and the route from such an object, pass `scope:` and `url:` to `form_with`.
+
+```rb
+# app/models/post.rb
+class Post
+  attr_accessor :title, :body
+
+  def initialize(title:, body:)
+    @title = title
+    @body = body
+  end
+end
+```
+
+```erb
+<%# app/views/posts/_form.html.erb %>
+<%= form_with model: @post, scope: :post, url: posts_path, builder: ViewComponent::Form::Builder do |f| %>
+  <%= f.label :title %>
+  <%= f.text_field :title %>
+  <%= f.label :body %>
+  <%= f.text_field :body %>
+<% end %>
+```
+
 ## Supported helpers
 
 The following helpers are currently supported by `ViewComponent::Form`.
@@ -411,6 +461,38 @@ end
 
 For more complex components, we recommend the [`rspec-html-matchers` gem](https://github.com/kucaahbe/rspec-html-matchers).
 
+### Minitest
+
+#### Configuration
+
+```rb
+# test/test_helper.rb
+require "view_component/test_case"
+require "view_component/form/test_helpers"
+
+ViewComponent::TestCase.include(ViewComponent::Form::TestHelpers)
+```
+
+#### Example
+
+```rb
+# test/components/form/text_field_component_test.rb
+class Form::TextFieldComponentTest < ViewComponent::TestCase
+  test "renders a text field" do
+    object = User.new # replace with a model of your choice
+    form = form_with(object)
+
+    render_inline(Form::TextFieldComponent.new(form, object_name, :first_name, {}))
+
+    assert_selector "input[type=text][name='user[first_name]'][id='user_first_name']"
+  end
+end
+```
+
+### Object name
+
+`form_with` names the form after the object's model (e.g. `user` for a `User`), like Rails' `form_with(model:)`. For objects that aren't models, it falls back to `object_name`, which returns `:user`. With another model than `User`, pass `form.object_name` to your components instead of `object_name`.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/app/components/view_component/form/base_component.rb

@@ -22,13 +22,13 @@ module ViewComponent
       end
 
       def object_errors?
-        return false unless object
+        return false unless object.respond_to?(:errors)
 
         object.errors.any?
       end
 
       def object_errors
-        return nil unless object
+        return nil unless object.respond_to?(:errors)
 
         object.errors
       end

data/app/components/view_component/form/field_component.rb

@@ -39,6 +39,8 @@ module ViewComponent
       end
 
       def value
+        return unless object
+
         object.public_send(method_name)
       end
 
@@ -63,13 +65,13 @@ module ViewComponent
       end
 
       def optional?(context: validation_context)
-        return false if object.nil?
+        return false unless object
 
         !required?(context: context)
       end
 
       def required?(context: validation_context)
-        return false if object.nil?
+        return false unless object
 
         validators(context: context).any?(ActiveModel::Validations::PresenceValidator)
       end
@@ -95,10 +97,10 @@ module ViewComponent
       end
 
       def method_validators
-        @method_validators ||= if object.nil?
-                                 []
+        @method_validators ||= if object.class.respond_to?(:validators_on)
+                                 object.class.validators_on(*object_method_names)
                                else
-                                 object.class.validators_on(method_name)
+                                 []
                                end
       end
     end

data/app/components/view_component/form/label_component.rb

@@ -37,6 +37,11 @@ module ViewComponent
         end
       end
       delegate :translation, to: :builder
+
+      # The component is the block argument, so make it render like Rails' LabelBuilder
+      def to_s
+        translation
+      end
     end
   end
 end

data/app/components/view_component/form/rich_text_area_component.rb

@@ -3,8 +3,13 @@
 module ViewComponent
   module Form
     class RichTextAreaComponent < FieldComponent
-      if defined?(ActionView::Helpers::Tags::ActionText) # rubocop:disable Style/IfUnlessModifier
-        self.tag_klass = ActionView::Helpers::Tags::ActionText
+      if defined?(ActionView::Helpers::Tags::ActionText)
+        def call
+          options[:value] = content if content
+
+          ActionView::Helpers::Tags::ActionText.new(object_name, method_name, @view_context, options)
+                                               .render
+        end
       end
     end
   end

data/app/components/view_component/form/select_component.rb

@@ -15,6 +15,9 @@ module ViewComponent
       end
 
       def call
+        # Tags::Select uses its block (if any) as option tags, in place of choices
+        options_block = proc { content } if content
+
         ActionView::Helpers::Tags::Select.new(
           object_name,
           method_name,
@@ -22,7 +25,7 @@ module ViewComponent
           choices,
           options,
           html_options,
-          &content
+          &options_block
         ).render
       end
 

data/lib/view_component/form/builder.rb

@@ -6,10 +6,7 @@ module ViewComponent
       include ViewComponent::Form::Renderer
       include ViewComponent::Form::ValidationContext
       include ViewComponent::Form::Helpers::Rails
-
-      if Gem::Version.new(::Rails::VERSION::STRING) >= Gem::Version.new("8.0")
-        include ViewComponent::Form::Helpers::Rails8
-      end
+      include ViewComponent::Form::Helpers::Rails8
       include ViewComponent::Form::Helpers::Custom
     end
   end

data/lib/view_component/form/helpers/rails.rb

@@ -3,9 +3,9 @@
 module ViewComponent
   module Form
     module Helpers
-      # rubocop:disable Metrics/ModuleLength
+      # rubocop:disable-next Metrics/ModuleLength
       module Rails
-        # rubocop:disable Metrics/MethodLength
+        # rubocop:disable-next Metrics/MethodLength
         def self.included(base)
           base.class_eval do # rubocop:disable Metrics/BlockLength
             (field_helpers - %i[
@@ -38,7 +38,6 @@ module ViewComponent
             alias_method :phone_field, :telephone_field
           end
         end
-        # rubocop:enable Metrics/MethodLength
 
         def text_area(method, options = {})
           render_component(:text_area, @object_name, method, objectify_options(options))
@@ -172,7 +171,6 @@ module ViewComponent
           end
         end
       end
-      # rubocop:enable Metrics/ModuleLength
     end
   end
 end

data/lib/view_component/form/helpers/rails8.rb

@@ -25,8 +25,8 @@ module ViewComponent
         end
 
         if defined?(ActionView::Helpers::Tags::ActionText)
-          def rich_textarea(method, options = {})
-            render_component(:rich_text_area, @object_name, method, objectify_options(options))
+          def rich_textarea(method, options = {}, &)
+            render_component(:rich_text_area, @object_name, method, objectify_options(options), &)
           end
         end
       end

data/lib/view_component/form/renderer.rb

@@ -7,7 +7,7 @@ module ViewComponent
       class NamespaceAlreadyAddedError < Error; end
       class NotImplementedComponentError < Error; end
 
-      # rubocop:disable Metrics/MethodLength
+      # rubocop:disable-next Metrics/MethodLength
       def self.included(base)
         base.class_eval do
           original_initialize_method = instance_method(:initialize)
@@ -37,12 +37,11 @@ module ViewComponent
           end
         end
       end
-      # rubocop:enable Metrics/MethodLength
 
       private
 
-      def render_component(component_name, *, &)
-        component = component_klass(component_name).new(self, *)
+      def render_component(component_name, *, **, &)
+        component = component_klass(component_name).new(self, *, **)
         component.render_in(@template, &)
       end
 

data/lib/view_component/form/test_helpers.rb

@@ -5,14 +5,20 @@ require "action_controller/test_case"
 require "action_view"
 
 class TestView < ActionView::Base
-  include ActionText::TagHelper if defined?(ActionText)
+  if defined?(ActionText)
+    include ActionText::TagHelper
+    # Rails 8.2+ `rich_textarea_tag` calls `main_app`; requires the Rails app to be initialized
+    include Rails.application.routes.mounted_helpers
+  end
 end
 
-module ViewComponent
+module ViewComponent # rubocop:disable Style/OneClassPerFile
   module Form
     module TestHelpers
       def form_with(object, builder: ViewComponent::Form::Builder, **options)
-        builder.new(object_name, object, template, options)
+        name = object.class.respond_to?(:model_name) ? object.class.model_name.param_key : object_name
+
+        builder.new(name, object, template, options)
       end
 
       def object_name

data/lib/view_component/form/version.rb

@@ -2,6 +2,6 @@
 
 module ViewComponent
   module Form
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

data/lib/view_component/form.rb

@@ -21,6 +21,7 @@ loader = Zeitwerk::Loader.for_gem
 form = "#{__dir__}/form.rb"
 loader.ignore(form)
 loader.push_dir("#{__dir__}/form", namespace: ViewComponent::Form)
+loader.do_not_eager_load("#{__dir__}/form/test_helpers.rb")
 loader.setup
 
 require_relative "form/engine"

metadata

@@ -1,10 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: view_component-form
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Pantographe
+- Hans Lemuet
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -15,47 +16,35 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '8.2'
+        version: 8.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '8.2'
+        version: 8.1.0
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '8.2'
+        version: 8.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '8.2'
+        version: 8.1.0
 - !ruby/object:Gem::Dependency
   name: view_component
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.34.0
+        version: 4.0.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '5.0'
@@ -65,7 +54,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.34.0
+        version: 4.0.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '5.0'
@@ -159,14 +148,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Rails FormBuilder for ViewComponent
 test_files: []