Application Helpers

Form Helpers

Form helpers are the 'standard' form tag helpers you would come to expect when building forms. A simple example of constructing a non-object form would be:

# app/views/example.haml
= form_tag '/destroy', :class => 'destroy-form', :method => 'delete' do
  = flash_tag(:notice)
  = field_set_tag do
    %p
      = label_tag :username, :class => 'first'
      = text_field_tag :username, :value => params[:username]
    %p
      = label_tag :password, :class => 'first'
      = password_field_tag :password, :value => params[:password]
    %p
      = label_tag :strategy
      = select_tag :strategy, :options => ['delete', 'destroy'], :selected => 'delete'
    %p
      = check_box_tag :confirm_delete
  = field_set_tag(:class => 'buttons') do
    = submit_tag "Remove"

List of Form Helpers

• form_tag(url, options={}, &block)
  • Constructs a form without object based on options
  • Supports form methods 'put' and 'delete' through hidden field
  • form_tag('/register', :class => 'example') { ... }
• field_set_tag(*args, &block)
  • Constructs a field_set to group fields with given options
  • field_set_tag(:class => 'office-set') { }
  • field_set_tag("Office", :class => 'office-set') { }
• error_messages_for(:record, options={})
  • Constructs list html for the errors for a given object
  • error_messages_for :user
• label_tag(name, options={}, &block)
  • Constructs a label tag from the given options
  • label_tag :username, :class => 'long-label'
  • label_tag(:username, :class => 'blocked-label') { ... }
• hidden_field_tag(name, options={})
  • Constructs a hidden field input from the given options
  • hidden_field_tag :session_key, :value => 'secret'
• text_field_tag(name, options={})
  • Constructs a text field input from the given options
  • text_field_tag :username, :class => 'long'
• text_area_tag(name, options={})
  • Constructs a text area input from the given options
  • text_area_tag :username, :class => 'long'
• password_field_tag(name, options={})
  • Constructs a password field input from the given options
  • password_field_tag :password, :class => 'long'
• number_field_tag(name, options={})
  • Constructs a number field input from the given options
  • number_field_tag :age, :class => 'long'
• telephone_field_tag(name, options={})
  • Constructs a phone field input from the given options
  • telephone_field_tag :mobile, :class => 'long'
• email_field_tag(name, options={})
  • Constructs a email field input from the given options
  • email_field_tag :email, :class => 'long'
• search_field_tag(name, options={})
  • Constructs a search field input from the given options
  • search_field_tag :query, :class => 'long'
• url_field_tag(name, options={})
  • Constructs a url field input from the given options
  • url_field_tag :image_source_url, :class => 'long'
• check_box_tag(name, options={})
  • Constructs a checkbox input from the given options
  • check_box_tag :remember_me, :checked => true
• radio_button_tag(name, options={})
  • Constructs a radio button input from the given options
  • radio_button_tag :gender, :value => 'male'
• select_tag(name, settings={})
  • Constructs a select tag with options from the given settings
  • select_tag(:favorite_color, :options => ['1', '2', '3'], :selected => '1')
  • select_tag(:more_color, :options => [['label', '1'], ['label2', '2']])
  • select_tag(:multiple_color, :options => ['1', '2', '3'], :multiple => true, :selected => ['1', '3'])
• file_field_tag(name, options={})
  • Constructs a file field input from the given options
  • file_field_tag :photo, :class => 'long'
• submit_tag(caption, options={})
  • Constructs a submit button from the given options
  • submit_tag "Create", :class => 'success'
• button_tag(caption, options={})
  • Constructs an input (type => 'button') from the given options
  • button_tag "Cancel", :class => 'clear'
• image_submit_tag(source, options={})
  • Constructs an image submit button from the given options
  • image_submit_tag "submit.png", :class => 'success'

last updated: 2022-02-22