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.

Samples

Single Option

1.9ms 1368 allocs
View Source
<%= render 'shared/fields/options', form: form, method: :option_value %>

Multiple Option

2.1ms 1541 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