diff options
author | David Heinemeier Hansson <david@loudthinking.com> | 2005-04-19 10:59:55 +0000 |
---|---|---|
committer | David Heinemeier Hansson <david@loudthinking.com> | 2005-04-19 10:59:55 +0000 |
commit | 0dd497853a5375caa217237e067346ad2b3d89c2 (patch) | |
tree | ddfeb71b4d342133323eed3a8144c71b20963d28 | |
parent | 7881e4dae0176aa0cd65fcbafaaf3828a240c9a6 (diff) | |
download | rails-0dd497853a5375caa217237e067346ad2b3d89c2.tar.gz rails-0dd497853a5375caa217237e067346ad2b3d89c2.tar.bz2 rails-0dd497853a5375caa217237e067346ad2b3d89c2.zip |
More documentation #1148 [Alisdair McDiarmid]
git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@1226 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
-rw-r--r-- | actionpack/CHANGELOG | 2 | ||||
-rw-r--r-- | actionpack/lib/action_view/helpers/form_options_helper.rb | 30 |
2 files changed, 30 insertions, 2 deletions
diff --git a/actionpack/CHANGELOG b/actionpack/CHANGELOG index 1cdf28ee06..7b5614afc5 100644 --- a/actionpack/CHANGELOG +++ b/actionpack/CHANGELOG @@ -1,5 +1,7 @@ *SVN* +* Fixed a problem with Flash.now + * Fixed stringification on all assigned hashes. The sacrifice is that assigns[:person] won't work in testing. Instead assigns["person"] or assigns(:person) must be used. In other words, the keys of assigns stay strings but we've added a method-based accessor to appease the need for symbols. * Fixed that rendering a template would require a connection to the database #1146 diff --git a/actionpack/lib/action_view/helpers/form_options_helper.rb b/actionpack/lib/action_view/helpers/form_options_helper.rb index fe86accf25..dddd7016a8 100644 --- a/actionpack/lib/action_view/helpers/form_options_helper.rb +++ b/actionpack/lib/action_view/helpers/form_options_helper.rb @@ -10,21 +10,47 @@ module ActionView # and <tt>time_zone_select</tt> methods take an <tt>options</tt> parameter, # a hash. # - # * <tt>:include_blank</tt> - set to true if the first option element of the select element is a blank. Useful if there is not a default value required for the select element. + # * <tt>:include_blank</tt> - set to true if the first option element of the select element is a blank. Useful if there is not a default value required for the select element. For example, + # # select("post", "category", Post::CATEGORIES, {:include_blank => true}) # - # Could become: + # could become: # # <select name="post[category]"> # <option></option> # <option>joke</option> # <option>poem</option> # </select> + # + # Another common case is a select tag for an <tt>belongs_to</tt>-associated object. For example, + # + # select("post", "person_id", Person.find_all.collect {|p| [ p.name, p.id ] }) + # + # could become: + # + # <select name="post[person_id]"> + # <option value="1">David</option> + # <option value="2">Sam</option> + # <option value="3">Tobias</option> + # </select> module FormOptionsHelper include ERB::Util # Create a select tag and a series of contained option tags for the provided object and method. # The option currently held by the object will be selected, provided that the object is available. + # See options_for_select for the required format of the choices parameter. + # + # Example with @post.person_id => 1: + # select("post", "person_id", Person.find_all.collect {|p| [ p.name, p.id ] }, { :include_blank => true }) + # + # could become: + # + # <select name="post[person_id"> + # <option></option> + # <option value="1" selected="selected">David</option> + # <option value="2">Sam</option> + # <option value="3">Tobias</option> + # </select> # # This can be used to provide a default set of options in the standard way: before rendering the create form, a # new model instance is assigned the default options and bound to @model_name. Usually this model is not saved |