justinfrench-formtastic 0.1.5 → 0.1.6

data/README.textile

@@ -1,4 +1,4 @@
-h1. Formtastic 0.1.5
+h1. Formtastic
 
 Formtastic is a Rails FormBuilder DSL (with some other goodies) to make it far easier to create beautiful, semantically rich, syntactically awesome, readily stylable and wonderfully accessible HTML forms in your Rails applications.
 
@@ -85,8 +85,7 @@ And then add it as a dependency in your environment.rb file:
 <pre>
   config.gem "justinfrench-formtastic", 
     :lib     => 'formtastic', 
-    :source  => 'http://gems.github.com', 
-    :version => '0.1.5'
+    :source  => 'http://gems.github.com'
 </pre>
 
 If you're a little more old school, install it as a plugin:
@@ -100,7 +99,7 @@ h2. Usage
 
 Forms are really boring to code... you want to get onto the good stuff as fast as possible.
 
-This renders a set of inputs (one for _most_ columns in the database table, and one for each ActiveRecord belongs_to, has_many or has_and_belongs_to_many association) and a submit button:
+This renders a set of inputs (one for _most_ columns in the database table, and one for each ActiveRecord belongs_to association), followed by a submit button:
 
 <pre>
   <% semantic_form_for @user do |form| %>
@@ -135,7 +134,7 @@ If you want control over the input type Formtastic uses for each field, you can
   <% end %>
 </pre>
 
-If you want to customize the label text, or render some hint text below the field, specify which fields are required/option, or break the form into two fieldsets, the DSL is pretty comprehensive:
+If you want to customize the label text, or render some hint text below the field, specify which fields are required/optional, or break the form into two fieldsets, the DSL is pretty comprehensive:
 
 <pre>
   <% semantic_form_for @post do |form| %>
@@ -156,48 +155,30 @@ If you want to customize the label text, or render some hint text below the fiel
   <% end %>
 </pre>
 
-If you want to customize html elements for any non button inputs and the li
-wrapper you just need to specify the :input_html and :wrapper_html options hash.
-
-<pre>
-    <% semantic_form_for @post do |form| %>
-      <%= form.input :title, :input_html => {:size => 60} %>
-      <%= form.input :body, :wrapper_html => { :class => 'body_wrapper' } %>
-      <%= form.input :created_at, :input_html => {:disabled => true} %>
-      <%= form.buttons %>
-    <% end %>
-</pre>
-
-To customize buttons, :button_html is available.
 
 Nested forms (Rails 2.3) are also supported. You can do it in the Rails way:
 
 <pre>
   <% semantic_form_for @post do |form| %>
     <%= form.inputs :title, :body, :created_at %>
-
     <% form.semantic_fields_for :author do |author| %>
       <%= author.inputs :first_name, :last_name, :name => 'Author' %>
     <% end %>
-
     <%= form.buttons %>
   <% end %>
 </pre>
 
-Or in the formtastic way:
+Or the Formtastic way with the @:for@ option:
 
 <pre>
   <% semantic_form_for @post do |form| %>
     <%= form.inputs :title, :body, :created_at %>
-
     <%= form.inputs :first_name, :last_name, :for => :author, :name => "Author" %>
-
     <%= form.buttons %>
   <% end %>
 </pre>
 
-When working in has many association, you can even supply "%i" in your fieldset
-name that it will be properly interpolated with the child index. For example:
+When working in has many association, you can even supply "%i" in your fieldset name that it will be properly interpolated with the child index. For example:
 
 <pre>
   <% semantic_form_for @post do |form| %>
@@ -207,8 +188,41 @@ name that it will be properly interpolated with the child index. For example:
   <% end %>
 </pre>
 
-Each category will be wrapped in a fieldset with legend "Category #1",
-"Category #2" and so on. But please notice that this works only with Rails 2.3.
+
+Customize HTML attributes for any input using the @:input_html@ option.  Typically his is used to disable the input, change the size of a text field, change the rows in a textarea, or even to add a special class to an input to attach special behavior like "autogrow":http://plugins.jquery.com/project/autogrow textareas:
+
+<pre>
+  <% semantic_form_for @post do |form| %>
+    <%= form.input :title,      :input_html => { :size => 60 } %>
+    <%= form.input :body,       :input_html => { :class => 'autogrow' } %>
+    <%= form.input :created_at, :input_html => { :disabled => true } %>
+    <%= form.buttons %>
+  <% end %>
+</pre>
+
+The same can be done for buttons with the @:button_html@ option:
+
+<pre>
+  <% semantic_form_for @post do |form| %>
+    ...
+    <% form.buttons do %>
+      <%= form.commit_button :button_html => { :class => "primary" } %>
+    <% end %>
+  <% end %>
+</pre>
+
+Customize the HTML attributes for the @<li>@ wrapper around every input with the @:wrapper_html@ option hash.  There's one special key in the hash (:class), which will actually _append_ your string of classes to the existing classes provided by Formtastic (like "required string error")
+  
+<pre>
+  <% semantic_form_for @post do |form| %>
+    <%= form.input :title, :wrapper_html => { :class => "important" } %>
+    <%= form.input :body %>
+    <%= form.input :description, :wrapper_html => { :style => "display:none;" } %>
+    ...
+  <% end %>
+</pre>
+
+
 
 h2. The Available Inputs
 

data/generators/formtastic_stylesheets/templates/formtastic.css

@@ -28,6 +28,7 @@ form.formtastic fieldset { }
 form.formtastic fieldset.inputs { }
 form.formtastic fieldset.buttons { padding-left:25%; }
 form.formtastic fieldset ol { }
+form.formtastic fieldset.buttons li { float:left; padding-right:0.5em; }
 
 /* clearfixing the fieldsets */
 form.formtastic fieldset { display: inline-block; }

data/lib/formtastic.rb

@@ -315,7 +315,7 @@ module Formtastic #:nodoc:
     # :required can be also sent as option. When true, marks a filed as required,
     # when false marks it as optional. When nil, does nothing.
     #
-    def label(method, text, options={}, as_span=false)
+    def label(method, text=nil, options={}, as_span=false)
       text ||= humanized_attribute_name(method)
       text  << required_or_optional_string(options.delete(:required))
 

data/spec/formtastic_spec.rb

@@ -286,6 +286,26 @@ describe 'Formtastic' do
       end
     end
 
+    describe '#label' do
+      it 'should humanize the given attribute' do
+        semantic_form_for(@new_post) do |builder|
+          builder.label(:login).should have_tag('label', :with => /Login/)
+        end
+      end
+
+      it 'should append required note' do
+        semantic_form_for(@new_post) do |builder|
+          builder.label(:login, nil, :required => true).should have_tag('label abbr')
+        end
+      end
+
+      it 'should be printed as span' do
+        semantic_form_for(@new_post) do |builder|
+          builder.label(:login, nil, { :required => true }, true).should have_tag('span.label abbr')
+        end
+      end
+    end
+
     describe '#input' do
 
       before do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: justinfrench-formtastic
 version: !ruby/object:Gem::Version 
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors: 
 - Justin French
@@ -9,7 +9,7 @@ autorequire: formtastic
 bindir: bin
 cert_chain: []
 
-date: 2009-04-19 00:00:00 -07:00
+date: 2009-04-22 00:00:00 -07:00
 default_executable: 
 dependencies: []