ActionValidator is a Rails engine that provides a simple way to perform dynamic client and server side validations for your Rails forms.
It leverages native HTML5 validations by default and will only perform server side validations if the HTML5 validation passes.
Behind the scenes, ActionValidator uses ActionCable to perform the server side validations. Any validations that exist on your model will be automatically validated on the server side, and if there are any errors, they will be returned to the client and displayed in the appropriate form field.
Usage of this gem is very straightforward. There are two helper methods that you can use to render your forms.
This is the same as the standard Rails form_for helper, but it ensures your form uses the ActionValidator::FormBuilder
to build your forms and automatically adds all of the necessary attributes to the form.
If you have your own custom form builder, make sure to inherit from ActionValidator::FormBuilder and set that as
your default builder in your application_controller.rb file.
Also be sure to call super in any form builder methods that you override, otherwise you will not get the necessary
attributes added to your form.
This is the same as the standard Rails form_with helper and provides the same functionality as validator_form_for.
This helper method will render a div with the correct Stimulus data attributes on it so that errors can be displayed on your form.
All of the JavaScript for ActionValidator is shipped with the gem and currently only supports integration when using Importmaps.
Check the dummy app for a working example of how the gem can be used.
Add this line to your application's Gemfile:
gem "action_validator"And then execute:
$ bundleOr install it yourself as:
$ gem install action_validatorContribution directions go here.
The gem is available as open source under the terms of the MIT License.