bettertabs 1.3.6 → 1.4

data/.gitignore

@@ -1,6 +1,7 @@
 pkg/*
 *.gem
 .bundle
+.rvmrc
 log
 tmp
 spec/dummy/public/assets/*

data/CHANGELOG.md

@@ -1,3 +1,68 @@
-# 1.3.6
+Bettertabs Changelog
+====================
 
-* Adds support for Rails 3.2, https://github.com/agoragames/bettertabs/pull/3. Thanks (@jlee42).
+### v1.4 (2012-06-18) ###
+
+  * Upgrade notes
+    * The bettertabs helper no longer generates javascript inline to apply the jquery pluging. If you update you need to add the javascript yourself (something like `jQuery('.bettertabs').bettertabs();` in your application.js file), or you can add an initializer to set the attach_jquery_bettertabs_inline option to true (see README).
+  * Add possibility to define default options (only attach_jquery_bettertabs_inline for now) in an initializer, https://github.com/agoragames/bettertabs/pull/6. Thanks (@manuelmeurer). Then set the attach_jquery_bettertabs_inline option to false by default.
+  * Allow to include content blocks that do not have tabs with `tab.only_content_block`. Inspired by https://github.com/agoragames/bettertabs/pull/7 by (@manuelmeurer)
+  * Add option :locals on tab definition. https://github.com/agoragames/bettertabs/pull/9. Thanks (@pdf)
+  * Add option :list_html_options to allow specifying :html_options for the :ul element, https://github.com/agoragames/bettertabs/pull/10. Thanks (@pdf)
+
+### v1.3.6 (2012-03-12) ###
+
+  * Adds support for Rails 3.2, https://github.com/agoragames/bettertabs/pull/3. Thanks (@jlee42).
+
+### v1.3.5 (2011-09-13) ###
+
+  * Add 'active' class to the link element inside the active tag as well as the li element (so it is now more easy to style)
+  * When tab-type is ajax, mark the first active link as content-loaded-already to not be loaded again when click later
+  * Ajax error handling: when .load() callback returns a textStatus 'error', the browser is reloaded to better show the error
+  * Bugfix: include other params if present in the default tab link url
+
+### v1.3 (2011-09-12) ###
+
+  * Gem converted into a Rails 3.1 Engine that uses the asset pipeline to serve the jquery.bettertabs plugin
+  * Test dummy app converted to Rails 3.1
+
+### v1.2.3 (2011-06-23) ###
+
+  * Tested with Rails 3.0.9 and HAML 3.1.2
+  * Bugfix on the bettertabs helper inline script, avoid to add it as an HTML attribute
+
+### v1.2.1 (2011-05-02) ###
+
+  * Bugfix on the bettertabs helper inline script
+
+### v1.2 (2011-05-02) ###
+
+  * Added :attach_jquery_bettertabs_inline option to the helper, defaults to true. If false, do not render the inline script that activates the plugin.
+  * Bettertabs jQuery plugin improvement:
+    * Exposed the change_browser_url method to global access in jQuery.Bettertabs.change_browser_url(url), so it can be used and overwritten by other scripts
+    * Created the jQuery.Bettertabs.select_tab(bettertabs_id, tab_id) method to easily select a tab from other scripts
+    * Improved the README.md JavaScript section with more clear examples
+
+### v1.1 (2011-04-28) ###
+
+  * Added :ajax_url option to tab builder, defaults to :url plus the ajax=true param to prevent browser cache issues.
+  * bettertabs helper :class html_option replace the 'bettertabs' default class instead of adding it (there was no way to remove that class).
+  * Bugfix: don't add .hidden CSS class to non active tabs (it should only be added to non active content).
+  * Documentation improvement:
+    * Added jquery.bettertabs documentation (REAMDE.md)
+    * Added some CSS examples and documentation (lib/bettertabs/stylesheets/README.md)
+    * README.md review and clean-up, moved examples to EXAMPLES.md.
+    * Added Routes examples (README.md)
+    * Added bettertabs helper documentation (params and options in the method comment)
+
+### v1.0 (2011-04-22) ###
+
+  * bettertabs rails helper, with static, link and ajax tabs
+  * jquery.bettertabs plugin, that activate the clicked tab, loads ajax content and change the url using HTML history.replaceState() javascript method.
+  * README.md documentation improved with examples
+  * Rails3 (ruby 1.9.2) test application (in the test folder) with some use cases and some basic rspec tests.
+
+### v0.0.1 (2011-03-31) ###
+
+  * Initial development and structure for the gem
+  * Initial documentation (README.md file)

data/Gemfile

@@ -17,4 +17,5 @@ source "http://rubygems.org"
 gem "rails", ">= 3.1.0"
 gem "jquery-rails"
 gem "haml-rails"
-gem "rspec-rails"
+gem "rspec-rails"
+gem "webrat"

data/Gemfile.lock

@@ -51,6 +51,7 @@ GEM
       treetop (~> 1.4.8)
     mime-types (1.17.2)
     multi_json (1.1.0)
+    nokogiri (1.5.2)
     polyglot (0.3.3)
     rack (1.4.1)
     rack-cache (1.2)
@@ -100,6 +101,10 @@ GEM
       polyglot
       polyglot (>= 0.3.1)
     tzinfo (0.3.32)
+    webrat (0.7.3)
+      nokogiri (>= 1.2.0)
+      rack (>= 1.0)
+      rack-test (>= 0.5.3)
 
 PLATFORMS
   ruby
@@ -109,3 +114,4 @@ DEPENDENCIES
   jquery-rails
   rails (>= 3.1.0)
   rspec-rails
+  webrat

data/README.md

@@ -24,7 +24,7 @@ The bettertabs gem includes a dummy test app, that is used for development (to e
 
   * [Try online the demo app](http://bettertabs-demo.herokuapp.com)
   * Or to run it on your machine:
-        
+
         $ git clone git://github.com/agoragames/bettertabs.git
         $ cd bettertabs
         /bettertabs$ bundle install
@@ -32,11 +32,9 @@ The bettertabs gem includes a dummy test app, that is used for development (to e
 
 
 ## Requirements: ##
-  * Ruby 1.9.2
-  * Rails 3.1+
-  * [jquery-rails](https://github.com/rails/jquery-rails) with jQuery 1.3 or higher
-
-Anyway you can use bettertabs without javascript (or use your own javascript handler) since the bettertabs helper only generates the appropriate markup.
+  * Ruby 1.9
+  * Rails 3.1 or higher
+  * jQuery 1.3 or higher (but bettertabs also works without javascript)
 
 
 ## Install ##
@@ -56,6 +54,21 @@ Or if you prefer the compressed version:
 
 This works the same way as [jquery-rails](https://github.com/rails/jquery-rails); you don't need to copy-paste the javascript code in your app because it will be served using the Asset Pipeline.
 
+Use the bettertabs helper to define your view (see usage and examples below).
+
+And finally, apply the javascript behavior to the generated markup. For this, you can simply add a line of jQuery in your application.js file to apply the bettertabs jquery plugin to the bettertabs helper generated markup:
+
+    jQuery('.bettertabs').bettertabs(); // apply bettertabs to any element with the bettertabs css class
+
+You can instead avoid this line of javascript by allowing the helper to add inline javascript along with the generated markup. For that you can create an initializer (e.g. `app/config/initializers/bettertabs.rb`) to change the default configuration:
+
+    Bettertabs.configure do |config|
+      # Render a Javascript snippet to initialize the tabs automatically after rendering the tabs.
+      # This requires that you include jQuery before the tabs are rendered.
+      # Default: false
+      # config.attach_jquery_bettertabs_inline = true
+    end
+
 ## Usage and examples ##
 
 Bettertabs supports three kinds of tabs:
@@ -63,6 +76,7 @@ Bettertabs supports three kinds of tabs:
   * **Link Tabs**: Loads only the active tab contents; when click on another tab, go to the specified URL. No JavaScript needed.
   * **Static Tabs**: Loads all content of all static tabs, but only show the active content; when click on another tab, activate its related content. When JavaScript disabled, it behaves like *link tabs*.
   * **Ajax Tabs**: Loads only the active tab contents; when click on another tab, loads its content via ajax and show. When JavaScript disabled, it behaves like *link tabs*.
+  * **Only Content**: You can also add a block of content that is always visible (with no tab)
 
 An usage example should be self explanatory (using HAML, but it also works with ERB and other template systems):
 
@@ -70,9 +84,9 @@ An usage example should be self explanatory (using HAML, but it also works with
       = tab.static :general, 'My Profile' do
         %h2 General Info
         = show_user_general_info(@user)
-          
-      = tab.ajax :friends, :partial => 'shared/friends'
-      
+
+      = tab.ajax :friends, :partial => 'shared/friends', :locals => { :user => @user }
+
       = tab.link :groups do
         = render :partial => 'groups/user_groups', :locals => { :user => @user }
 
@@ -86,7 +100,7 @@ The option `:selected_tab` specifies the default selected tab, when the page is
   * [Bettertabs CSS reference guide](https://github.com/agoragames/bettertabs/blob/master/doc/STYLESHEETS-GUIDE.md)
   * [Bettertabs helper](https://github.com/agoragames/bettertabs/blob/master/app/helpers/bettertabs_helper.rb) (params and options)
   * [Test Dummy Rails 3.1 application](https://github.com/agoragames/bettertabs/tree/master/spec/dummy) that has some usage examples
-  
+
 
 ## Tabs Routes ##
 
@@ -102,7 +116,7 @@ in a view accessible by a route like this:
 
     match 'profile/:nickname', :to => 'profiles#lookup', :as => 'profile'
 
-When you go to `/profile/dude`, your tabs links will have the following hrefs: 
+When you go to `/profile/dude`, your tabs links will have the following hrefs:
 
   * :general tab href: `/profile/dude?profile_tabs_selected_tab=general`
   * :friends tab href: `/profile/dude?profile_tabs_selected_tab=friends`
@@ -117,8 +131,8 @@ So now the tabs links will point to the following URLs:
 
   * :general tab href: `/profile/dude/general`
   * :friends tab href: `/profile/dude/friends`
-  
-  
+
+
 ## JavaScript with the jquery.bettertabs plugin #
 
 The bettertabs helper will generate the needed markup that has an inline script at the bottom:
@@ -132,7 +146,7 @@ You can see the jquery.bettertabs source code in the github repo:
   * [CoffeeScript version](https://github.com/agoragames/bettertabs/raw/master/app/assets/javascripts/jquery.bettertabs.js.coffee)
   * [JavaScript (generated by coffee) version](https://github.com/agoragames/bettertabs/raw/master/app/assets/javascripts/jquery.bettertabs.js)
   * [Compressed JavaScript](https://github.com/agoragames/bettertabs/raw/master/app/assets/javascripts/jquery.bettertabs.min.js)
-  
+
 The plugin defines one single jQuery method `jQuery(selector).bettertabs();` that is applied to the generated markup.
 
 This script will take the tab type from each tab link `data-tab-type` attribute (that can be "link", "static" or "ajax"), and will match each tab with its content using the tab link `data-show-content-id` attribute, that is the id of the related content.
@@ -159,7 +173,7 @@ You can interact with the bettertabs widget in the following ways:
   * **Hook some behavior when a tab is clicked**: attach a 'click' handler to the tab link or use any of the provided custom events.
   * **Show a loading clock while ajax is loading**: or any other kind of feedback to the user, use any of the provided custom events. You can also handle it styling the CSS class `.ajax-loading` that is added to the ajax tab link while ajax content is loading (see the [Styles Reference Guide](https://github.com/agoragames/bettertabs/blob/master/doc/STYLESHEETS-GUIDE.md))
   * **Change the browser URL**: in the same way the plugin does when a tab is clicked, use `jQuery.Bettertabs.change_browser_url(new_url);`
-  
+
 Custom events that are attached to each tab content:
 
   * *'bettertabs-before-deactivate'*:   fired on content that is active and will be deactivated
@@ -175,7 +189,7 @@ Usage example of custom events:
     $("#profile_tabs_friends_content").bind('bettertabs-after-activate', function(){
       alert('friends content is visible');
     });
-    
+
     // Display the $('#loading-clock') element while ajax tabs are loading
     $("#profile_tabs").bind('bettertabs-before-ajax-loading', function(){
       $('#loading-clock').show();
@@ -187,26 +201,23 @@ Usage example of custom events:
 ## CSS Styles ##
 
 Bettertabs provides a rails helper to generate HTML and a jQuery plugin as JavaScript, but not any CSS styles because those are very different for each project and can not be abstracted into a common purpose CSS stylesheet.
-  
+
 Perhaps the most important CSS rule here is to define `display: none;` for `div.content.hidden`, because contents are never hidden using the jquery.hide() method or similar. The jquery.bettertabs plugin just adds the `.active` class to the active tab and active content, and the `.hidden` class to the non active content. You will need to use a CSS rule like this:
 
       div.bettertabs div.content.hidden { display: none; }
 
 Use the [Bettertabs CSS Guidelines](https://github.com/agoragames/bettertabs/blob/master/doc/STYLESHEETS-GUIDE.md) to get a stylesheet that you can use as a starting point.
 
+## Changelog ##
 
-## How to help make Bettertabs even Better ##
- 
+See the [CHANGELOG](https://github.com/agoragames/bettertabs/blob/master/CHANGELOG.md) file.
+
+## Contributing to bettertabs ##
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
 * Fork the project
 * Start a feature/bugfix branch
 * Commit and push until you are happy with your contribution
 * Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
 * Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-
-## Future work ##
-
-  * Try to make it compatible with ruby 1.8.x
-  * Improve tests to check the JavaScript code (Jasmine, Evergreen, Capybara, whatever)
-  

data/app/assets/javascripts/jquery.bettertabs.js

@@ -1,11 +1,11 @@
 (function() {
   /*!
    jQuery Bettertabs Plugin
-   version: 1.3.6 (Mar-12-2012)
+   version: 1.4 (Mar-12-2012)
    @requires jQuery v1.3 or later
-   
+
    Examples and documentation at: https://github.com/agoragames/bettertabs
-   
+
    Copyright (c) 2011 Mario Izquierdo (tothemario@gmail.com)
    Dual licensed under the MIT and GPL licenses:
      http://www.opensource.org/licenses/mit-license.php
@@ -38,7 +38,7 @@
       wrapper = $(this);
       tabs = wrapper.find('ul.tabs > li');
       tabs_links = wrapper.find('ul.tabs > li > a');
-      tabs_contents = wrapper.children('.content');
+      tabs_contents = wrapper.children('.content:not(.content-only-block)');
       tabs_and_contents = tabs.add(tabs_contents);
       active_tab_link = tabs_links.filter('.active');
       if (tab_type_of(active_tab_link) === 'ajax') {

data/app/assets/javascripts/jquery.bettertabs.js.coffee

@@ -1,10 +1,10 @@
 ###!
  jQuery Bettertabs Plugin
- version: 1.3.6 (Mar-12-2012)
+ version: 1.4 (Mar-12-2012)
  @requires jQuery v1.3 or later
- 
+
  Examples and documentation at: https://github.com/agoragames/bettertabs
- 
+
  Copyright (c) 2011 Mario Izquierdo (tothemario@gmail.com)
  Dual licensed under the MIT and GPL licenses:
    http://www.opensource.org/licenses/mit-license.php
@@ -28,7 +28,7 @@ $.Bettertabs =
     # so better not to use pushState (because we can't safely revert to previous state), replaceState just works fine.
     if history? and history.replaceState?
       history.replaceState null, document.title, url
-      
+
   # jQuery.Bettertabs.select_tab(bettertabs_id, tab_id) => click on the tab_id link of the bettertabs_id widget
   select_tab: (bettertabs_id, tab_id) ->
     $("##{tab_id}_#{bettertabs_id}_tab a").click()
@@ -38,13 +38,13 @@ $.fn.bettertabs = ->
     wrapper = $(this)
     tabs = wrapper.find 'ul.tabs > li'
     tabs_links = wrapper.find 'ul.tabs > li > a'
-    tabs_contents = wrapper.children '.content'
+    tabs_contents = wrapper.children '.content:not(.content-only-block)'
     tabs_and_contents = tabs.add tabs_contents
     active_tab_link = tabs_links.filter '.active'
-    
+
     # When tab-type is ajax, mark the first active link as content-loaded-already to not be loaded again when click later
     active_tab_link.data('content-loaded-already', yes) if tab_type_of(active_tab_link) is 'ajax'
-    
+
     tabs_links.click (event) ->
       this_link = $(this)
       unless tab_type_of(this_link) is 'link'
@@ -64,10 +64,10 @@ $.fn.bettertabs = ->
             previous_active_tab_content.trigger 'bettertabs-after-deactivate'
             this_tab_content.trigger 'bettertabs-after-activate'
             $.Bettertabs.change_browser_url this_link.attr('href')
-          
+
           previous_active_tab_content.trigger 'bettertabs-before-deactivate'
           this_tab_content.trigger 'bettertabs-before-activate'
-          
+
           if tab_type_of(this_link) is 'ajax' and not this_link.data('content-loaded-already')?
             this_link.addClass('ajax-loading')
             this_tab_content.trigger 'bettertabs-before-ajax-loading'

data/app/assets/javascripts/jquery.bettertabs.min.js

@@ -1,7 +1,7 @@
 (function(){
 /*!
    jQuery Bettertabs Plugin
-   version: 1.3.6 (Mar-12-2012)
+   version: 1.4 (Mar-12-2012)
    @requires jQuery v1.3 or later
 
    Examples and documentation at: https://github.com/agoragames/bettertabs
@@ -11,4 +11,4 @@
      http://www.opensource.org/licenses/mit-license.php
      http://www.gnu.org/licenses/gpl.html
   */
-var d,f,c,b,a,e;d=jQuery;a="data-tab-type";b="data-show-content-id";f="data-ajax-url";e=function(g){return g.attr(a)};c=function(g){return g.attr(b)};d.Bettertabs={change_browser_url:function(g){if((typeof history!=="undefined"&&history!==null)&&(history.replaceState!=null)){return history.replaceState(null,document.title,g)}},select_tab:function(h,g){return d("#"+g+"_"+h+"_tab a").click()}};d.fn.bettertabs=function(){this.each(function(){var g,i,k,h,j,l;l=d(this);i=l.find("ul.tabs > li");j=l.find("ul.tabs > li > a");h=l.children(".content");k=i.add(h);g=j.filter(".active");if(e(g)==="ajax"){g.data("content-loaded-already",true)}return j.click(function(p){var r,s,o,n,q,m;n=d(this);if(e(n)!=="link"){p.preventDefault();q=n.parent();if(!q.hasClass("active")&&!n.hasClass("ajax-loading")){m=h.filter("#"+(c(n)));s=i.filter(".active");o=h.filter(".active");r=function(){i.removeClass("active");j.removeClass("active");h.removeClass("active").addClass("hidden");q.addClass("active");n.addClass("active");m.removeClass("hidden").addClass("active");o.trigger("bettertabs-after-deactivate");m.trigger("bettertabs-after-activate");return d.Bettertabs.change_browser_url(n.attr("href"))};o.trigger("bettertabs-before-deactivate");m.trigger("bettertabs-before-activate");if(e(n)==="ajax"&&!(n.data("content-loaded-already")!=null)){n.addClass("ajax-loading");m.trigger("bettertabs-before-ajax-loading");return m.load(n.attr(f),function(u,v,t){if(v==="error"){return window.location=n.attr("href")}else{n.removeClass("ajax-loading");n.data("content-loaded-already",true);m.trigger("bettertabs-after-ajax-loading");return r()}})}else{return r()}}}})});return this}}).call(this);
+var d,f,c,b,a,e;d=jQuery;a="data-tab-type";b="data-show-content-id";f="data-ajax-url";e=function(g){return g.attr(a)};c=function(g){return g.attr(b)};d.Bettertabs={change_browser_url:function(g){if((typeof history!=="undefined"&&history!==null)&&(history.replaceState!=null)){return history.replaceState(null,document.title,g)}},select_tab:function(h,g){return d("#"+g+"_"+h+"_tab a").click()}};d.fn.bettertabs=function(){this.each(function(){var g,i,k,h,j,l;l=d(this);i=l.find("ul.tabs > li");j=l.find("ul.tabs > li > a");h=l.children(".content:not(.content-only-block)");k=i.add(h);g=j.filter(".active");if(e(g)==="ajax"){g.data("content-loaded-already",true)}return j.click(function(p){var r,s,o,n,q,m;n=d(this);if(e(n)!=="link"){p.preventDefault();q=n.parent();if(!q.hasClass("active")&&!n.hasClass("ajax-loading")){m=h.filter("#"+(c(n)));s=i.filter(".active");o=h.filter(".active");r=function(){i.removeClass("active");j.removeClass("active");h.removeClass("active").addClass("hidden");q.addClass("active");n.addClass("active");m.removeClass("hidden").addClass("active");o.trigger("bettertabs-after-deactivate");m.trigger("bettertabs-after-activate");return d.Bettertabs.change_browser_url(n.attr("href"))};o.trigger("bettertabs-before-deactivate");m.trigger("bettertabs-before-activate");if(e(n)==="ajax"&&!(n.data("content-loaded-already")!=null)){n.addClass("ajax-loading");m.trigger("bettertabs-before-ajax-loading");return m.load(n.attr(f),function(u,v,t){if(v==="error"){return window.location=n.attr("href")}else{n.removeClass("ajax-loading");n.data("content-loaded-already",true);m.trigger("bettertabs-after-ajax-loading");return r()}})}else{return r()}}}})});return this}}).call(this);

data/app/helpers/bettertabs_helper.rb

@@ -9,13 +9,13 @@ module BettertabsHelper
   #       - tab.static :tab2_id, 'Tab2', options2
   #       - tab.ajax :tab3_id, 'Tab3', options3
   #
-  # === bettertabs params
+  # === bettertabs arguments
   #   * bettertabs_id: will be used as html id of the wrapper element, and as part of the inner ids.
   #                     Note: is usually better to use a Symbol (with underscores) here to avoid problems defining routes.
   #   * options:
-  #       * :selected_tab => tab_id of the default selected tab.
-  #                       This is overriden by the appropiate param params[:"#{bettertabs_id}_selected_tab"], 
-  #                       so any tab can be selected using the URL parmas. 
+  #       * :selected_tab => tab_id of the default selected tab. Alias :selected
+  #                       This is overriden by the appropiate param params[:"#{bettertabs_id}_selected_tab"],
+  #                       so any tab can be selected using the URL parmas.
   #                       :selected_tab only defines which tab is selected when no {bettertabs_id}_selected_tab param is present.
   #       * :render_only_active_content => if true, this helper renders only the selected tab contents (no wrapper, no tabs, only content).
   #                       Default to true only if controller.request.xhr? or params[:ajax].present? (true when its an ajax request).
@@ -24,22 +24,22 @@ module BettertabsHelper
   #       * :id => html id attribute of the wrapper element. By default is the bettertabs_id
   #       * Any other option will be used as wrapper elmenet html attribute.
   #
-  # ==== tab builder params
+  # ==== tab builder arguments
   # Tab builder descriptor:
   #     tab.link(tab_id, options={}, &block)
   #     tab.link(tab_id, tab_text, options={}, &block)
   #
-  # Params:
-  #   * tab_id: the tab item html id will be "#{tab_id}_#{bettertabs_id}_tab", 
+  # Arguments:
+  #   * tab_id: the tab item html id will be "#{tab_id}_#{bettertabs_id}_tab",
   #                     and the content wrapper id will be "#{tab_id}_#{bettertabs_id}_content".
   #                     Also the tab_id is used to identify this tab in the bettertabs :selected_tab option.
-  #   * tab_text: is the content of the tab link. Defaults to tab_id.to_s.titleize
+  #   * tab_text: content of the tab link. Defaults to tab_id.to_s.titleize
   #   * options:
   #       * :partial => Partial to render as content. Defaults to *tab_id*, but if &block given it captures the block instead of render partial.
-  #                     If you need to suply locals to the partial, use a block with a render(:partial => partial, :locals => {locals}) call.
+  #       * :locals => Hash of local variables for the partial.
   #       * :url => href of the tab link. For link tabs, this is the href to go when click.
   #                 For ajax and static tabs, this is the url to replace in the browser when click (HTML5 history.replaceState()), and also the url
-  #                 to use if JavaSciprt is disabled. 
+  #                 to use if JavaSciprt is disabled.
   #                 Defaults to { :"#{bettertabs_id}_selected_tab" => tab_id }, that is the current URL plus the selected tab param.
   #       * :ajax_url => used as data-ajax-url html5 attribute in the link tab, that will be used in the jquery.bettertabs plugin as ajax href where to
   #                 make the ajax request to get the tab content.
@@ -49,16 +49,17 @@ module BettertabsHelper
   #
   def bettertabs(bettertabs_id, options={})
     bettertabs_id = bettertabs_id.to_s
-    selected_tab_id = params[:"#{bettertabs_id}_selected_tab"] || options.delete(:selected_tab)
-    options[:class] ||= "bettertabs"
+    selected_tab_id = params[:"#{bettertabs_id}_selected_tab"] || options.delete(:selected_tab) || options.delete(:selected)
+    options[:class] ||= ''
+    options[:class] += ' bettertabs'
     options[:id] ||= bettertabs_id
     options[:render_only_active_content] = controller.request.xhr? unless options.include?(:render_only_active_content)
-    attach_jquery_bettertabs_inline = options.include?(:attach_jquery_bettertabs_inline) ? options.delete(:attach_jquery_bettertabs_inline) : true
+    attach_jquery_bettertabs_inline = options.include?(:attach_jquery_bettertabs_inline) ? options.delete(:attach_jquery_bettertabs_inline) : Bettertabs.configuration.attach_jquery_bettertabs_inline
     builder = BettertabsBuilder.new(bettertabs_id, self, selected_tab_id, options)
     yield(builder)
     b = builder.render
     b += javascript_tag("jQuery(function($){ $('##{options[:id]}').bettertabs(); });") if attach_jquery_bettertabs_inline
     b
   end
-  
-end
+
+end

data/doc/EXAMPLES.md

@@ -41,7 +41,7 @@ In partial `app/views/home/_mytabs.html.erb`:
       <%= tab.static :about, 'Who am I?', :partial => '/shared/about' %>
       <%= tab.static :contact_me %>
     <% end %>
-     
+
 
 The :about and :contact_me tabs will get the content from the referenced partials. Put any content there, for example:
 
@@ -53,7 +53,7 @@ In partial `app/views/home/_contact_me.html.erb`:
 
     <h2>How to contact me:<h2/>
     <p><%= @contact_info.inspect %></p>
-    
+
 In controller `app/controllers/home_controller.rb`:
 
     class HomeController < ApplicationController
@@ -79,21 +79,21 @@ Ajax tabs perform an asynchronous call to get the content before showing it. Giv
 supposing the bettertabs_id is :mytabs, it will generate the following markup for the tab item:
 
     <li id="home_mytabs_tab">
-      <a data-tab-type="ajax" 
-         data-show-content-id="home_mytabs_content" 
-         data-ajax-url="/home/ajax_tab" 
+      <a data-tab-type="ajax"
+         data-show-content-id="home_mytabs_content"
+         data-ajax-url="/home/ajax_tab"
          href="/home/index">
          Home
       </a>
     </li>
-    
+
 The attributes *data-tab-type*, *data-show-content-id* and *data-ajax-url* will be used by the jquery.bettertabs plugin.
 
 So here there are two important options:
 
   * :url => The tag link href. Is used to change the browser url (html5 browsers only) and as url when JavaScript is off. Default to current url plus the param `#{bettertabs_id}_selected_tab=#{tab_id}`.
   * :ajax_url => Defaults to :url plus the param `ajax=true`. Is used to perform the ajax request.
-  
+
 Both options have a default value, so if you just write:
 
     tab.ajax :home
@@ -101,9 +101,9 @@ Both options have a default value, so if you just write:
 supposing the bettertabs_id is :mytabs, and the current url is '/home', it will generate the following markup for the tab item:
 
     <li id="home_mytabs_tab">
-      <a data-tab-type="ajax" 
-         data-show-content-id="home_mytabs_content" 
-         data-ajax-url="/home?mytabs_selected_tab=home&ajax=true" 
+      <a data-tab-type="ajax"
+         data-show-content-id="home_mytabs_content"
+         data-ajax-url="/home?mytabs_selected_tab=home&ajax=true"
          href="/home?mytabs_selected_tab=home">
          Home
       </a>
@@ -135,7 +135,7 @@ In partial `app/views/home/_mytabs.html.erb`:
       <%= tab.ajax :about, 'Who am I?', :partial => '/shared/about' %>
       <%= tab.ajax :contact_me %>
     <% end %>
-     
+
 **Note** that the only difference between this example and the *static tabs example* is to use `tab.ajax` declaration instead of `tab.static`.
 
 Partials `app/views/shared/_about.html.erb` and `app/views/home/_contact_us.html.erb` (same as in the *static tabs example*).
@@ -156,7 +156,7 @@ In controller `app/controllers/home_controller.rb`, you can load only the needed
         when 'contact_us' then
           @contact_info = { :address => 'The Hell', :telephone => '666'}
         end
-        
+
         # When ajax, render only the selected tab content (handled by bettertabs helper)
         render :partial => 'mytabs' and return if request.xhr? # you can also check if params[:ajax].present?
       end
@@ -177,36 +177,50 @@ Since the *mytabs* partial just contains the bettertabs helper, and bettertabs h
     * to send the link to other person and he/she will open the selected tab
   * Easily change the behavior of a tab to be `ajax`, `static` or `link`. It always work.
   * Keep your views DRY, clean and readable
-  
 
-## Example using HAML and ruby1.9.2 ##
+## Adding Blocks Of Content with no Tabs
+
+Sometimes is possible you want to add inline content that has to be always visible, for example if the tabs are a form and you want to show the "save" button, taking advantage of the easy styling:
+
+    <%= bettertabs :mytabs do |tab| %>
+      <%= tab.static :personal_data %>
+      <%= tab.static :credit_card %>
+      <%= tab.static :bonus_fields %>
+
+      <%= tab.only_content_block do %>
+        <%= button_tag 'Save' %>
+      <% end %>
+
+    <% end %>
+
+## Example using HAML and ruby1.9 ##
 
 Is easy to mix all types of tabs, and customize them using the provided options:
-  
-    = bettertabs :bettertabs_example, :selected_tab => :chooseme, :class => 'bettertabs example' do |tab|
-    
+
+    = bettertabs :bettertabs_example, :selected_tab => :chooseme, :class => 'bettertabs example', :list_html_options => {:class => 'list_class'} do |tab|
+
       = tab.static :simplest_tab, class: 'awesome-tab' do
         Click this tab to see this content.
-        
+
       = tab.static :chooseme, 'Please, Click me!' # as default, renders partial: 'chooseme'
-        
+
       = tab.static :render_another_partial, partial: 'another_partial'
-      
+
       = tab.link :link_to_another_place, url: go_to_other_place_url  # will make a new request
-        
+
       = tab.ajax :cool_ajax, ajax_url: remote_call_path, partial: 'cool_partial'
       -# In this case, you shoud take care of that remote_call_path is using the same partial: 'cool_partial'
-      
+
       = tab.ajax :album, url: url_for(@album), partial: 'shared/album'
       -# This one will make the ajax call to the ajax_url: url_for(@album, :ajax => true)
-      
+
       = tab.ajax :ajax_tab, title: 'Content is loaded only once'
 
 
 ## More documentation ##
 
   * [Main README document](https://github.com/agoragames/bettertabs/blob/master/README.md)
-  * [Bettertabs Styles reference guide](https://github.com/agoragames/bettertabs/blob/master/lib/bettertabs/stylesheets/README.md)
-  * [Bettertabs helper](https://github.com/agoragames/bettertabs/blob/master/lib/bettertabs/bettertabs_helper.rb) (params and options)
-  * [Rails3 test demo application](https://github.com/agoragames/bettertabs/tree/master/test/ruby_1_9/rails_3_0)
-  * Anyway, don't be afraid of digging into the code, it's very straightforward.
+  * [Bettertabs Styles reference guide](https://github.com/agoragames/bettertabs/blob/master/doc/STYLESHEETS-GUIDE.md)
+  * [Bettertabs helper](https://github.com/agoragames/bettertabs/blob/master/app/helpers/bettertabs_helper.rb) (params and options)
+  * [Rails3 test demo application](https://github.com/agoragames/bettertabs/tree/master/spec/dummy)
+  * Anyway, don't be afraid of digging into the code, it's very straightforward.