Formal
Formal is simply a form builder that provides the markup typically used around form fields on Hashrocket projects.
Installation
Add this line to your application's Gemfile:
gem 'formal'
And then execute:
$ bundle
Or install it yourself as:
$ gem install formal
Usage
Specify the builder option in your form_for
parameters
form_for(obj, builder: Formal::FormBuilder)
Label
Label is created with error messaging within label
element
Example:
= f.label attribute
When obj.attribute
is in an invalid state the markup returned will be like:
<label for='obj_attribute'>Attribute <span class='error'>Error message</span></label>
Rails Default Form Builder
To make formal the default form builder for your application, just run:
rails g formal:install
This removes the need to add the builder: Formal::FormBuilder
option to your
form_for
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request