Project

formal

0.0
No commit activity in last 3 years
No release in over 3 years
Helpful form builder used by Rocketeers
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

>= 0
= 2.14.0.rc1
 Project Readme

Formal

Gem Version Build Status Code Climate

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

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request