[ANN] CssFormBuilder Plugin 0.2

SimoSAddsw · September 27, 2006, 3:02pm

Hi,
since it’s the first time in this list, I’m announcing release 0.2 of
CssFormBuilder.
Any suggestion about the plugin are welcomed.

Regards
Simo
Addsw.it

CssFormBuilder

A little plugin containing a form builder that uses css to produce
tableless, lined-up forms.

Features:

Each field label is automatically added at the top of the input
control.
Each input control appears at the right of the last control (unless
there is not enough space).
To force a control in a new row, use
before adding it.
Use html option {:class=>‘half-size’ } or {:class=>‘double-size’ }
for changing control size.
Use class ‘half-size’, ‘normal-size’ or ‘double-size’ to force select
tags size.
Use <% fieldset tag ‘legend’ %> [block] <% end %> to produce fieldset
tags.
By default, a fieldset expands to the right form margin; use html
option {:class=>‘continue’} to compact the fieldset. Next fieldset
will be added to the right.
Support translation of labels and legends using _() function (by
first calling CssBuilder.translate_as_gettext) or String.t method
(by first calling CssBuilder.translate_as_globalize)
Support both standard html form (css_form_for) and remote form
(remote_css_form_for)
Also contains a show builder (css_show_for) that produces output that
looks like new/edit forms, using the same template file (_form.rhtml).
Fields values are displayed as html text, without form and input
objects.

Sample usage:

File app/views/customers/_form.rhtml:

<%= error_messages_for ‘customer’ %>

<% fieldset_tag ‘General data’ do %>
<%= @f.text_field :code, :class=>‘half-size’ %>
<%= @f.text_field :name, :class=>‘double-size’ %>

<%= @f.select(:bank_id, Bank.to_select, {:include_blank => true},
{:class=>‘normal-size’} ) %>
<%= @f.check_box :option1 %>
<%= @f.hidden_field :field1 %>
<% end %>

File app/views/customers/new.rhtml:

<% css_form_for :customer, @customer, :url => { :action => “create” }
do |@f| %>
<%= render :partial => ‘form’ %>
<%= submit_tag ‘Create’ %>
<% end %>

File app/views/customers/edit.rhtml:

<% css_form_for :customer, @customer, :url => { :action => ‘update’,
:id => @customer } do |@f| %>
<%= render :partial=> ‘form’ %>
<%= submit_tag ‘Edit’ %>
<% end %>

File app/views/customers/show.rhtml:

<% css_show_for :customer, @customer, do |@f| %>
<%= render :partial=> ‘form’ %>
<% end %>

== Installation

Automatically, with
script/plugin install
svn://rubyforge.org/var/svn/cssformbuilder/trunk
Manually, by downloading archive from
http://rubyforge.org/projects/cssformbuilder/ and unpacking it into your
vendor/plugins folder

After installation:

copy vendor/plugins/cssformbuilder/stylesheet/css_form.css into your
public/stylesheets/ folder.
include css_form.css in your template (<%= stylesheet_link_tag
‘css_form’ %>)

== Licence

MIT

For info about this plugin, write to: gal [at] addsw . it