Padrino

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

comments powered by Disqus