Options
When you're building forms, use Bullet Train's Field Partials for your form fields. They DRY-up all the presentation logic without needing a third-party dependency like Formtastic.
Read much more about them in the extensive developer documentation.
Read much more about them in the extensive developer documentation.
Samples
Single Option
1.9ms
2040 allocs
View Source
<%= render 'shared/fields/options', form: form, method: :option_value %>
Multiple Option
1.6ms
2237 allocs
View Source
<%= render 'shared/fields/options', form: form, method: :multiple_option_values, options: {multiple: true}, show_select_all_top: true %>
Options
| Name | Required | Type | Default | Description |
|---|---|---|---|---|
form |
ActionView::Helpers::FormBuilder |
Reference to the form object |
||
method |
String |
Attribute of the model |
||
options |
Hash |
{} |
Options passed directly to the underlying Rails form field helper. |
|
other_options |
Hash |
{} |
Additional options for things like hiding labels, displaying specific error messages, etc. |
|
other_options[:icon] |
String |
Display an icon. |
||
other_options[:label] |
String |
Display a specific field label. |
||
other_options[:hide_label] |
Boolean |
false |
Hide the field label. |
|
other_options[:help] |
String |
Display a specific help string. |
||
other_options[:error] |
String |
Display a specific error string. |
||
multiple |
Boolean |
false |
Whether to select single or multiple values |
|
show_select_all_top |
Boolean |
false |
Whether to put the select all toggle before the options |
|
show_select_all_bottom |
Boolean |
false |
Whether to put the select all toggle after the options |