check_box
check_box(object, method, options = {}, checked_value = "1", unchecked_value = "0")
public
Returns a checkbox tag tailored for accessing a specified attribute (identified by method) on an object assigned to the template (identified by object). It’s intended that method returns an integer and if that integer is above zero, then the checkbox is checked. Additional options on the input tag can be passed as a hash with options. The checked_value defaults to 1 while the default unchecked_value is set to 0 which is convenient for boolean values. Usually unchecked checkboxes don’t post anything. We work around this problem by adding a hidden value with the same name as the checkbox.
Example (call, result). Imagine that @post.validated? returns 1:
check_box("post", "validated") <input type="checkbox" id="post_validate" name="post[validated]" value="1" checked="checked" /> <input name="post[validated]" type="hidden" value="0" />
Example (call, result). Imagine that @puppy.gooddog returns no:
check_box("puppy", "gooddog", {}, "yes", "no") <input type="checkbox" id="puppy_gooddog" name="puppy[gooddog]" value="yes" /> <input name="puppy[gooddog]" type="hidden" value="no" />
Sending array parameters
Another technique to use when you need to send an array parameter is pass in the :multiple option.
check_box("puppy", "commands", {:multiple => true}, "sit", nil) check_box("puppy", "commands", {:multiple => true}, "fetch", nil) check_box("puppy", "commands", {:multiple => true}, "roll_over", nil)
If all checkboxes are checked, the paramters will be:
"puppy" => {"commands" => ["sit", "fetch", "roll_over"]}
NOTE: because of the gotcha, the hidden fields will be inserted and any unchecked boxes will be sent as “” (empty string). You will need to filter those values out in your model:
class Dog < ActiveRecord::Base def commands=(commands) commands.reject(&:blank?) end end
Have the check_box checked by default
To have the check box checked by default, pass either :checked => true or :checked => 'checked' in the options. See ActionView::Helpers::InstanceTag#to_check_box_tag for details.
Have check_box checked by default
In addition to comment below, you can make a column with default value so in your forms it will be enabled by default and behave correctly with validation errors unlike :checked => true
in your migration
add_column :accounts, :ssl_enabled, :boolean, :default => 1
Use strings as parameters, not booleans
I just stumbled across this somewhere in our codebase. The first example is faulty, the second one is correct.
= f.check_box :public, {}, true, false # <input id="event_public" name="event[public]" type="checkbox" value="true" />
and:
= f.check_box :public, {}, "true", "false" # <input name="event[public]" type="hidden" value="false" /> # <input id="event_public" name="event[public]" type="checkbox" value="true" />
What object_name.method values will result in checked chekboxes.
*It’s intended that method returns an integer and if that integer is above zero, then the checkbox is checked.* - more exactly, that’s how it’s determined whether value will be checked or not:
(`@checked_value` is checked_value, `value` is what object_name.method returns)
def checked?(value) case value when TrueClass, FalseClass value == !!@checked_value when NilClass false when String value == @checked_value else if value.respond_to?(:include?) value.include?(@checked_value) else value.to_i == @checked_value.to_i end end end
Parameter extraction logic changed in Rails 2.3!
What is documented here about Rails parameter extraction always getting the first occurrence of a key is apparently incorrect (in Rails 2.3 it gets the last occurrence).
See the following email thread on [rubyonrails-core]:
http://www.mail-archive.com/rubyonrails-core@googlegroups.com/msg08719.html
I quote:
> In the docs for ActionView::Helpers::FormHelper#check_box, when > discussing why the method adds a hidden input tag _after_ the checkbox > tag, it says > > "...Rails parameters extraction always gets the first occurrence of > any given key..." > > I'm not sure this is still the case. Indeed it changed in 2.3 but unfortunately the patch didn't update the docs. We noticed this a few days ago, they are correct now in edge.