navigation_builder 1.0.0.beta2 → 1.0.0.beta3

data/README.md

@@ -66,6 +66,38 @@ And in your layout:
       <%= nav.link_to 'Home', '#' %>
     <% end %>
 
+#### I need to do something special after the third link! ####
+
+    <% navigation_for :main, do |nav| %>
+      <%= nav.link_to 'Home', '#' %>
+      <%- if nav.item_count = 3 -%>
+        Something Special
+      <%- end -%>
+    <% end %>
+
+That's probably a poor example. The usefulness of the `item_count` attribute is more apparent when you create a custom NavigationBuilder.
+
+For instance, you can use it to automatically add the class `"first"`:
+
+    module NavigationBuilders
+      class FancyPantsNavigation < ActionView::Helpers::NavigationBuilder
+      
+        def link_to_in_html( name, options, html_options )
+          if item_count == 0
+            html_options[:item_html] ||= { :class => '' }
+            html_options[:item_html][:class] = " #{html_options[:item_html][:class]} first".strip
+          end
+          
+          super
+        end
+        
+      end
+    end
+
+##### You can do that with CSS you know... #####
+
+If you don't have to support IE6, then yes, you can.
+
 #### Well... what if I need an Ordered List! ####
 
     <% navigation_for :main, :wrapper_tag => :ol do |nav| %>
@@ -80,7 +112,7 @@ Generates:
       </li>
     </ol>
 
-#### Nevermind, I hate lists. I just want DIVs. ####
+#### Nevermind. I hate lists. I just want DIVs. ####
 
     <% navigation_for :main, :nav_item_tag => :div do |nav| %>
       <%= nav.link_to 'Home', '#' %>
@@ -102,7 +134,7 @@ Generates:
 
     <a href="#" class="selected">Home</a>
 
-#### Why didn't you name this Gem "Wolfman" ####
+#### Why didn't you name this Gem ["Wolfman"](http://en.wikipedia.org/wiki/Top_Gun#Cast) ####
 
 Originally I was going to. But if you came across a method named "wolfman" in your view code, it would not be entirely clear as to what it was going to do.
 So I just went with something boring and generic.
@@ -115,5 +147,3 @@ TODOs
 =====
 
 * Rails 3 support
-* Add test for "selected" class when there is no item tag
-* Add test for thrown exception when setting a selected link after a nav block has already been rendered.

data/VERSION

@@ -1 +1 @@
-1.0.0.beta2
+1.0.0.beta3

data/lib/action_view/helpers/navigation_builder.rb

@@ -61,9 +61,12 @@ module ActionView
 
     class NavigationBuilder
 
+      attr_reader :item_count
+
       # Initializes the NavigationBuilder.
       # You'll mostly likely never call this method directly.
       def initialize( template, nav_name, options, proc )
+        @item_count = 0
         @template, @nav_name, @options, @proc = template, nav_name, options, proc
       end
 
@@ -72,6 +75,11 @@ module ActionView
       #
       # Example:
       #   <%= nav.link_to 'Home', '#' %>
+      #
+      # This will also increment the item_count once the link's markup has been generated.
+      # This allows you to special case link_to options based on the index of current link
+      # in your customized implementations of the Navigation Builder.
+      # ---
       def link_to( *args, &link_block )
         if block_given?
           name         = @template.capture(&link_block)
@@ -85,7 +93,7 @@ module ActionView
           html_options = args[2] || {}
 
           link_to_in_html( name, options, html_options )
-        end
+        end.tap { @item_count += 1 } # Increment the number of links generated (and still return markup)
       end
 
     private

data/navigation_builder.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{navigation_builder}
-  s.version = "1.0.0.beta2"
+  s.version = "1.0.0.beta3"
 
   s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
   s.authors = ["Derek Lindahl"]
-  s.date = %q{2011-05-23}
+  s.date = %q{2011-05-26}
   s.description = %q{NavigationBuilder makes creating navigational links in a Rails application a breeze.}
   s.email = %q{dlindahl@customink.com}
   s.extra_rdoc_files = [

data/test/test_navigation_builder.rb

@@ -28,6 +28,17 @@ class TestNavigationBuilder < ActionView::TestCase
     assert_dom_equal expected, output_buffer
   end
 
+  should "know how many links have been rendered" do
+    count = 0
+    navigation_for :main do |nav|
+      concat nav.link_to( 'Foo', '#' )
+      concat nav.link_to( 'Bar', '#' )
+      count = nav.item_count
+    end
+
+    assert_equal 2, count
+  end
+
   should "generate HTML with custom wrapper tag name" do
     navigation_for :main, :wrapper_tag => :ol do |nav|
       concat nav.link_to( 'Foo', '#' )

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: navigation_builder
 version: !ruby/object:Gem::Version 
-  hash: 62196359
+  hash: 62196357
   prerelease: 6
   segments: 
   - 1
   - 0
   - 0
   - beta
-  - 2
-  version: 1.0.0.beta2
+  - 3
+  version: 1.0.0.beta3
 platform: ruby
 authors: 
 - Derek Lindahl
@@ -17,7 +17,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-23 00:00:00 -04:00
+date: 2011-05-26 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency