aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorXavier Noria <fxn@hashref.com>2009-03-17 20:53:03 +0100
committerXavier Noria <fxn@hashref.com>2009-03-17 20:53:03 +0100
commit485cd69a7b9384a5eb5af1d49945a8bce6286159 (patch)
tree05c2aeec921bf1291e26ca5c2fed7ded64cdab75
parent168e3958df38b7f6738d60f2510a2e6d1ebcc9fb (diff)
downloadrails-485cd69a7b9384a5eb5af1d49945a8bce6286159.tar.gz
rails-485cd69a7b9384a5eb5af1d49945a8bce6286159.tar.bz2
rails-485cd69a7b9384a5eb5af1d49945a8bce6286159.zip
be even more ambiguous about the order of generation of hidden input for check boxes in form helper guide
-rw-r--r--railties/guides/source/form_helpers.textile2
1 files changed, 1 insertions, 1 deletions
diff --git a/railties/guides/source/form_helpers.textile b/railties/guides/source/form_helpers.textile
index 9ab4deff4e..22d24b0903 100644
--- a/railties/guides/source/form_helpers.textile
+++ b/railties/guides/source/form_helpers.textile
@@ -683,7 +683,7 @@ This would result in +params[:addresses]+ being an array of hashes with keys +li
There's a restriction, however, while hashes can be nested arbitrarily, only one level of "arrayness" is allowed. Arrays can be usually replaced by hashes, for example instead of having an array of model objects one can have a hash of model objects keyed by their id, an array index or some other parameter.
-WARNING: Array parameters do not play well with the +check_box+ helper. According to the HTML specification unchecked checkboxes submit no value. However it is often convenient for a checkbox to always submit a value. The +check_box+ helper fakes this by creating a second hidden input with the same name. If the checkbox is unchecked only the hidden input is submitted and if it is checked then both are submitted but the value submitted by the checkbox takes precedence. When working with array parameters this duplicate submission will confuse Rails since duplicate input names are how it decides when to start a new array element. It is preferable to either use +check_box_tag+ or to use hashes instead of arrays.
+WARNING: Array parameters do not play well with the +check_box+ helper. According to the HTML specification unchecked checkboxes submit no value. However it is often convenient for a checkbox to always submit a value. The +check_box+ helper fakes this by creating an auxiliary hidden input with the same name. If the checkbox is unchecked only the hidden input is submitted and if it is checked then both are submitted but the value submitted by the checkbox takes precedence. When working with array parameters this duplicate submission will confuse Rails since duplicate input names are how it decides when to start a new array element. It is preferable to either use +check_box_tag+ or to use hashes instead of arrays.
h4. Using Form Helpers