plataformatec/simple_form - 0 views
-
The basic goal of Simple Form is to not touch your way of defining the layout
-
by default contains label, hints, errors and the input itself
-
Simple Form acts as a DSL and just maps your input type (retrieved from the column definition in the database) to a specific helper method.
- ...68 more annotations...
-
can overwrite the default label by passing it to the input method
-
configure the html of any of them
-
disable labels, hints or error
-
add a hint, an error, or even a placeholder
-
add an inline label
-
pass any html attribute straight to the input, by using the :input_html option
-
use the :defaults option in simple_form_fo
-
Simple Form generates a wrapper div around your label and input by default, you can pass any html attribute to that wrapper as well using the :wrapper_html option,
-
By default all inputs are required
-
the required property of any input can be overwritten
-
Simple Form will look at the column type in the database and use an appropriate input for the column
-
lets you overwrite the default input type it creates
-
can also render boolean attributes using as: :select to show a dropdown.
-
give the :disabled option to Simple Form, and it'll automatically mark the wrapper as disabled with a CSS class
-
Simple Form accepts same options as their corresponding input type helper in Rails
-
Any extra option passed to these methods will be rendered as html option.
-
use label, hint, input_field, error and full_error helpers
-
to strip away all the div wrappers around the <input> field
-
is to use f.input_field
-
changing boolean_style from default value :nested to :inline
-
overriding the :collection option
-
Collections can be arrays or ranges, and when a :collection is given the :select input will be rendered by default
-
Other types of collection are :radio_buttons and :check_boxes
-
label_method
-
value_method
-
Both of these options also accept lambda/procs
-
define a to_label method on your model as Simple Form will search for and use :to_label as a :label_method first if it is found
-
create grouped collection selects, that will use the html optgroup tags
-
Grouped collection inputs accept the same :label_method and :value_method options
-
group_method
-
group_label_method
-
configured with a default value to be used on the site through the SimpleForm.country_priority and SimpleForm.time_zone_priority helpers.
-
association
-
association
-
render a :select input for choosing the :company, and another :select input with :multiple option for the :roles
-
all options available to :select, :radio_buttons and :check_boxes are also available to association
-
declare different labels and values
-
the association helper is currently only tested with Active Record
-
f.input
-
f.select
-
create a <button> element
-
simple_fields_for
-
Creates a collection of radio inputs with labels associated
-
Creates a collection of checkboxes with labels associated
-
collection_radio_buttons
-
collection_check_boxes
-
associations in your model
-
Role.all
-
the html element you will get for each attribute according to its database definition
-
redefine existing Simple Form inputs by creating a new class with the same name
-
Simple Form uses all power of I18n API to lookup labels, hints, prompts and placeholders
-
specify defaults for all models under the 'defaults' key
-
Simple Form will always look for a default attribute translation under the "defaults" key if no specific is found inside the model key
-
Simple Form will fallback to default human_attribute_name from Rails when no other translation is found for labels.
-
Simple Form will only do the lookup for options if you give a collection composed of symbols only.
-
"Add %{model}"
-
translations for labels, hints and placeholders for a namespaced model, e.g. Admin::User, should be placed under admin_user, not under admin/user
-
This difference exists because Simple Form relies on object_name provided by Rails' FormBuilder to determine the translation path for a given object instead of i18n_key from the object itself.
-
configure how your components will be rendered using the wrappers API
-
optional
-
unless_blank
-
By default, Simple Form will generate input field types and attributes that are supported in HTML5
-
The HTML5 extensions include the new field types such as email, number, search, url, tel, and the new attributes such as required, autofocus, maxlength, min, max, step.
-
If you want to have all other HTML 5 features, such as the new field types, you can disable only the browser validation
-
add novalidate to a specific form by setting the option on the form itself
-
the Simple Form configuration file
-
passing the html5 option
-
as: :date, html5: true
