Module | ActionView::Helpers::FormTagHelper |
In: |
lib/action_view/helpers/form_tag_helper.rb
|
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".
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.
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.
Examples:
ERb example:
<% form_tag '/posts' do -%> <div><%= submit_tag 'Save' %></div> <% end -%>
Will output:
<form action="/posts" method="post"><div><input type="submit" name="submit" value="Save" /></div></form>
Options:
If "put", "delete", or another verb is used, a hidden input with name _method is added to simulate the verb over post.
Creates a hidden field.
Takes the same options as text_field_tag
Displays an image which when clicked will submit the form.
source is passed to AssetTagHelper#image_path
Creates a password field.
Takes the same options as text_field_tag
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:
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.
Creates a text input area.
Options:
# Outputs <textarea name="body" id="body" cols="25" rows="10"></textarea> <%= text_area_tag "body", nil, :size => "25x10" %>
Creates a standard text field.
Options:
A hash of standard HTML options for the tag.