formtastic 0.9.0 → 0.9.1

data/rails/init.rb

@@ -1,4 +1,3 @@
 # coding: utf-8
 require File.join(File.dirname(__FILE__), *%w[.. lib formtastic])
-require File.join(File.dirname(__FILE__), *%w[.. lib justin_french formtastic])
 ActionView::Base.send :include, Formtastic::SemanticFormHelper

data/spec/buttons_spec.rb

@@ -0,0 +1,149 @@
+# coding: utf-8
+require File.dirname(__FILE__) + '/test_helper'
+
+describe 'SemanticFormBuilder#buttons' do
+
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ''
+    mock_everything
+  end
+
+  describe 'with a block' do
+    describe 'when no options are provided' do
+      before do
+        semantic_form_for(@new_post) do |builder|
+          builder.buttons do
+            concat('hello')
+          end
+        end
+      end
+
+      it 'should render a fieldset inside the form, with a class of "inputs"' do
+        output_buffer.should have_tag("form fieldset.buttons")
+      end
+
+      it 'should render an ol inside the fieldset' do
+        output_buffer.should have_tag("form fieldset.buttons ol")
+      end
+
+      it 'should render the contents of the block inside the ol' do
+        output_buffer.should have_tag("form fieldset.buttons ol", /hello/)
+      end
+
+      it 'should not render a legend inside the fieldset' do
+        output_buffer.should_not have_tag("form fieldset.buttons legend")
+      end
+    end
+
+    describe 'when a :name option is provided' do
+      before do
+        @legend_text = "Advanced options"
+
+        semantic_form_for(@new_post) do |builder|
+          builder.buttons :name => @legend_text do
+          end
+        end
+      end
+      it 'should render a fieldset inside the form' do
+        output_buffer.should have_tag("form fieldset legend", /#{@legend_text}/)
+      end
+    end
+
+    describe 'when other options are provided' do
+      before do
+        @id_option = 'advanced'
+        @class_option = 'wide'
+
+        semantic_form_for(@new_post) do |builder|
+          builder.buttons :id => @id_option, :class => @class_option do
+          end
+        end
+      end
+      it 'should pass the options into the fieldset tag as attributes' do
+        output_buffer.should have_tag("form fieldset##{@id_option}")
+        output_buffer.should have_tag("form fieldset.#{@class_option}")
+      end
+    end
+
+  end
+
+  describe 'without a block' do
+
+    describe 'with no args (default buttons)' do
+
+      before do
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.buttons)
+        end
+      end
+
+      it 'should render a form' do
+        output_buffer.should have_tag('form')
+      end
+
+      it 'should render a buttons fieldset inside the form' do
+        output_buffer.should have_tag('form fieldset.buttons')
+      end
+
+      it 'should not render a legend in the fieldset' do
+        output_buffer.should_not have_tag('form fieldset.buttons legend')
+      end
+
+      it 'should render an ol in the fieldset' do
+        output_buffer.should have_tag('form fieldset.buttons ol')
+      end
+
+      it 'should render a list item in the ol for each default button' do
+        output_buffer.should have_tag('form fieldset.buttons ol li', :count => 1)
+      end
+
+      it 'should render a commit list item for the commit button' do
+        output_buffer.should have_tag('form fieldset.buttons ol li.commit')
+      end
+
+    end
+
+    describe 'with button names as args' do
+
+      before do
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.buttons(:commit))
+        end
+      end
+
+      it 'should render a form with a fieldset containing a list item for each button arg' do
+        output_buffer.should have_tag('form > fieldset.buttons > ol > li', :count => 1)
+        output_buffer.should have_tag('form > fieldset.buttons > ol > li.commit')
+      end
+
+    end
+
+    describe 'with button names as args and an options hash' do
+
+      before do
+        semantic_form_for(@new_post) do |builder|
+          concat(builder.buttons(:commit, :name => "Now click a button", :id => "my-id"))
+        end
+      end
+
+      it 'should render a form with a fieldset containing a list item for each button arg' do
+        output_buffer.should have_tag('form > fieldset.buttons > ol > li', :count => 1)
+        output_buffer.should have_tag('form > fieldset.buttons > ol > li.commit', :count => 1)
+      end
+
+      it 'should pass the options down to the fieldset' do
+        output_buffer.should have_tag('form > fieldset#my-id.buttons')
+      end
+
+      it 'should use the special :name option as a text for the legend tag' do
+        output_buffer.should have_tag('form > fieldset#my-id.buttons > legend', /Now click a button/)
+      end
+
+    end
+
+  end
+
+end
+

data/spec/commit_button_spec.rb

@@ -0,0 +1,344 @@
+# coding: utf-8
+require File.dirname(__FILE__) + '/test_helper'
+
+describe 'SemanticFormBuilder#commit_button' do
+
+  include FormtasticSpecHelper
+  
+  before do
+    @output_buffer = ''
+    mock_everything
+  end
+
+  describe 'when used on any record' do
+
+    before do
+      @new_post.stub!(:new_record?).and_return(false)
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.commit_button)
+      end
+    end
+
+    it 'should render a commit li' do
+      output_buffer.should have_tag('li.commit')
+    end
+
+    it 'should render an input with a type attribute of "submit"' do
+      output_buffer.should have_tag('li.commit input[@type="submit"]')
+    end
+
+    it 'should render an input with a name attribute of "commit"' do
+      output_buffer.should have_tag('li.commit input[@name="commit"]')
+    end
+
+    it 'should pass options given in :button_html to the button' do
+      @new_post.stub!(:new_record?).and_return(false)
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.commit_button('text', :button_html => {:class => 'my_class', :id => 'my_id'}))
+      end
+
+      output_buffer.should have_tag('li.commit input#my_id')
+      output_buffer.should have_tag('li.commit input.my_class')
+    end
+    
+  end
+
+  describe "its accesskey" do
+  
+    it 'should allow nil default' do
+      Formtastic::SemanticFormBuilder.default_commit_button_accesskey.should == nil
+      output_buffer.should_not have_tag('li.commit input[@accesskey]')
+    end
+
+    it 'should use the default if set' do
+      Formtastic::SemanticFormBuilder.default_commit_button_accesskey = 's'
+      @new_post.stub!(:new_record?).and_return(false)
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.commit_button('text', :button_html => {}))
+      end
+      output_buffer.should have_tag('li.commit input[@accesskey="s"]')
+    end
+
+    it 'should use the value set in options over the default' do
+      Formtastic::SemanticFormBuilder.default_commit_button_accesskey = 's'
+      @new_post.stub!(:new_record?).and_return(false)
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.commit_button('text', :accesskey => 'o'))
+      end
+      output_buffer.should_not have_tag('li.commit input[@accesskey="s"]')
+      output_buffer.should have_tag('li.commit input[@accesskey="o"]')
+    end
+
+    it 'should use the value set in button_html over options' do
+      Formtastic::SemanticFormBuilder.default_commit_button_accesskey = 's'
+      @new_post.stub!(:new_record?).and_return(false)
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.commit_button('text', :accesskey => 'o', :button_html => {:accesskey => 't'}))
+      end
+      output_buffer.should_not have_tag('li.commit input[@accesskey="s"]')
+      output_buffer.should_not have_tag('li.commit input[@accesskey="o"]')
+      output_buffer.should have_tag('li.commit input[@accesskey="t"]')
+    end
+
+    after do
+      Formtastic::SemanticFormBuilder.default_commit_button_accesskey = nil
+    end
+
+  end
+
+  describe 'when the first option is a string and the second is a hash' do
+    
+    before do
+      @new_post.stub!(:new_record?).and_return(false)
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.commit_button("a string", :button_html => { :class => "pretty"}))
+      end
+    end
+    
+    it "should render the string as the value of the button" do
+      output_buffer.should have_tag('li input[@value="a string"]')
+    end
+    
+    it "should deal with the options hash" do
+      output_buffer.should have_tag('li input.pretty')
+    end
+    
+  end
+
+  describe 'when the first option is a hash' do
+
+    before do
+      @new_post.stub!(:new_record?).and_return(false)
+      semantic_form_for(@new_post) do |builder|
+        concat(builder.commit_button(:button_html => { :class => "pretty"}))
+      end
+    end
+    
+    it "should deal with the options hash" do
+      output_buffer.should have_tag('li input.pretty')
+    end
+    
+  end
+
+  describe 'label' do
+    before do
+      ::Post.stub!(:human_name).and_return('Post')
+    end
+
+    # No object
+    describe 'when used without object' do
+      describe 'when explicit label is provided' do
+        it 'should render an input with the explicitly specified label' do
+          semantic_form_for(:post, :url => 'http://example.com') do |builder|
+            concat(builder.commit_button "Click!")
+          end
+          output_buffer.should have_tag('li.commit input[@value="Click!"][@class~="submit"]')
+        end
+      end
+
+      describe 'when no explicit label is provided' do
+        describe 'when no I18n-localized label is provided' do
+          before do
+            ::I18n.backend.store_translations :en, :formtastic => {:submit => 'Submit {{model}}'}
+          end
+          
+          after do
+            ::I18n.backend.store_translations :en, :formtastic => {:submit => nil}
+          end
+          
+          it 'should render an input with default I18n-localized label (fallback)' do
+            semantic_form_for(:post, :url => 'http://example.com') do |builder|
+              concat(builder.commit_button)
+            end
+            output_buffer.should have_tag('li.commit input[@value="Submit Post"][@class~="submit"]')
+          end
+        end
+
+       describe 'when I18n-localized label is provided' do
+         before do
+           ::I18n.backend.store_translations :en,
+             :formtastic => {
+                 :actions => {
+                   :submit => 'Custom Submit',
+                   :post => {
+                     :submit => 'Custom Submit {{model}}'
+                    }
+                  }
+               }
+           ::Formtastic::SemanticFormBuilder.i18n_lookups_by_default = true
+         end
+
+         it 'should render an input with localized label (I18n)' do
+           semantic_form_for(:post, :url => 'http://example.com') do |builder|
+             concat(builder.commit_button)
+           end
+           output_buffer.should have_tag(%Q{li.commit input[@value="Custom Submit Post"][@class~="submit"]})
+         end
+
+         it 'should render an input with anoptional localized label (I18n) - if first is not set' do
+           ::I18n.backend.store_translations :en,
+             :formtastic => {
+                 :actions => {
+                   :post => {
+                     :submit => nil
+                    }
+                  }
+               }
+           semantic_form_for(:post, :url => 'http://example.com') do |builder|
+             concat(builder.commit_button)
+           end
+           output_buffer.should have_tag(%Q{li.commit input[@value="Custom Submit"][@class~="submit"]})
+         end
+
+       end
+      end
+    end
+
+    # New record
+    describe 'when used on a new record' do
+      before do
+        @new_post.stub!(:new_record?).and_return(true)
+      end
+
+      describe 'when explicit label is provided' do
+        it 'should render an input with the explicitly specified label' do
+          semantic_form_for(@new_post) do |builder|
+            concat(builder.commit_button "Click!")
+          end
+          output_buffer.should have_tag('li.commit input[@value="Click!"][@class~="create"]')
+        end
+      end
+
+      describe 'when no explicit label is provided' do
+        describe 'when no I18n-localized label is provided' do
+          before do
+            ::I18n.backend.store_translations :en, :formtastic => {:create => 'Create {{model}}'}
+          end
+
+          after do
+            ::I18n.backend.store_translations :en, :formtastic => {:create => nil}
+          end
+
+          it 'should render an input with default I18n-localized label (fallback)' do
+            semantic_form_for(@new_post) do |builder|
+              concat(builder.commit_button)
+            end
+            output_buffer.should have_tag('li.commit input[@value="Create Post"][@class~="create"]')
+          end
+        end
+
+        describe 'when I18n-localized label is provided' do
+          before do
+            ::I18n.backend.store_translations :en,
+              :formtastic => {
+                  :actions => {
+                    :create => 'Custom Create',
+                    :post => {
+                      :create => 'Custom Create {{model}}'
+                     }
+                   }
+                }
+            ::Formtastic::SemanticFormBuilder.i18n_lookups_by_default = true
+          end
+
+          it 'should render an input with localized label (I18n)' do
+            semantic_form_for(@new_post) do |builder|
+              concat(builder.commit_button)
+            end
+            output_buffer.should have_tag(%Q{li.commit input[@value="Custom Create Post"][@class~="create"]})
+          end
+
+          it 'should render an input with anoptional localized label (I18n) - if first is not set' do
+            ::I18n.backend.store_translations :en,
+              :formtastic => {
+                  :actions => {
+                    :post => {
+                      :create => nil
+                     }
+                   }
+                }
+            semantic_form_for(@new_post) do |builder|
+              concat(builder.commit_button)
+            end
+            output_buffer.should have_tag(%Q{li.commit input[@value="Custom Create"][@class~="create"]})
+          end
+
+        end
+      end
+    end
+
+    # Existing record
+    describe 'when used on an existing record' do
+      before do
+        @new_post.stub!(:new_record?).and_return(false)
+      end
+
+      describe 'when explicit label is provided' do
+        it 'should render an input with the explicitly specified label' do
+          semantic_form_for(@new_post) do |builder|
+            concat(builder.commit_button "Click!")
+          end
+          output_buffer.should have_tag('li.commit input[@value="Click!"][@class~="update"]')
+        end
+      end
+
+      describe 'when no explicit label is provided' do
+        describe 'when no I18n-localized label is provided' do
+          before do
+            ::I18n.backend.store_translations :en, :formtastic => {:update => 'Save {{model}}'}
+          end
+          
+          after do
+            ::I18n.backend.store_translations :en, :formtastic => {:update => nil}
+          end
+
+          it 'should render an input with default I18n-localized label (fallback)' do
+            semantic_form_for(@new_post) do |builder|
+              concat(builder.commit_button)
+            end
+            output_buffer.should have_tag('li.commit input[@value="Save Post"][@class~="update"]')
+          end
+        end
+
+        describe 'when I18n-localized label is provided' do
+          before do
+            ::I18n.backend.store_translations :en,
+              :formtastic => {
+                  :actions => {
+                    :update => 'Custom Save',
+                    :post => {
+                      :update => 'Custom Save {{model}}'
+                     }
+                   }
+                }
+            ::Formtastic::SemanticFormBuilder.i18n_lookups_by_default = true
+          end
+
+          it 'should render an input with localized label (I18n)' do
+            semantic_form_for(@new_post) do |builder|
+              concat(builder.commit_button)
+            end
+            output_buffer.should have_tag(%Q{li.commit input[@value="Custom Save Post"][@class~="update"]})
+          end
+
+          it 'should render an input with anoptional localized label (I18n) - if first is not set' do
+            ::I18n.backend.store_translations :en,
+              :formtastic => {
+                  :actions => {
+                    :post => {
+                      :update => nil
+                     }
+                   }
+                }
+            semantic_form_for(@new_post) do |builder|
+              concat(builder.commit_button)
+            end
+            output_buffer.should have_tag(%Q{li.commit input[@value="Custom Save"][@class~="update"]})
+          end
+
+        end
+      end
+    end
+  end
+
+end