Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

More documentation #1148 [Alisdair McDiarmid]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@1226 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
  • Loading branch information...
commit 0dd497853a5375caa217237e067346ad2b3d89c2 1 parent 7881e4d
@dhh dhh authored
View
2  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
View
30 actionpack/lib/action_view/helpers/form_options_helper.rb
@@ -10,21 +10,47 @@ module Helpers
# 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
Please sign in to comment.
Something went wrong with that request. Please try again.