diff options
author | Xavier Noria <fxn@hashref.com> | 2009-03-17 20:53:03 +0100 |
---|---|---|
committer | Xavier Noria <fxn@hashref.com> | 2009-03-17 20:53:03 +0100 |
commit | 485cd69a7b9384a5eb5af1d49945a8bce6286159 (patch) | |
tree | 05c2aeec921bf1291e26ca5c2fed7ded64cdab75 | |
parent | 168e3958df38b7f6738d60f2510a2e6d1ebcc9fb (diff) | |
download | rails-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.textile | 2 |
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 |