twitter_bootstrap-helpers 0.0.1 → 0.0.2

data/README.md

@@ -3,19 +3,34 @@
 ## Installation
 
 Add to your gem file and call `bundle` to install it.
-
 ```ruby
 gem twitter_bootstrap-helpers install
 ```
 
+Adding to rails
+```ruby
+gem 'twitter_bootstrap-helpers'
+```
+
 ## Usage
 
-To use `TwitterBootstrap::FormBuilder` as in your form pass it as the builder option.
+Basic usage with form helper
+```erb
+<%= bootstrap_form_for @post do |f| %>
+	<%= f.text_field_control :title %>
+	<%= f.text_area_control :body %>
+	<%= f.checkbox_control :published %>
+	<%= f.form_actions %>
+<% end %>
+```
 
-```ruby
-<%= form_for @post, builder: TwitterBootstrap::FormBuilder do |f| %>
-	<%= f.text_field_control :subject %>
+To use form builder directly
+```erb
+<%= form_for @post, builder: TwitterBootstrap::Helpers::FormBuilder,
+					html:{class: 'form-horizontal'} do |f| %>
+	<%= f.text_field_control :title %>
 	<%= f.text_area_control :body %>
-	<%= f.date_select_control :publish_on %>
+	<%= f.checkbox_control :published %>
+	<%= f.form_actions %>
 <% end %>
 ```

data/lib/twitter_bootstrap-helpers/form_builder.rb

@@ -22,25 +22,88 @@ module TwitterBootstrap
         end
       end
 
+      # Submit button
+      # <input class="btn btn-primary" name="commit" type="submit" value="Create Post" />
       def submit(value=nil, options={})
         options[:class] = 'btn btn-primary' unless options.has_key? :class
         super value, options
       end
+
+      # Cancel button
+      #
+      # Creates a cancel link that will link to the index path of the
+      # current object by default a cancel url can also be passed as
+      # a param.
+      #
+      # <a href="/posts" class="btn">Cancel</a>
+      def cancel(url=nil)
+        url = @template.polymorphic_path(@object.class) if url.nil?
+        @template.link_to :Cancel, url, class: 'btn'
+      end
+
+      # Check box control
+      # <div class="control-group">
+      #   <div class="controls">
+      #     <label class="checkbox inline-form" for="input_id">
+      #       <input type="checkbox" id="input_id" value="1" />
+      #       Text Input
+      #     </label>
+      #   </div>
+      # </div>
+      def checkbox_control(attr, text=nil, *args)
+        options = args.extract_options!
+        options = { class: 'control-group' }
+        options[:class] += ' error' if @object.errors[attr].any?
+        text = attr.to_s.humanize if text.nil?
+        @template.content_tag :div, options do
+          @template.concat controls(attr) {
+            @template.concat label(attr, text, class: 'checkbox inline'){
+              @template.concat check_box(attr)
+              @template.concat text
+            }
+          }
+        end
+      end
+
+      # Form actions
+      # <div class="form-actions">
+      #   <input input="submit" value="Create Post" />
+      #   <a href="/posts" class="btn">Cancel</a>
+      # </div>
+      def form_actions(options={})
+        @template.content_tag :div, class: 'form-actions' do
+          @template.concat submit
+          @template.concat " " # Add space so submit and cancel buttons don't collide
+          @template.concat cancel(options[:cancel_url])
+        end
+      end
       
-      # Control Group Example
+      # Field Control Group Example
+      #
+      # Pass an input field name to create a standard control group
+      #
       # <div class="control-group">
       #   <label class="control-label" for="input_id">Text Input</label>
       #   <div class="controls">
       #     <input type="input_type" class="input-xlarge" id="input_id" />
       #   </div>
       # </div>
-
       def field_control_group(type, attr, *args)
         control_group attr do
           @template.concat send(type, attr, *args)
         end
       end
 
+      # Control Group
+      #
+      # Yield block within control group
+      #
+      # <div class="control-group">
+      #   <label class="control-label" for="input_id">Text Input</label>
+      #   <div class="controls">
+      #     <%= yield %>
+      #   </div>
+      # </div>
       def control_group(attr, text = nil, &block )
         options = { class: 'control-group' }
         options[:class] += ' error' if @object.errors[attr].any?
@@ -50,6 +113,13 @@ module TwitterBootstrap
         end
       end
 
+      # Control Group
+      #
+      # Yield block within control group
+      #
+      # <div class="controls">
+      #   <%= yield %>
+      # </div>
       def controls(attr, &block)
         @template.content_tag :div, class: 'controls' do
           yield
@@ -57,6 +127,8 @@ module TwitterBootstrap
         end
       end
 
+      # Display inline error
+      # <span class="help-inline">can't be blank.</span>
       def errors_on(attr)
         if @object.errors[attr].any?
           @template.content_tag(:span,

data/lib/twitter_bootstrap-helpers/version.rb

@@ -1,5 +1,5 @@
 module TwitterBootstrap
   module Helpers
-    VERSION = "0.0.1"
+    VERSION = "0.0.2"
   end
 end

data/test/dummy/app/views/posts/_form.html.erb

@@ -1,6 +1,6 @@
 <%= bootstrap_form_for @post  do |f| %>
   <%= f.text_field_control :title %>
-  <div class="actions">
-    <%= f.submit %>
-  </div>
+  <%= f.text_area_control :body %>
+  <%= f.checkbox_control :published %>
+  <%= f.form_actions %>
 <% end %>

data/test/twitter_bootstrap-helpers_test.rb

@@ -25,6 +25,19 @@ class TwitterBootstrap::HelpersTest < ActionView::TestCase
         </div>')
   end
 
+  test "checkbox_control" do
+    assert_equal @builder.checkbox_control(:published),
+      r('<div class="control-group">
+           <div class="controls">
+             <label class="checkbox inline" for="post_published">
+               <input name="post[published]" type="hidden" value="0" />
+               <input id="post_published" name="post[published]" type="checkbox" value="1" />
+               Published
+             </label>
+           </div>
+        </div>')
+  end
+
   test "field_control_group" do
     assert_equal @builder.field_control_group(:text_field,:title),
       r('<div class="control-group">
@@ -39,6 +52,26 @@ class TwitterBootstrap::HelpersTest < ActionView::TestCase
     assert_equal @builder.submit, '<input class="btn btn-primary" name="commit" type="submit" value="Create Post" />'
   end
 
+  test "cancel" do
+    assert_equal @builder.cancel, '<a href="/posts" class="btn">Cancel</a>'
+  end
+
+  test "form_actions" do
+    assert_equal @builder.form_actions, 
+      r('<div class="form-actions">
+           <input class="btn btn-primary" name="commit" type="submit" value="Create Post" /> 
+           <a href="/posts" class="btn">Cancel</a>
+         </div>')
+  end
+
+  test "form_actions with custom cancel button" do
+    assert_equal @builder.form_actions(cancel_url:'/'), 
+      r('<div class="form-actions">
+           <input class="btn btn-primary" name="commit" type="submit" value="Create Post" /> 
+           <a href="/" class="btn">Cancel</a>
+         </div>')
+  end
+
   test "input fields should have class input-xlarge" do
     assert_equal @builder.text_field_control(:title),
       r('<div class="control-group">

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: twitter_bootstrap-helpers
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-30 00:00:00.000000000 Z
+date: 2012-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails