Checkbox
The Bootstrap checkbox form component, implemented in Ruby. Use it like any of the other matestack form components in your apps, pages and components. It offers customizable options to simply achieve what is possible in bootstrap with this component. See below for more information about the configuration options.

bs_form_checkbox(*args, &block)

Renders one (nil/true/false) or multiple (array of selected values) bootstrap checkbox input fields.
Optional options
  • options - Expects an Array or Hash of selectable options
  • label - Expects a string, gets displayed before the first input field
  • form_text - Expects a string, gets displayed after the last input field
  • disabled - If set to :true, the checkbox input fields are set to disabled and clicking them doesn't yield any effect
  • variant - If set to :inline, the wrapping div is displayed as inline-block instead of the default block

Examples

Example 1: Basic usage with single checkbox field

1
bs_form_checkbox label: "Single checkbox", key: :some_checkbox_input
Copied!
and sends
1
"some_checkbox_input"=>nil # or true, if the input has been clicked or false if the input was clicked again
Copied!
to the corresponding Controller.

Example 2: Basic usage with an Array

1
bs_form_checkbox key: :foo, options: [1, 2]
Copied!

Example 3: Basic usage with a Hash

1
bs_form_checkbox key: :foo, options: { "Option 1": 1, "Option 2": 2 }
Copied!

Example 4: Using a label

1
bs_form_checkbox key: :foo, options: [1, 2], label: "Some label"
Copied!

Example 5: Using a form_text

1
bs_form_checkbox key: :foo, options: [1, 2], form_text: "some notes"
Copied!

Example 6: Using the disabled option

1
bs_form_checkbox key: :foo, options: [1, 2], disabled: true
Copied!

Example 7: Using the :inline variant

1
bs_form_checkbox key: :foo, options: [1, 2], variant: :inline
Copied!
Last modified 4mo ago