Permalink
Browse files

Documented select, collection_select, and country_select #304 [Ulysses]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@163 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
  • Loading branch information...
dhh committed Dec 15, 2004
1 parent d96e874 commit df28bdd7ab05607a6514d8e77df54eb531027687
Showing with 13 additions and 3 deletions.
  1. +13 −3 actionpack/lib/action_view/helpers/form_options_helper.rb
@@ -8,15 +8,25 @@ module Helpers
# the actual select tag, so you'll need to construct that in HTML manually.
module FormOptionsHelper
include ERB::Util
-
+
+ # Create a select tag and a series of contained option tags for the provided object and method.
+ # The option currenlty held by the object will be selected, provided that the object is available.
+ #
+ # 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
+ # to the database. Instead, a second model object is created when the create request is received.
+ # This allows the user to submit a form page more than once with the expected results of creating multiple records.
+ # In addition, this allows a single partial to be used to generate form inputs for both edit and create forms.
def select(object, method, choices, options = {}, html_options = {})
InstanceTag.new(object, method, self).to_select_tag(choices, options, html_options)
end
-
+
+ # Return select and option tags for the given object and method using options_from_collection_for_select to generate the list of option tags.
def collection_select(object, method, collection, value_method, text_method, options = {}, html_options = {})
InstanceTag.new(object, method, self).to_collection_select_tag(collection, value_method, text_method, options, html_options)
end
-
+
+ # Return select and option tags for the given object and method, using country_options_for_select to generate the list of option tags.
def country_select(object, method, priority_countries = nil, options = {}, html_options = {})
InstanceTag.new(object, method, self).to_country_select_tag(priority_countries, options, html_options)
end

0 comments on commit df28bdd

Please sign in to comment.