Class: Formtastic::Inputs::CheckBoxesInput

Inherits:
Object
  • Object
show all
Includes:
Base, Base::Choices, Base::Collections
Defined in:
lib/formtastic/inputs/check_boxes_input.rb

Overview

A CheckBoxes input is used to render a series of checkboxes. This is an alternative input choice for ‘has_many` or `has_and_belongs_to_many` associations like a `Post` belonging to many `categories` (by default, a `:select` input is used, allowing multiple selections).

Within the standard ‘<li>` wrapper, the output is a `<fieldset>` with a `<legend>` to represent the “label” for the input, and an `<ol>` containing `<li>`s for each choice in the association. Each `<li>` choice contains a hidden `<input>` tag for the “unchecked” value (like Rails), and a `<label>` containing the checkbox `<input>` and the label text for each choice.

Examples:

Basic example with full form context


<%= semantic_form_for @post do |f| %>
  <%= f.inputs do %>
    <%= f.input :categories, :as => :check_boxes %>
  <% end %>
<% end %>

<li class='check_boxes'>
  <fieldset>
    <legend class="label"><label>Categories</label></legend>
    <ol>
      <li>
        <input type="hidden" name="post[category_ids][1]" value="">
        <label for="post_category_ids_1"><input id="post_category_ids_1" name="post[category_ids][1]" type="checkbox" value="1" /> Ruby</label>
      </li>
      <li>
        <input type="hidden" name="post[category_ids][2]" value="">
        <label for="post_category_ids_2"><input id="post_category_ids_2" name="post[category_ids][2]" type="checkbox" value="2" /> Rails</label>
      </li>
    </ol>
  </fieldset>
</li>

‘:collection` can be used to customize the choices

<%= f.input :categories, :as => :check_boxes, :collection => @categories %>
<%= f.input :categories, :as => :check_boxes, :collection => Category.all %>
<%= f.input :categories, :as => :check_boxes, :collection => Category.some_named_scope %>
<%= f.input :categories, :as => :check_boxes, :collection => [Category.find_by_name("Ruby"), Category.find_by_name("Rails")] %>
<%= f.input :categories, :as => :check_boxes, :collection => ["Ruby", "Rails"] %>
<%= f.input :categories, :as => :check_boxes, :collection => [["Ruby", "ruby"], ["Rails", "rails"]] %>
<%= f.input :categories, :as => :check_boxes, :collection => [["Ruby", "1"], ["Rails", "2"]] %>
<%= f.input :categories, :as => :check_boxes, :collection => [["Ruby", 1], ["Rails", 2]] %>
<%= f.input :categories, :as => :check_boxes, :collection => 1..5 %>

‘:hidden_fields` can be used to skip Rails’ rendering of a hidden field before every checkbox

<%= f.input :categories, :as => :check_boxes, :hidden_fields => false %>

‘:disabled` can be used to disable any checkboxes with a value found in the given Array

<%= f.input :categories, :as => :check_boxes, :collection => ["a", "b"], :disabled => ["a"] %>

‘:label_method` can be used to call a different method (or a Proc) on each object in the collection for rendering the label text (it’ll try the methods like ‘to_s` in `collection_label_methods` config by default)

<%= f.input :categories, :as => :check_boxes, :label_method => :name %>
<%= f.input :categories, :as => :check_boxes, :label_method => :name_with_post_count
<%= f.input :categories, :as => :check_boxes, :label_method => Proc.new { |c| "#{c.name} (#{pluralize("post", c.posts.count)})" }

‘:value_method` can be used to call a different method (or a Proc) on each object in the collection for rendering the value for each checkbox (it’ll try the methods like ‘id` in `collection_value_methods` config by default)

<%= f.input :categories, :as => :check_boxes, :value_method => :code %>
<%= f.input :categories, :as => :check_boxes, :value_method => :isbn
<%= f.input :categories, :as => :check_boxes, :value_method => Proc.new { |c| c.name.downcase.underscore }

‘:value_as_class` can be used to add a class to the `<li>` wrapped around each choice using the checkbox value for custom styling of each choice

<%= f.input :categories, :as => :check_boxes, :value_as_class => true %>

See Also:

Instance Attribute Summary

Attributes included from Base

#builder, #method, #object, #object_name, #options, #template

Instance Method Summary collapse

Methods included from Base::Choices

#choice_html_safe_value, #choice_input_dom_id, #choice_label, #choice_value, #choice_wrapping, #choice_wrapping_html_options, #choices_group_wrapping, #choices_group_wrapping_html_options, #choices_wrapping, #choices_wrapping_html_options, #label_html_options, #legend_html, #value_as_class?

Methods included from Base::Collections

#collection, #collection_for_boolean, #collection_from_association, #collection_from_options, #label_and_value_method, #label_method, #raw_collection, #send_or_call, #value_method

Methods included from Base

#initialize

Methods included from Base::Wrapping

#input_wrapping, #wrapper_dom_id, #wrapper_html_options

Methods included from Base::Labelling

#label_from_options, #label_html, #label_html_options, #label_text, #localized_label, #render_label?, #requirement_text, #requirement_text_or_proc

Methods included from Base::Associations

#association, #association_primary_key, #belongs_to?, #reflection

Methods included from Base::Fileish

#file?

Methods included from Base::Validations

#column_limit, #limit, #not_required_through_negated_validation!, #not_required_through_negated_validation?, #optional?, #required?, #validation_integer_only?, #validation_limit, #validation_max, #validation_min, #validations, #validations?, #validator_relevant?

Methods included from Base::Naming

#as, #attributized_method_name, #humanized_method_name, #sanitized_method_name, #sanitized_object_name

Methods included from Base::Hints

#hint?, #hint_html, #hint_text, #hint_text_from_options

Methods included from Base::Errors

#error_first_html, #error_html, #error_keys, #error_list_html, #error_none_html, #error_sentence_html, #errors, #errors?

Methods included from Base::Database

#column, #column?

Methods included from Base::Options

#formtastic_options, #input_options

Methods included from Base::Html

#dom_id, #dom_index, #input_html_options

Instance Method Details

#check_box_with_hidden_input(choice) ⇒ Object 



116
117
118
119
120
121
122
123
124
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 116

def check_box_with_hidden_input(choice)
  value = choice_value(choice)
  builder.check_box(
    association_primary_key || method, 
    input_html_options.merge(:id => choice_input_dom_id(choice), :name => input_name, :disabled => disabled?(value)), 
    value, 
    unchecked_value
  )
end

#check_box_without_hidden_input(choice) ⇒ Object 



126
127
128
129
130
131
132
133
134
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 126

def check_box_without_hidden_input(choice)
  value = choice_value(choice)
  template.check_box_tag(
    input_name, 
    value, 
    checked?(value), 
    input_html_options.merge(:id => choice_input_dom_id(choice), :disabled => disabled?(value))
  ) 
end

#checked?(value) ⇒ Boolean

Returns:

  • (Boolean) 


136
137
138
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 136

def checked?(value)
  selected_values.include?(value)
end

#choice_html(choice) ⇒ Object 



91
92
93
94
95
96
97
98
99
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 91

def choice_html(choice)        
  template.content_tag(:label,
    hidden_fields? ? 
      check_box_with_hidden_input(choice) : 
      check_box_without_hidden_input(choice) <<
    choice_label(choice),
    label_html_options.merge(:for => choice_input_dom_id(choice))
  )
end

#disabled?(value) ⇒ Boolean

Returns:

  • (Boolean) 


140
141
142
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 140

def disabled?(value)
  disabled_values.include?(value)
end

#disabled_values ⇒ Object 



153
154
155
156
157
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 153

def disabled_values
  vals = options[:disabled] || []
  vals = [vals] unless vals.is_a?(Array)
  vals
end

#hidden_field_for_all ⇒ Object 



101
102
103
104
105
106
107
108
109
110
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 101

def hidden_field_for_all
  if hidden_fields?
    ""
  else
    options = {}
    options[:class] = [method.to_s.singularize, 'default'].join('_') if value_as_class?
    options[:id] = [object_name, method, 'none'].join('_')
    template.hidden_field_tag(input_name, '', options)
  end
end

#hidden_fields? ⇒ Boolean

Returns:

  • (Boolean) 


112
113
114
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 112

def hidden_fields?
  options[:hidden_fields]
end

#input_name ⇒ Object 



163
164
165
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 163

def input_name
  "#{object_name}[#{association_primary_key || method}][]"
end

#selected_values ⇒ Object 



144
145
146
147
148
149
150
151
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 144

def selected_values
  if object.respond_to?(method)
    selected_items = [object.send(method)].compact.flatten
    [*selected_items.map { |o| send_or_call(value_method, o) }].compact
  else
    []
  end
end

#to_html ⇒ Object 



75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 75

def to_html
  input_wrapping do
    choices_wrapping do
      legend_html <<
      hidden_field_for_all <<
      choices_group_wrapping do
        collection.map { |choice| 
          choice_wrapping(choice_wrapping_html_options(choice)) do
            choice_html(choice)
          end
        }.join("\n").html_safe
      end
    end
  end
end

#unchecked_value ⇒ Object 



159
160
161
 
# File 'lib/formtastic/inputs/check_boxes_input.rb', line 159

def unchecked_value
  options[:unchecked_value] || ''
end