Formtastic 表单构建器,可生成与 Twitter Bootstrap 兼容的标记。
A Formtastic form builder that creates markup suitable for the Twitter Bootstrap framework. In theory, it should just work. Two great tastes in one!
You can follow FormBoot on twitter for update announcements and other relevant info.
This version of Formtastic Bootstrap should support the following:
Bootstrap
Rails
Formtastic
Ruby
Install the gem with
gem install formtastic-bootstrapOr add it to your Gemfile:
gem 'formtastic-bootstrap'And install it with bundle install.
Add the following line to your Formtastic initialization file:
# config/initializers/formtastic.rb
Formtastic::Helpers::FormHelper.builder = FormtasticBootstrap::FormBuilderAdd the following line to the top of your application.css file:
# app/assets/stylesheets/application.css
*= require formtastic-bootstrapMake sure you've already downloaded and installed Formtastic! Do not however require formtastic in your application.css file 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.
In particular:
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 :prepend option. This works on any text field input type, like :url, :search, and of course :string
'@' %>To create an Appended Text field, use the :append option. This works on any text field input type, like :url, :search, and of course :string
'%' %>To add appended elements that are not contained within an add-on span
use the :append_content or :prepend_content option.
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.
暂无开放 Issues,或尚未同步最近议题。