Provides a number of methods for creating form tags that doesn’t rely on conventions with an object assigned to the template like FormHelper does. With the FormTagHelper, you provide the names and values yourself.

NOTE: The html options disabled, readonly, and multiple can all be treated as booleans. So specifying :disabled => true will give disabled="disabled".

Methods
Public Instance methods
check_box_tag(name, value = "1", checked = false, options = {})

Creates a check box.

     # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 105
105:       def check_box_tag(name, value = "1", checked = false, options = {})
106:         html_options = { "type" => "checkbox", "name" => name, "id" => name, "value" => value }.update(options.stringify_keys)
107:         html_options["checked"] = "checked" if checked
108:         tag :input, html_options
109:       end
end_form_tag()

Outputs "</form>"

    # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 28
28:       def end_form_tag
29:         "</form>"
30:       end
file_field_tag(name, options = {})

Creates a file upload field.

If you are using file uploads then you will also need to set the multipart option for the form:

  <%= form_tag { :action => "post" }, { :multipart => true } %>
    <label for="file">File to Upload</label> <%= file_field_tag "file" %>
    <%= submit_tag %>
  <%= end_form_tag %>

The specified URL will then be passed a File object containing the selected file, or if the field was left blank, a StringIO object.

    # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 77
77:       def file_field_tag(name, options = {})
78:         text_field_tag(name, nil, options.update("type" => "file"))
79:       end
form_tag(url_for_options = {}, options = {}, *parameters_for_url, &proc)

Starts a form tag that points the action to an url configured with url_for_options just like ActionController::Base#url_for. The method for the form defaults to POST.

Options:

  • :multipart - If set to true, the enctype is set to "multipart/form-data".
  • :method - The method to use when submitting the form, usually either "get" or "post".
This method is also aliased as start_form_tag
    # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 18
18:       def form_tag(url_for_options = {}, options = {}, *parameters_for_url, &proc)
19:         html_options = { "method" => "post" }.merge(options.stringify_keys)
20:         html_options["enctype"] = "multipart/form-data" if html_options.delete("multipart")
21:         html_options["action"] = url_for(url_for_options, *parameters_for_url)
22:         tag :form, html_options, true
23:       end
hidden_field_tag(name, value = nil, options = {})

Creates a hidden field.

Takes the same options as text_field_tag

    # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 63
63:       def hidden_field_tag(name, value = nil, options = {})
64:         text_field_tag(name, value, options.stringify_keys.update("type" => "hidden"))
65:       end
image_submit_tag(source, options = {})

Displays an image which when clicked will submit the form.

source is passed to AssetTagHelper#image_path

     # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 133
133:       def image_submit_tag(source, options = {})
134:         tag :input, { "type" => "image", "src" => image_path(source) }.update(options.stringify_keys)
135:       end
password_field_tag(name = "password", value = nil, options = {})

Creates a password field.

Takes the same options as text_field_tag

    # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 84
84:       def password_field_tag(name = "password", value = nil, options = {})
85:         text_field_tag(name, value, options.update("type" => "password"))
86:       end
radio_button_tag(name, value, checked = false, options = {})

Creates a radio button.

     # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 112
112:       def radio_button_tag(name, value, checked = false, options = {})
113:         html_options = { "type" => "radio", "name" => name, "id" => name, "value" => value }.update(options.stringify_keys)
114:         html_options["checked"] = "checked" if checked
115:         tag :input, html_options
116:       end
select_tag(name, option_tags = nil, options = {})

Creates a dropdown selection box, or if the :multiple option is set to true, a multiple choice selection box.

Helpers::FormOptions can be used to create common select boxes such as countries, time zones, or associated records.

option_tags is a string containing the option tags for the select box:

  # Outputs <select id="people" name="people"><option>David</option></select>
  select_tag "people", "<option>David</option>"

Options:

  • :multiple - If set to true the selection will allow multiple choices.
    # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 44
44:       def select_tag(name, option_tags = nil, options = {})
45:         content_tag :select, option_tags, { "name" => name, "id" => name }.update(options.stringify_keys)
46:       end
start_form_tag(url_for_options = {}, options = {}, *parameters_for_url, &proc)

Alias for form_tag

submit_tag(value = "Save changes", options = {})

Creates a submit button with the text value as the caption. If options contains a pair with the key of "disable_with", then the value will be used to rename a disabled version of the submit button.

     # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 120
120:       def submit_tag(value = "Save changes", options = {})
121:         options.stringify_keys!
122:         
123:         if disable_with = options.delete("disable_with")
124:           options["onclick"] = "this.disabled=true;this.value='#{disable_with}';this.form.submit();#{options["onclick"]}"
125:         end
126:           
127:         tag :input, { "type" => "submit", "name" => "commit", "value" => value }.update(options.stringify_keys)
128:       end
text_area_tag(name, content = nil, options = {})

Creates a text input area.

Options:

  • :size - A string specifying the dimensions of the textarea.
      # Outputs <textarea name="body" id="body" cols="25" rows="10"></textarea>
      <%= text_area_tag "body", nil, :size => "25x10" %>
    
     # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 94
 94:       def text_area_tag(name, content = nil, options = {})
 95:         options.stringify_keys!
 96: 
 97:         if size = options.delete("size")
 98:           options["cols"], options["rows"] = size.split("x")
 99:         end
100: 
101:         content_tag :textarea, content, { "name" => name, "id" => name }.update(options.stringify_keys)
102:       end
text_field_tag(name, value = nil, options = {})

Creates a standard text field.

Options:

  • :disabled - If set to true, the user will not be able to use this input.
  • :size - The number of visible characters that will fit in the input.
  • :maxlength - The maximum number of characters that the browser will allow the user to enter.

A hash of standard HTML options for the tag.

    # File vendor/rails/actionpack/lib/action_view/helpers/form_tag_helper.rb, line 56
56:       def text_field_tag(name, value = nil, options = {})
57:         tag :input, { "type" => "text", "name" => name, "id" => name, "value" => value }.update(options.stringify_keys)
58:       end