Formtastic form builder to generate Twitter Bootstrap-friendly markup.
The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:
You can follow FormBoot on twitter for update announcements and other relevant info.
This version of Formtastic Bootstrap should support the following:
Install the gem with
gem install formtastic-bootstrap
Or add it to your Gemfile:
And install it with bundle install.
Add the following line to your Formtastic initialization file:
# config/initializers/formtastic.rb Formtastic::Helpers::FormHelper.builder = FormtasticBootstrap::FormBuilder
Add the following line to the top of your application.css file:
# app/assets/stylesheets/application.css *= require formtastic-bootstrap
Make sure you've already downloaded and installed Formtastic! Do not however require formtastic in your
application.cssfile or you will have many bootstrap/formtastic-bootstrap styles overwritten.
THIS SECTION IS OUT OF DATE.
In general, Formtastic creates very verbose HTML whereas Bootstrap expects (ever) simpler HTML. Every attempt has been made to generate the HTML expected by Bootstrap while still generating the rich HTML provided by Formtastic. When there is a conflict, Bootstrap wins.
THIS SECTION IS OUT OF DATE
Bootstrap is somewhat incomplete, and in a few cases an inference needed to be drawn to determine a course of action. If you disagree with any of these choices, feel free to let me know.
The gem also provides some "shim" CSS where Bootstrap is missing styles provided Formtastic.
A lot of the code (especially the test suite) was copied over from Formtastic and then beaten into submission. I'm sure you'll find some ugliness in there. In general, I mimicked the Formtastic code structure as much as possible.
Contributions are welcome!
In general, the usage should be identical to Formtastic's. Some changes have been introduced in order to support Bootstrap-specific controls.
To create a Prepended Text field, use the
:prependoption. This works on any text field input type, like
:search, and of course
To create an Appended Text field, use the
:appendoption. This works on any text field input type, like
:search, and of course
To add appended elements that are not contained within an add-on span use the
content_tag(:a, "Click Here", :class => 'btn') %>
A big thank you to all contributors!
If you're filing a bug, thank you! Secondly, in the report please include:
Source contributions are very welcome! Most of the recent work on this package has been done by the community.
Copyright (c) 2013-2015 Matthew Bellantoni. See LICENSE.txt for further details.