Contents

# 
# = Tabs on Rails
#
# A simple Ruby on Rails plugin for creating and managing Tabs.
# 
#
# Category::    Rails
# Package::     TabsOnRails
# Author::      Simone Carletti <[e-mail]>
# License::     MIT License
#
#--
#
#++


module TabsOnRails
  class Tabs

    #
    # = Tabs Builder
    # 
    # The TabsBuilder is and example of custom Builder.
    # It creates a new tab
    #
    class TabsBuilder < Builder

      # Implements Builder#tab_for.
      # Returns a link_to +tab+ with +name+ and +options+ if +tab+ is not the current tab,
      # a simple tab name wrapped by a span tag otherwise.
      # 
      #   current_tab? :foo   # => true
      # 
      #   tab_for :foo, 'Foo', foo_path
      #   # => <li><span>Foo</span></li>
      # 
      #   tab_for :bar, 'Bar', bar_path
      #   # => <li><a href="/link/to/bar">Bar</a></li>
      # 
      def tab_for(tab, name, options)
        content = @context.link_to_unless(current_tab?(tab), name, options) do
          @context.content_tag(:span, name)
        end
        @context.content_tag(:li, content)
      end

      # Implements Builder#open_tabs.
      # 
      # Returns an unordered list open tag.
      # The <tt>options</tt> is used to customize the HTML attributes of the tag.
      #
      #   open_tag
      #   # => "<ul>"
      #
      #   open_tag :class => "centered"
      #   # => "<ul class=\"centered\">"
      #
      def open_tabs(options = {})
        @context.tag("ul", options, open = true)
      end

      # Implements Builder#close_tabs.
      # 
      # Returns an unordered list close tag.
      # The <tt>options</tt> hash is ignored. It exists only for 
      # coeherence with the parent Builder API.
      #
      #   close_tag
      #   # => "</ul>"
      #
      #   close_tag :class => "centered"
      #   # => "</ul>"
      #
      def close_tabs(options = {})
        "</ul>"
      end

    end

  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
tabs_on_rails-1.1.0	lib/tabs_on_rails/tabs/tabs_builder.rb
tabs_on_rails-1.0.0	lib/tabs_on_rails/tabs/tabs_builder.rb