bootstrap-view-helpers 0.0.11 → 0.0.12

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Change Log
 
+## v 0.0.12
+
+* added `modal` and `modal_trigger` for Bootstrap modal dialogs
+* added `modal_alert` and `modal_confirm` which work similarly to their Javascript counterparts
+* added `flash_messages` helper for flash support
+* added `bs_table_tag` for consistent Bootstrap tables
+
 ## v 0.0.11
 
 * added `nav_bar_text`

data/README.md

@@ -12,6 +12,10 @@ Includes support for:
   * navigation
     * nav bar
     * nav list
+  * modal dialogs
+    * modal_trigger
+    * modal_alert
+    * modal_confirm
   * icons
     * icons with text 
   * buttons
@@ -29,7 +33,10 @@ Includes support for:
     * submit_tag_button
     * cancel_tag_button
   * alerts
+  * table helper
   
+For the complete list of available helpers see the [API documentation](http://rubydoc.info/gems/bootstrap-view-helpers/frames/file/README.md).
+
 ## Note
 
 This is a new gem undergoing a lot of change.  There is a chance that some backwards
@@ -91,7 +98,7 @@ Complete [API documentation](http://rubydoc.info/gems/bootstrap-view-helpers/fra
 
   <%= nav_bar_links(pull: 'right') do %>
     <%= nav_bar_text('logged in as admin') %>
-    <%= nav_dropdown('Foo') do %>
+    <%= nav_dropdown('Dropdown 1') do %>
       <%= dropdown_item('One', 'foo')%>
     <% end %>
   <% end %>
@@ -108,6 +115,64 @@ Complete [API documentation](http://rubydoc.info/gems/bootstrap-view-helpers/fra
 <% end %>
 ```
 
+### Modal Dailogs an Friends
+
+#### Simple Example Using Defaults
+
+```erb
+<%= modal_trigger("Click to show modal", href: '#modal-1') %>
+
+<%= modal(id: 'modal-1') do %>
+  <%= modal_header("Heading") %>
+  <%= modal_body("The body ...") %>
+  <%= modal_footer %>
+<% end %>
+```
+
+#### Block Form Using Other Modal Helpers
+
+```erb
+<%= modal_trigger("Click to show modal", href: '#modal-2', class: 'btn btn-primary') %>
+
+<%= modal(id: 'modal-2') do %>
+  <%= modal_header(close: false) do %>
+    Heading <small>(with no close button)</small>
+  <% end %>
+  <%= modal_body do %>
+    <h4>Modal Body</h4>
+    <p>With additional markup</p>
+  <% end %>
+  <%= modal_footer do %>
+    <%= button("Save", :primary) %>
+    <%= modal_footer_close_button("Dismiss") %>
+  <% end %>
+<% end %>
+```
+
+#### Modal Alert - Similar to JS Alert
+
+```erb
+<%= modal_trigger("Click to show Alert", href: '#alert') %>
+<%= modal_alert("Watch out", id: 'alert') %>
+
+<%= modal_trigger("Click to show Alert w/block", href: '#alert-block') %>
+<%= modal_alert(id: 'alert-block', header: 'Custom Header') do %>
+  This is some <b>bold</b> text from the <code>modal_alert</code> block.
+<% end %>
+```
+
+#### Modal Confirm - Similar to JS Confirm
+
+```erb
+<%= modal_trigger("Click to show Confirm", href: '#confirm') %>
+<%= modal_confirm("Watch out", id: 'confirm') %>
+
+<%= modal_trigger("Click to show Confirm w/block", href: '#confirm-block') %>
+<%= modal_confirm(id: 'confirm-block', header: 'Custom Header') do %>
+  This is some <b>bold</b> text from the <code>modal_confirm</code> block.
+<% end %>
+```
+
 ### Icons
 
 See: http://twitter.github.io/bootstrap/base-css.html#icons
@@ -282,4 +347,57 @@ cancel_button_tag('Return', :small, :warning, url: '/', id: 'my-id')
     <li>Two</li>
   </ul>
 <% end %>
-```
+```
+
+### Flash
+
+[API Documentation](http://rubydoc.info/gems/bootstrap-view-helpers/Bootstrap/FlashHelper)
+
+```erb
+# in a layout or view
+
+<%= flash_messages %>
+<%= flash_messages close: false %>
+<%= flash_messages class: 'flash', id: 'my-flash' %>
+```
+
+```ruby
+# override default mapping (e.g., in initializer)
+
+Bootstrap::FlashHelper.mapping[:notice] = :success
+Bootstrap::FlashHelper.mapping[:mistake] = :error
+```
+
+### Table Helper
+
+* [API Documentation](http://rubydoc.info/gems/bootstrap-view-helpers/Bootstrap/TableHelper)
+* [Bootstrap Documentation](http://twitter.github.io/bootstrap/base-css.html#tables)
+
+Don't keep repeating the Bootstrap table classes:
+
+```erb
+# instead of
+<table class='table table-bordered table-striped table-hover'>
+  ...
+</table>
+
+# do this
+<%= bs_table_tag do %>
+  ...
+<% end %>
+```
+
+Customize the classes used (e.g. in an initializer):
+
+```ruby
+# change the default
+Bootstrap::TableHelper.class_lists[:default] = 'table table-striped'
+
+# create a custom class list
+Bootstrap::TableHelper.class_lists[:admin] = 'admin table table-striped table-compact'
+
+# use the custom list
+<%= bs_table_tag(:admin) do %>
+  ...
+<% end %>
+```

data/app/TODO.md

@@ -0,0 +1,8 @@
+## Alert
+
+* icons (optional?) for alert/flash types
+
+## Nav
+
+* nav_header (v. nav_list_header)
+

data/app/controllers/bootstrap_view_helpers_controller.rb

@@ -10,4 +10,12 @@ class BootstrapViewHelpersController < ApplicationController
   def index
   end
   
+  def flash_helper
+    flash.now[:notice] = ":notice is mapped to :info"
+    flash.now[:alert] = ":alert is mapped to :error"
+    flash.now[:warning] = 'Unrecognized types use Bootstrap default'
+    flash.now[:success] = "The operation was a success"
+    flash.now[:error] = "There was an error"
+    flash.now[:info] = "Here is some info"
+  end
 end

data/app/helpers/bootstrap/alert_helper.rb

@@ -17,6 +17,7 @@
 #     </ul>
 #   <% end %>
 module Bootstrap::AlertHelper
+  InvalidAlertTypeError = Class.new(StandardError)
   
   ALERT_ATTRIBUTES = %w(error success info block)
   
@@ -28,31 +29,23 @@ module Bootstrap::AlertHelper
   #   @option options [Boolean] :close if +false+, don't include a close link ('x')
   # @return [String] Returns html for alert
   def alert(*args, &block)
-    text = args.shift unless block_given?
+    body = alert_body(args, &block)
     options = canonicalize_options(args.extract_options!)
     options = ensure_class(options, 'alert')
     options = add_alert_classes(options, args)
     heading = options.delete(:heading)
     show_close = options.delete(:close) != false 
     
-    if block_given?
-      content_tag(:div, options) do
-        alert_close(show_close) + 
-        alert_heading(heading) + 
-        capture(&block)
-      end
-    else
-      content_tag(:div, options) do
-        alert_close(show_close) + 
-        alert_heading(heading) + 
-        text
-      end
+    content_tag(:div, options) do
+      alert_close(show_close) + 
+      alert_heading(heading) + 
+      body
     end
   end
   
   # Return an alert box close button
   #
-  # @return [String] html for alert close button
+  # @return [String] html for alert close button unless _show_ is +false+
   def alert_close(show=true)
     return '' unless show
     content_tag(:button, '&times;'.html_safe, class: 'close', data: {dismiss: 'alert'})
@@ -60,7 +53,7 @@ module Bootstrap::AlertHelper
 
   # Return an alert heading
   #
-  # @return [String] html for alert heading
+  # @return [String] html for alert heading unless _heading_ is blank.
   def alert_heading(heading)
     return '' unless heading.present?
     content_tag(:h4, heading)
@@ -68,6 +61,14 @@ module Bootstrap::AlertHelper
   
   private
   
+  def alert_body(args, &block)
+    if block_given?
+      capture(&block)
+    else
+      args.shift
+    end
+  end
+  
   def add_alert_classes(options, alert_attributes)
     validate_alert_attributes(alert_attributes)
     classes = ['alert'] + alert_attributes.map { |e| "alert-#{e}" }
@@ -75,7 +76,7 @@ module Bootstrap::AlertHelper
   end
   
   def validate_alert_attributes(alert_attributes)
-    alert_attributes.each { |e| raise(InvalidAlertAttributeError, e.inspect) unless ALERT_ATTRIBUTES.include?(e.to_s) }
+    alert_attributes.each { |e| raise(InvalidAlertTypeError, e.inspect) unless ALERT_ATTRIBUTES.include?(e.to_s) }
   end
   
   

data/app/helpers/bootstrap/flash_helper.rb

@@ -0,0 +1,54 @@
+# Rails helpers for producing flash messages styled as Bootstrap alert boxes.
+#
+# @example
+#   # in a layout or view
+#
+#   flash_messages
+#   flash_messages close: false
+#   flash_messages class: 'flash', id: 'my-flash'
+#   
+#   # override default mapping
+#
+#   Bootstrap::FlashHelper.mapping[:notice] = :success
+#   Bootstrap::FlashHelper.mapping[:mistake] = :error
+#   
+module Bootstrap::FlashHelper
+  DEFAULT_MAPPING = {
+    :notice => :info,
+    :alert => :error,
+  }
+  
+  mattr_accessor :mapping
+  self.mapping = DEFAULT_MAPPING.dup
+  
+  # Returns Bootstrap alerts for each entry in +flash+
+  #
+  # @param options [Hash] unrecognized options are passed the the {Bootstrap::AlertHelper#alert} method
+  # @option options [Boolean] :close if +false+ the close button is not shown
+  # @return [String]
+  def flash_messages(options={})
+    messages = flash.map { |type, message| _bs_flash_for(type, message, options) }
+    safe_join(messages, "\n")
+  end
+  
+  private
+  
+  def _bs_flash_for(type, message, options={})
+    options = canonicalize_options(options)
+    alert_class = _bs_alert_class_for(type)
+    options = ensure_class(options, alert_class)
+    
+    alert(message, options)
+  end
+  
+  def _bs_alert_class_for(type)
+    mapped_type = _bs_map_type(type)
+    
+    "alert-#{mapped_type}"
+  end
+  
+  def _bs_map_type(type)
+    mapping[type.to_sym] || type
+  end
+    
+end

data/app/helpers/bootstrap/modal_helper.rb

@@ -0,0 +1,123 @@
+# Rails helper for producing Bootstrap modal dialogs
+#
+module Bootstrap::ModalHelper
+
+  # Returns an A tag to trigger (open) a Boostrap modal
+  def modal_trigger(text, options={})
+    options = canonicalize_options(options)
+    href = options.delete(:href) or raise(ArgumentError, 'missing :href option')
+    options.merge!(role: 'button', href: href, data: { toggle: 'modal'})
+    options = ensure_class(options, 'btn')
+    
+    content_tag(:a, text, options)
+  end
+
+  # Returns a Bootstrap modal dialog
+  def modal(options={})
+    options = canonicalize_options(options)
+    options.has_key?(:id) or raise(ArgumentError, "missing :id option")
+    options = ensure_class(options, %w(modal hide fade))
+    options.merge!(tabindex: "-1", role: "dialog")
+    
+    content_tag(:div, options) do
+      yield
+    end
+  end
+  
+  # Returns a DIV for Bootstrap modal header
+  def modal_header(*args, &block)
+    options = canonicalize_options(args.extract_options!)
+    options = ensure_class(options, 'modal-header')
+    show_close = options.delete(:close) != false
+  
+    content = block_given? ? capture(&block) : args.shift
+  
+    content_tag(:div, options) do
+      modal_header_close_button(show_close) +
+      content_tag(:h3) do
+        content
+      end
+    end
+  end
+
+  # Returns a DIV for Bootstrap modal body
+  def modal_body(*args, &block)
+    options = canonicalize_options(args.extract_options!)
+    options = ensure_class(options, 'modal-body')
+    content = block_given? ? capture(&block) : args.shift
+
+    content_tag(:div, options) do
+      content
+    end
+  end
+  
+  # Returns a DIV for Bootstrap modal footer
+  # Defaults to including #modal_footer_close_button.
+  def modal_footer(*args, &block)
+    options = canonicalize_options(args.extract_options!)
+    options = ensure_class(options, 'modal-footer')
+    
+    content = if block_given?
+      capture(&block)
+    elsif args.size > 0
+      args.shift
+    else
+      modal_footer_close_button
+    end
+
+    content_tag(:div, options) do
+      content
+    end
+  end
+
+  # Returns a Bootstrap modal close button
+  def modal_header_close_button(show=true)
+    return ''.html_safe unless show
+    button("×".html_safe, type: 'button', class: 'close modal-close modal-header-close', data: {dismiss: 'modal'})
+  end
+
+  # Returns a close button for Bootstrap modal footer.
+  def modal_footer_close_button(*args)
+    options = canonicalize_options(args.extract_options!)
+    options = ensure_class(options, 'modal-close modal-footer-close')
+    options.merge!(data: {dismiss: 'modal'})
+    args.unshift("Close") if args.empty?
+
+    button(*args, options)
+  end
+  
+  def modal_footer_ok_button(*args)
+    options = canonicalize_options(args.extract_options!)
+    options = ensure_class(options, 'modal-footer-ok')
+    options.merge!(data: {dismiss: 'modal'})
+    args.unshift("Ok") if args.empty?
+  
+    button(*args, options)
+  end
+  
+  def modal_alert(*args, &block)
+    options = canonicalize_options(args.extract_options!)
+    header = options.delete(:header) || "Alert"
+
+    modal(options) do
+      modal_header(header) + 
+      modal_body(*args, &block) + 
+      modal_footer
+    end
+  end
+
+  def modal_confirm(*args, &block)
+    options = canonicalize_options(args.extract_options!)
+    header = options.delete(:header) || "Confirmation"
+
+    modal(options) do
+      modal_header(header) + 
+      modal_body(*args, &block) + 
+      modal_footer do
+        modal_footer_close_button(icon('remove', 'Cancel')) + 
+        modal_footer_ok_button(icon('ok', :white, 'Ok'), :primary)
+      end
+    end
+  end
+  
+end

data/app/helpers/bootstrap/nav_helper.rb

@@ -15,7 +15,7 @@
 #     <% end >
 # 
 #     <%= nav_dropdown(pull: 'right') %>
-#       <%= nav_dropdown('Foo') do %>
+#       <%= nav_dropdown('Dropdown 1') do %>
 #         <%= dropdown_item('One', 'foo')%>
 #       <% end %>
 #     <% end %>

data/app/helpers/bootstrap/table_helper.rb

@@ -0,0 +1,51 @@
+# Rails helper for producing consistent Bootstrap styled tables.
+#
+# @example
+#   # in your view
+#
+#   <%= bs_table_tag do %>
+#     ...
+#
+#   <%= bs_table_tag(id: 'my-id', class: 'another-class') do %>
+#     ...
+#
+#   # configure a custom set of classes:
+#   Bootstrap::TableHelper.classes[:admin] = %w(admin table table-striped table-compact)
+#   
+#   <%= bs_table_tag(:admin) do %>
+#
+#   
+module Bootstrap::TableHelper
+  InvalidClassListsKeyError = Class.new(StandardError)
+  
+  DEFAULT_CLASS_LIST = %w(table table-bordered table-striped table-hover)
+  
+  mattr_accessor :class_lists
+  self.class_lists = {default: DEFAULT_CLASS_LIST.dup}
+  
+  # Produces a wrapper TABLE element with Bootstrap classes.
+  #
+  # @overload bs_table_tag(class_list=:default, options={})
+  # @param class_list [Symbol] a key of the +Bootstrap::class_lists+ Hash
+  # @param options [Hash] unrecognized options become attributes of the <table> element
+  # @return [String]
+  def bs_table_tag(*args, &block)
+    options = canonicalize_options(args.extract_options!)
+    table_classes = _get_table_classes(args.shift)
+    options = ensure_class(options, table_classes)
+    
+    content_tag(:table, options) do
+      yield
+    end
+  end
+  
+  private
+  
+  def _get_table_classes(key)
+    key = key.presence || :default
+    self.class_lists.fetch(key)
+  rescue KeyError
+    raise(InvalidClassListsKeyError, "did not find key: #{key.inspect} -- Did you forget to set Bootstrap::TableHelper.class_lists[#{key.inspect}]?")
+  end
+   
+end

data/app/views/application/_bootstrap_view_helper_nav_bar.html.erb

@@ -11,8 +11,8 @@
   <% end %>
   
   <%= nav_bar_links(pull: 'right') do %>
-    <%= nav_dropdown('Foo') do %>
-      <%= dropdown_item('One', 'foo') %>
+    <%= nav_dropdown('Dropdown 1') do %>
+      <%= dropdown_item('One', '#') %>
     <% end %>
   <% end %>
   

data/app/views/application/_bootstrap_view_helper_side_bar.html.erb

@@ -2,11 +2,15 @@
   
   <%= nav_list_header('Sidebar Header') %>
 
-  <%= dropdown_item('Icons', bvh_path('icons')) %>
-  <%= dropdown_item('Buttons', bvh_path('buttons')) %>
-  <%= dropdown_item('Labels and badges', bvh_path('labels_and_badges')) %>
   <%= dropdown_item('Accordions', bvh_path('accordions')) %>
-  <%= dropdown_item('Form helpers', bvh_path('form_helpers')) %>
   <%= dropdown_item('Alerts', bvh_path('alerts')) %>
+  <%= dropdown_item('Buttons', bvh_path('buttons')) %>
+  <%= dropdown_item('Icons', bvh_path('icons')) %>
+  <%= dropdown_item('Form helpers', bvh_path('form_helpers')) %>
+  <%= dropdown_item('Flash', bvh_path('flash_helper')) %>
+  <%= dropdown_item('Labels and badges', bvh_path('labels_and_badges')) %>
+  <%= dropdown_item('Modal Helpers', bvh_path('modal')) %>
+  <%= dropdown_item('Nav Helpers', bvh_path) %>
+  <%= dropdown_item('Table Helpers', bvh_path('tables')) %>
   
 <% end %>

data/app/views/bootstrap_view_helpers/_flash_helper.html.erb

@@ -0,0 +1 @@
+<%= flash_messages class: 'foo' %>

data/app/views/bootstrap_view_helpers/_modal_alert.html.erb

@@ -0,0 +1,9 @@
+<%= modal_trigger("Click to show Alert", href: '#alert') %>
+<%= modal_trigger("Click to show Alert w/block", href: '#alert-block') %>
+
+<%= modal_alert("Watch out", id: 'alert') %>
+
+<%= modal_alert(id: 'alert-block', header: 'Custom Header') do %>
+  This is some <b>bold</b> text from the <code>modal_alert</code> block.
+<% end %>
+

data/app/views/bootstrap_view_helpers/_modal_basic.html.erb

@@ -0,0 +1,9 @@
+<%= modal_trigger("Click to show modal", href: '#modal-1') %>
+
+<%= modal(id: 'modal-1') do %>
+  <%= modal_header("Heading") %>
+  <%= modal_body("The body ...") %>
+  <%= modal_footer %>
+<% end %>
+
+

data/app/views/bootstrap_view_helpers/_modal_block.html.erb

@@ -0,0 +1,15 @@
+<%= modal_trigger("Click to show modal", href: '#modal-2', class: 'btn btn-primary') %>
+
+<%= modal(id: 'modal-2') do %>
+  <%= modal_header(close: false) do %>
+    Heading <small>(with no close button)</small>
+  <% end %>
+  <%= modal_body do %>
+    <h4>Modal Body</h4>
+    <p>With additional markup</p>
+  <% end %>
+  <%= modal_footer do %>
+    <%= button("Save", :primary) %>
+    <%= modal_footer_close_button("Dismiss") %>
+  <% end %>
+<% end %>

data/app/views/bootstrap_view_helpers/_modal_confirm.html.erb

@@ -0,0 +1,8 @@
+<%= modal_trigger("Click to show Confirm", href: '#confirm') %>
+<%= modal_trigger("Click to show Confirm w/block", href: '#confirm-block') %>
+
+<%= modal_confirm("Watch out", id: 'confirm') %>
+
+<%= modal_confirm(id: 'confirm-block', header: 'Custom Header') do %>
+  This is some <b>bold</b> text from the <code>modal_confirm</code> block.
+<% end %>

data/app/views/bootstrap_view_helpers/_table_default.html.erb

@@ -0,0 +1,3 @@
+<% bs_table_tag do %>
+  ...
+<% end %>

data/app/views/bootstrap_view_helpers/_table_example.html.erb

@@ -0,0 +1,18 @@
+<%= bs_table_tag do %>
+  <tr>
+    <th>Id</th>
+    <th>Name</th>
+  </tr>
+  <tr>
+    <td>1</td>
+    <td>Art</td>
+  </tr>
+  <tr>
+    <td>2</td>
+    <td>Beth</td>
+  </tr>
+  <tr>
+    <td>3</td>
+    <td>Charles</td>
+  </tr>
+<% end %>

data/app/views/bootstrap_view_helpers/_table_with_class.html.erb

@@ -0,0 +1,3 @@
+<% bs_table_tag(:user) do %>
+  ...
+<% end %>

data/app/views/bootstrap_view_helpers/flash_helper.html.erb

@@ -0,0 +1,25 @@
+<h1>Flash Helper</h1>
+
+<p>
+  <%= link_to('API Documentation', 'http://rubydoc.info/gems/bootstrap-view-helpers/Bootstrap/FlashHelper') %>
+</p>
+
+<h2>Example</h2>
+<%= render partial: 'flash_helper' %>
+
+<h2>Source</h2>
+<%= bvh_show_source('bootstrap_view_helpers/_flash_helper') %>
+
+<pre>
+# in controller
+
+def my_action
+  flash.now[:notice] = ":notice is mapped to :info"
+  flash.now[:alert] = ":alert is mapped to :error"
+  flash.now[:warning] = 'Unrecognized types use Bootstrap default'
+  flash.now[:success] = "The operation was a success"
+  flash.now[:error] = "There was an error"
+  flash.now[:info] = "Here is some info"
+end
+</pre>
+   

data/app/views/bootstrap_view_helpers/modal.html.erb

@@ -0,0 +1,40 @@
+<h1>Modal Helpers</h1>
+
+<ul>
+  <li><%= link_to('Bootstrap Documentation', 'http://twitter.github.io/bootstrap/javascript.html#modals') %></li>
+  <li><%= link_to('API Documentation', 'http://rubydoc.info/gems/bootstrap-view-helpers/Bootstrap/ModalHelper') %>
+</ul>
+
+<h2>Basic Modal</h2>
+
+<h3>Example</h3>
+<%= render partial: 'modal_basic' %>
+
+<h3>Source</h3>
+<%= bvh_show_source('bootstrap_view_helpers/_modal_basic') %>
+
+<h2>Modal Utilizing Options, block form</h2>
+
+<h3>Example</h3>
+<%= render partial: 'modal_block' %>
+
+<h3>Source</h3>
+<%= bvh_show_source('bootstrap_view_helpers/_modal_block') %>
+
+<h2>Modal Alert</h2>
+<p>Simulate a Javascript <code>alert</code>:</p>
+
+<h3>Example</h3>
+<%= render partial: 'modal_alert' %>
+
+<h3>Source</h3>
+<%= bvh_show_source('bootstrap_view_helpers/_modal_alert') %>
+
+<h2>Modal Confirm</h2>
+<p>Simulate a Javascript <code>confirm</code>:</p>
+
+<h3>Example</h3>
+<%= render partial: 'modal_confirm' %>
+
+<h3>Source</h3>
+<%= bvh_show_source('bootstrap_view_helpers/_modal_confirm') %>

data/app/views/bootstrap_view_helpers/tables.html.erb

@@ -0,0 +1,51 @@
+<h1>Tables</h1>
+
+<p><%= link_to('Bootstrap Documentation', 'http://twitter.github.io/bootstrap/base-css.html#tables') %>
+  
+<p>When all your tables are the same, don't keep repeating the bootstrap table classes.</p>
+
+<p>Instead of this repeated for every table:</p>
+
+<pre>
+ <%=h %(<table class='table table-bordered table-striped table-hover'>
+   ...
+ </table>) %>
+</pre>
+
+<p>do this instead</p>
+<%= bvh_show_source('bootstrap_view_helpers/_table_default') %>
+
+<h2>Example</h2>
+<%= render partial: 'table_example' %>
+
+<h2>Source</h2>
+<%= bvh_show_source('bootstrap_view_helpers/_table_example') %>
+
+
+<h2>Configuration</h2>
+
+<p>Change the default table classes (e.g., in an initializer):</p>
+<pre>
+Bootstrap::TableHelper.classes[:default] = ['table', 'table-hover']
+</pre>
+
+<p>Define named sets of classes:<p>
+<pre>
+Bootstrap::TableHelper.classes[:user]  = ['user', 'table', 'table-striped', 'table-hover']
+Bootstrap::TableHelper.classes[:admin] = ['admin', 'table', 'table-striped', 'table-hover', 'table-bordered', 'table-compact']
+</pre>
+
+<p>Specify the name when you call the helper:</p>
+<%= bvh_show_source('bootstrap_view_helpers/_table_with_class') %>
+
+<h2>Other HTML Attributes</h2>
+<p>Unrecognized options become html attributes of the table:<p>
+
+<pre>
+# this call
+bs_table_tag(id: 'my-id', class: 'another-class')
+
+# produces
+<%=h %(<table class="other-class table table-bordered table-striped table-hover" id="my-id">) %>
+
+</pre>

data/lib/bootstrap-view-helpers/version.rb

@@ -1,3 +1,3 @@
 module BootstrapViewHelpers
-  VERSION = "0.0.11"
+  VERSION = "0.0.12"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bootstrap-view-helpers
 version: !ruby/object:Gem::Version
-  version: 0.0.11
+  version: 0.0.12
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-03 00:00:00.000000000 Z
+date: 2013-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -282,27 +282,42 @@ files:
 - app/helpers/bootstrap/button_helper.rb
 - app/helpers/bootstrap/common_helper.rb
 - app/helpers/bootstrap/dropdown_helper.rb
+- app/helpers/bootstrap/flash_helper.rb
 - app/helpers/bootstrap/form_helper.rb
 - app/helpers/bootstrap/icon_helper.rb
 - app/helpers/bootstrap/icon_renderer.rb
+- app/helpers/bootstrap/modal_helper.rb
 - app/helpers/bootstrap/nav_helper.rb
 - app/helpers/bootstrap/stamp_helper.rb
+- app/helpers/bootstrap/table_helper.rb
 - app/helpers/bootstrap_examples/application_helper.rb
+- app/TODO.md
 - app/views/application/_bootstrap_view_helper_nav_bar.html.erb
 - app/views/application/_bootstrap_view_helper_side_bar.html.erb
 - app/views/bootstrap_view_helpers/_accordions.html.erb
 - app/views/bootstrap_view_helpers/_alert_block.html.erb
 - app/views/bootstrap_view_helpers/_alert_options.html.erb
 - app/views/bootstrap_view_helpers/_alert_types.html.erb
+- app/views/bootstrap_view_helpers/_flash_helper.html.erb
 - app/views/bootstrap_view_helpers/_form_helper_1.html.erb
 - app/views/bootstrap_view_helpers/_icons.html.erb
+- app/views/bootstrap_view_helpers/_modal_alert.html.erb
+- app/views/bootstrap_view_helpers/_modal_basic.html.erb
+- app/views/bootstrap_view_helpers/_modal_block.html.erb
+- app/views/bootstrap_view_helpers/_modal_confirm.html.erb
+- app/views/bootstrap_view_helpers/_table_default.html.erb
+- app/views/bootstrap_view_helpers/_table_example.html.erb
+- app/views/bootstrap_view_helpers/_table_with_class.html.erb
 - app/views/bootstrap_view_helpers/accordions.html.erb
 - app/views/bootstrap_view_helpers/alerts.html.erb
 - app/views/bootstrap_view_helpers/buttons.html.erb
+- app/views/bootstrap_view_helpers/flash_helper.html.erb
 - app/views/bootstrap_view_helpers/form_helpers.html.erb
 - app/views/bootstrap_view_helpers/icons.html.erb
 - app/views/bootstrap_view_helpers/index.html.erb
 - app/views/bootstrap_view_helpers/labels_and_badges.html.erb
+- app/views/bootstrap_view_helpers/modal.html.erb
+- app/views/bootstrap_view_helpers/tables.html.erb
 - app/views/layouts/bootstrap_view_helpers.html.erb
 - config/routes.rb
 - lib/bootstrap-view-helpers/engine.rb