File: README — Documentation for neorails-form

FormFu

FormFu is a Rails plugin that enables you to easily build nice, tableless forms

Maintainer Info

Tyler Crocker NeoRails.com

Looking for *the one* awesome rails developer to add to your project? I may be available to help out. Contact me at [email protected].

Installation

script/plugin install git://github.com/neorails/view_fu.git

# Add this to your environment.rb config.gem ‘neorails-form_fu’, :version => ‘>= 0.1’,

:lib => 'form_fu',
:source => 'http://gems.github.com'

Usage

Create a Basic Form for a Model
<% build_form_for @widget do |f| %>
  <%= f.text_field :name %>
  <%= f.text_area :description %>
  <%= f.submit %>
<% end %>

--------

Create Fields for a Model
<% build_fields_for @address do |a| %>
  <%= a.text_field :street %>
  <%= a.text_field :city %>
  <%= a.select :state, State.to_select %>
<% end %>

--------

Set up a label
<%= f.text_field :name, :label => "Enter Your Name" %>  

--------

Change the separator
<%= f.text_field :name, :separator => "" %>

--------

Take a Block (adds it to the field div)
<% f.text_field :name do %>
  <div class="hint">
    please enter your name...
  </div>
<% end %>

--------

Add options to the field
<%= f.text_field :name, :field => {:class => "left"} %>

--------

Add an Error Messages Summary
<%= f.error_messages %>

--------

Access the originals form_for helpers (prepend _input to names)
<%= f.text_field_input :name %>
outputs only a text_field input tag

Try my other plugins

If you like FormFu, you’ll love ViewFu. It will help you deal with Stylesheets, Javascripts, Page titles, and adds tons of useful view helper methods. github.com/neorails/view_fu