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 attributeWhen 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:installThis 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