-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Home
Welcome to the SimpleForm wiki. Here you will find additional content and documentation
for the SimpleForm project, which complements the project README
and code docs.
Cheers, The SimpleForm/Plataformatec team.
Below there's several guides and tutorials created by the community showcasing customizations and configuration usage for SimpleForm.
- Adding custom components
- Adding custom input components
- Attributes filter
- Contact Form using Mail_Form
- Create a fake input that does NOT read attributes
- Create an "input" just for displaying attribute value
- Create an "input" just for displaying custom content (e.g. a link)
- Creating a minimalist form (no labels just placeholders)
- CSS for simple_form
- Custom inputs examples
- Custom Wrappers
- HTML5 Attributes
- Nested Models
- Simple Form with Devise
- Twitter Bootstrap integration
- Twitter Bootstrap v2 and simple_form v2
- Bootstrap component helpers
- Upgrading to Simple Form 2.0
- Use with ActiveModel compliant models
- Zurb's Foundation integration
If you have any questions about SimpleForm, search the Wiki or use the Mailing List or Stack Overflow. Do not post questions on the project Issue Tracker.
First of all, search through the Issue Tracker to see if your bug hasn't been fixed yet
on the master
branch. If not, do your best to supply a piece of code or a fresh
Rails application that reproduces your error along the error description and the
expected behavior. Bad Issue reports will be closed until they meet these requirements
so the SimpleForm maintainers can work on it.
If you find a security bug, DO NOT submit an issue here. Please send an e-mail to [email protected] instead.
SimpleForm is built on top of Rails FormBuilder, so it should work nicely with any
library that implements the proper ActiveModel API required by ActionPack. But if
you're using an ORM other ActiveRecord than SimpleForm won't be able to discover
the proper input types for the attributes on your model, so you might need to
define them on your own on your forms. For instance, when using Mongoid, you might
need to set options such as :collection
and :as
:
<%= simple_form_for @post do |form| %>
<%= form.input :category, collection: Category.all %>
<%= form.input :contents, as: :text %>
<%= form.input :published, as: :boolean %>
<% end >
If you came from a broken link to this Wiki check the page to see if the page you are looking for is there or see in the Wiki History, what might have happened to it. We are sorry that something might have gone missing or it was moved somewhere else, but help us maintain the necessary content up and running here.
This page was created by the OSS community and might be outdated or incomplete. Feel free to improve or update this content according to the latest versions of SimpleForm and Rails to help the next developer who visits this wiki after you.
Keep in mind to maintain the guides as simple as possible and to avoid additional dependencies that might be specific to your application or workflow (such as Haml, RSpec, Guard and similars).