jordanyeo-simple-navigation 3.11.0

data/spec/lib/simple_navigation/rendering/renderer/base_spec.rb

@@ -0,0 +1,199 @@
+require 'spec_helper'
+
+describe SimpleNavigation::Renderer::Base do
+  before(:each) do
+    @options = stub(:options).as_null_object
+    @adapter = stub(:adapter)
+    SimpleNavigation.stub!(:adapter => @adapter)
+    @base_renderer = SimpleNavigation::Renderer::Base.new(@options)
+  end
+  
+  describe 'delegated methods' do
+    it {@base_renderer.should respond_to(:link_to)}
+    it {@base_renderer.should respond_to(:content_tag)}
+  end
+
+  describe 'initialize' do
+    it {@base_renderer.adapter.should == @adapter}
+    it {@base_renderer.options.should == @options}
+  end
+    
+  describe 'render' do
+    it "be subclass responsability" do
+      lambda {@base_renderer.render(:container)}.should raise_error('subclass responsibility')
+    end
+  end
+    
+  describe 'expand_all?' do
+    context 'option is set' do
+      context 'expand_all is true' do
+        before(:each) do
+          @base_renderer.stub!(:options => {:expand_all => true})
+        end
+        it {@base_renderer.expand_all?.should be_true}
+      end
+      context 'expand_all is false' do
+        before(:each) do
+          @base_renderer.stub!(:options => {:expand_all => false})
+        end
+        it {@base_renderer.expand_all?.should be_false}
+      end
+    end
+    context 'option is not set' do
+      before(:each) do
+        @base_renderer.stub!(:options => {})
+      end
+      it {@base_renderer.expand_all?.should be_false}
+    end
+  end
+
+  describe 'skip_if_empty?' do
+    context 'option is set' do
+      context 'skip_if_empty is true' do
+        before(:each) do
+          @base_renderer.stub!(:options => {:skip_if_empty => true})
+        end
+        it {@base_renderer.skip_if_empty?.should be_true}
+      end
+      context 'skip_if_empty is false' do
+        before(:each) do
+          @base_renderer.stub!(:options => {:skip_if_empty => false})
+        end
+        it {@base_renderer.skip_if_empty?.should be_false}
+      end
+    end
+    context 'option is not set' do
+      before(:each) do
+        @base_renderer.stub!(:options => {})
+      end
+      it {@base_renderer.skip_if_empty?.should be_false}
+    end
+  end
+
+  describe 'level' do
+    context 'options[level] is set' do
+      before(:each) do
+        @base_renderer.stub!(:options => {:level => 1})
+      end
+      it {@base_renderer.level.should == 1}
+    end
+    context 'options[level] is not set' do
+      before(:each) do
+        @base_renderer.stub!(:options => {})
+      end
+      it {@base_renderer.level.should == :all}
+    end
+  end
+
+  describe 'consider_sub_navigation?' do
+    before(:each) do
+      @item = stub(:item)
+    end
+    context 'item has no subnavigation' do
+      before(:each) do
+        @item.stub!(:sub_navigation => nil)
+      end
+      it {@base_renderer.send(:consider_sub_navigation?, @item).should be_false}
+    end
+    context 'item has subnavigation' do
+      before(:each) do
+        @sub_navigation = stub(:sub_navigation)
+        @item.stub!(:sub_navigation => @sub_navigation)
+      end
+      context 'level is something unknown' do
+        before(:each) do
+          @base_renderer.stub!(:level => 'unknown')
+        end
+        it {@base_renderer.send(:consider_sub_navigation?, @item).should be_false}
+      end
+      context 'level is :all' do
+        before(:each) do
+          @base_renderer.stub!(:level => :all)
+        end
+        it {@base_renderer.send(:consider_sub_navigation?, @item).should be_true}
+      end
+      context 'level is an Integer' do
+        before(:each) do
+          @base_renderer.stub!(:level => 2)
+        end
+        it {@base_renderer.send(:consider_sub_navigation?, @item).should be_false}
+      end
+      context 'level is a Range' do
+        before(:each) do
+          @base_renderer.stub!(:level => 2..3)
+        end
+        context 'subnavs level > range.max' do
+          before(:each) do
+            @sub_navigation.stub!(:level => 4)
+          end
+          it {@base_renderer.send(:consider_sub_navigation?, @item).should be_false}
+        end
+        context 'subnavs level = range.max' do
+          before(:each) do
+            @sub_navigation.stub!(:level => 3)
+          end
+          it {@base_renderer.send(:consider_sub_navigation?, @item).should be_true}
+
+        end
+        context 'subnavs level < range.max' do
+          before(:each) do
+            @sub_navigation.stub!(:level => 2)
+          end
+          it {@base_renderer.send(:consider_sub_navigation?, @item).should be_true}
+        end
+      end
+    end
+  end
+
+  describe 'include_sub_navigation?' do
+    before(:each) do
+      @item = stub(:item)
+    end
+    context 'consider_sub_navigation? is true' do
+      before(:each) do
+        @base_renderer.stub!(:consider_sub_navigation? => true)
+      end
+      context 'expand_sub_navigation? is true' do
+        before(:each) do
+          @base_renderer.stub!(:expand_sub_navigation? => true)
+        end
+        it {@base_renderer.include_sub_navigation?(@item).should be_true}
+      end
+      context 'expand_sub_navigation? is false' do
+        before(:each) do
+          @base_renderer.stub!(:expand_sub_navigation? => false)
+        end
+        it {@base_renderer.include_sub_navigation?(@item).should be_false}
+      end
+    end
+    context 'consider_sub_navigation is false' do
+      before(:each) do
+        @base_renderer.stub!(:consider_sub_navigation? => false)
+      end
+      context 'expand_sub_navigation? is true' do
+        before(:each) do
+          @base_renderer.stub!(:expand_sub_navigation? => true)
+        end
+        it {@base_renderer.include_sub_navigation?(@item).should be_false}
+      end
+      context 'expand_sub_navigation? is false' do
+        before(:each) do
+          @base_renderer.stub!(:expand_sub_navigation? => false)
+        end
+        it {@base_renderer.include_sub_navigation?(@item).should be_false}
+      end
+    end
+  end
+
+  describe 'render_sub_navigation_for' do
+    before(:each) do
+      @sub_navigation = stub(:sub_navigation)
+      @item = stub(:item, :sub_navigation => @sub_navigation)
+    end
+    it "should call render on the sub_navigation (passing the options)" do
+      @sub_navigation.should_receive(:render).with(@options)
+      @base_renderer.render_sub_navigation_for(@item)
+    end
+  end
+
+end

data/spec/lib/simple_navigation/rendering/renderer/breadcrumbs_spec.rb

@@ -0,0 +1,101 @@
+require 'spec_helper'
+require 'html/document'# unless defined? HTML::Document
+
+describe SimpleNavigation::Renderer::Breadcrumbs do
+
+  describe 'render' do
+
+    def render(current_nav=nil, options={:level => :all})
+      primary_navigation = primary_container
+      select_item(current_nav) if current_nav
+      setup_renderer_for SimpleNavigation::Renderer::Breadcrumbs, :rails, options
+      HTML::Document.new(@renderer.render(primary_navigation)).root
+    end
+
+    context 'regarding result' do
+
+      it "should render a div-tag around the items" do
+          HTML::Selector.new('div').select(render).should have(1).entries
+        end
+        it "the rendered div-tag should have the specified dom_id" do
+          HTML::Selector.new('div#nav_dom_id').select(render).should have(1).entries
+        end
+        it "the rendered div-tag should have the specified class" do
+          HTML::Selector.new('div.nav_dom_class').select(render).should have(1).entries
+        end
+
+        context 'without current_navigation set' do
+          it "should not render any a-tag in the div-tag" do
+            HTML::Selector.new('div a').select(render).should have(0).entries
+          end
+        end
+
+      context 'with current_navigation set' do
+        before(:each) do
+          @selection = HTML::Selector.new('div a').select(render(:invoices))
+        end
+        it "should render the selected a tags" do
+          @selection.should have(1).entries
+        end
+
+        it "should not render class or id" do
+          @selection.each do |tag|
+            raise unless tag.name == "a"
+            tag["id"].should be_nil
+            tag["class"].should be_nil
+          end
+        end
+
+        context 'with allow_classes_and_ids option' do
+          before(:each) do
+            @selection = HTML::Selector.new('div a').select(render(:users, :level => :all, :allow_classes_and_ids => true))
+          end
+          it "should render class and id" do
+            @selection.each do |tag|
+              raise unless tag.name == "a"
+              tag["id"].should_not be_nil
+              tag["class"].should_not be_nil
+            end
+          end
+        end
+
+        context 'with prefix option' do
+          it 'should render prefix before breadcrumbs' do
+            selection = HTML::Selector.new('div').select(render(:subnav1, :level => :all, :prefix => 'You are here: '))
+            raise unless selection.count == 1
+            tag = selection.first
+            tag.to_s.should =~ /^\<div.+\>You are here\: /
+          end
+
+          it 'should not render prefix if there is no available breadcrumb' do
+            allow_message_expectations_on_nil
+            selection = HTML::Selector.new('div').select(render('', :prefix => 'You are here: '))
+            tag = selection.first
+            tag.to_s.should =~ /^\<div.+\>\<\/div\>/
+          end
+        end
+
+        context 'with static_leaf option' do
+          before(:each) do
+            @selection = HTML::Selector.new('div *').select(render(:subnav1, :level => :all, :static_leaf => true))
+          end
+          it "should render link for non-leaes" do
+            @selection[0..-2].each do |tag|
+              tag.name.should == 'a'
+            end
+          end
+          it "should not render link for leaf" do
+            @selection.last.name.should == 'span'
+          end
+        end
+      end
+
+
+      context 'nested sub_navigation' do
+        it "should add an a tag for each selected item" do
+          HTML::Selector.new('div a').select(render(:subnav1)).should have(2).entries
+        end
+      end
+    end
+  end
+end

data/spec/lib/simple_navigation/rendering/renderer/json_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe SimpleNavigation::Renderer::Json do
+
+  describe 'render' do
+
+    def render(current_nav=nil, options={})
+      primary_navigation = primary_container
+      select_item(current_nav)
+      setup_renderer_for SimpleNavigation::Renderer::Json, :rails, options
+      @renderer.render(primary_navigation)
+    end
+
+    def prerendered_menu
+      '[{"name":"users","url":"first_url","selected":false,"items":null},{"name":"invoices","url":"second_url","selected":true,"items":[{"name":"subnav1","url":"subnav1_url","selected":false,"items":null},{"name":"subnav2","url":"subnav2_url","selected":false,"items":null}]},{"name":"accounts","url":"third_url","selected":false,"items":null},{"name":"miscellany","url":null,"selected":false,"items":null}]'
+    end
+
+    context 'regarding result' do
+
+      it "should return a string" do
+        render(:invoices).class.should == String
+      end
+
+      it "should render the selected page" do
+        json = parse_json(render(:invoices))
+        found = json.any? do |item| 
+          item["name"] == "invoices" and item["selected"]
+        end
+        found.should == true
+      end
+
+    end
+
+    context 'regarding hash result' do
+      it "should return a hash" do
+        render(:invoices, :as_hash => true).class.should == Array
+      end
+
+      it "should render the selected page" do
+        found = render(:invoices, :as_hash => true).any? do |item|
+          item[:name] == "invoices" and item[:selected]
+        end
+        found.should == true
+      end
+
+    end
+  end
+end

data/spec/lib/simple_navigation/rendering/renderer/links_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+require 'html/document' unless defined? HTML::Document
+
+describe SimpleNavigation::Renderer::Links do
+
+    
+  describe 'render' do
+
+    def render(current_nav=nil, options={:level => :all})
+      primary_navigation = primary_container
+      select_item(current_nav) if current_nav
+      setup_renderer_for SimpleNavigation::Renderer::Links, :rails, options
+      HTML::Document.new(@renderer.render(primary_navigation)).root
+    end
+
+    context 'regarding result' do
+
+      it "should render a div-tag around the items" do
+        HTML::Selector.new('div').select(render).should have(1).entries
+      end
+      it "the rendered div-tag should have the specified dom_id" do
+        HTML::Selector.new('div#nav_dom_id').select(render).should have(1).entries
+      end
+      it "the rendered div-tag should have the specified class" do
+        HTML::Selector.new('div.nav_dom_class').select(render).should have(1).entries
+      end
+      it "should render an a-tag for each item" do
+        HTML::Selector.new('a').select(render).should have(3).entries
+      end
+      it "should pass the specified html_options to the a element" do
+        HTML::Selector.new('a[style=float:right]').select(render).should have(1).entries
+      end
+      it "should give the a-tag the id specified in the html_options" do
+        HTML::Selector.new('a#my_id').select(render).should have(1).entries
+      end
+      it "should give the a-tag the default id (stringified key) if no id is specified in the html_options" do
+        HTML::Selector.new('a#invoices').select(render).should have(1).entries
+      end
+      it "should not apply the the default id where there is an id specified in the html_options" do
+        HTML::Selector.new('a#users').select(render).should be_empty
+      end
+
+      context 'with current_navigation set' do
+        it "should mark the matching a-item as selected (with the css_class specified in configuration)" do
+          HTML::Selector.new('a.selected').select(render(:invoices)).should have(1).entries
+        end
+      end
+
+      context 'without current_navigation set' do
+        it "should not mark any of the items as selected" do
+          HTML::Selector.new('a.selected').select(render).should be_empty
+        end
+      end
+
+      context 'with a custom seperator specified' do
+        it "should separate the items with the separator" do
+          HTML::Selector.new('div').select_first(render(:subnav1, :join_with => " | ")).to_s.split(" | ").should have(4).entries
+        end
+      end
+  
+    end
+    
+  end
+end

data/spec/lib/simple_navigation/rendering/renderer/list_spec.rb

@@ -0,0 +1,211 @@
+require 'spec_helper'
+require 'html/document' unless defined? HTML::Document
+
+describe SimpleNavigation::Renderer::List do
+
+  describe 'render' do
+
+    def render(current_nav=nil, options={:level => :all})
+      primary_navigation = primary_container
+      select_item(current_nav) if current_nav
+      setup_renderer_for SimpleNavigation::Renderer::List, :rails, options
+      HTML::Document.new(@renderer.render(primary_navigation)).root
+    end
+
+    context 'regarding result' do
+
+      it "should render a ul-tag around the items" do
+        HTML::Selector.new('ul').select(render).should have(1).entries
+      end
+      it "the rendered ul-tag should have the specified dom_id" do
+        HTML::Selector.new('ul#nav_dom_id').select(render).should have(1).entries
+      end
+      it "the rendered ul-tag should have the specified class" do
+        HTML::Selector.new('ul.nav_dom_class').select(render).should have(1).entries
+      end
+      it "should render a li tag for each item" do
+        HTML::Selector.new('li').select(render).should have(4).entries
+      end
+      it "should render an a-tag inside each li-tag (for items with links)" do
+        HTML::Selector.new('li a').select(render).should have(3).entries
+      end
+      it "should render a span-tag inside each li-tag (for items without links)" do
+        HTML::Selector.new('li span').select(render).should have(1).entries
+      end
+
+      context 'concerning item names' do
+        context 'with a custom name generator defined' do
+          before(:each) do
+            SimpleNavigation.config.stub!(:name_generator => Proc.new {|name| "<span>name</span>"})
+          end
+          it "should apply the name generator" do
+            HTML::Selector.new('li a span').select(render).should have(3).entries
+          end
+        end
+        context 'no customer generator defined' do
+          before(:each) do
+            SimpleNavigation.config.stub!(:name_generator => Proc.new {|name| "name"})
+          end
+          it "should apply the name generator" do
+            HTML::Selector.new('li a span').select(render).should have(0).entries
+          end
+        end
+      end
+
+      context 'concerning html attributes' do
+        context 'default case (no options defined for link tag)' do
+          it "should pass the specified html_options to the li element" do
+            HTML::Selector.new('li[style=float:right]').select(render).should have(1).entries
+          end
+          it "should give the li the id specified in the html_options" do
+            HTML::Selector.new('li#my_id').select(render).should have(1).entries
+          end
+          it "should give the li the default id (stringified key) if no id is specified in the html_options" do
+            HTML::Selector.new('ul li#invoices').select(render).should have(1).entries
+          end
+          it "should not apply the the default id where there is an id specified in the html_options" do
+            HTML::Selector.new('ul li#users').select(render).should be_empty
+          end
+        end
+        context 'with attributes defined for the link tag as well' do
+          it "should add the link attributes to the link" do
+            HTML::Selector.new('a[style=float:left]').select(render).should have(1).entries
+          end
+          it "should add the li attributes to the li element" do
+            HTML::Selector.new('li[style=float:right]').select(render).should have(1).entries
+          end
+          it "should give the li the default id (stringified key) if no id is specified in the html_options for the li-element" do
+            HTML::Selector.new('ul li#invoices').select(render).should have(1).entries
+          end
+          it "should not apply the the default id where there is an id specified in the html_options for th li-element" do
+            HTML::Selector.new('ul li#users').select(render).should be_empty
+          end
+        end
+      end
+      
+      context 'with current_navigation set' do
+        it "should mark the matching li-item as selected (with the css_class specified in configuration)" do
+          HTML::Selector.new('li.selected').select(render(:invoices)).should have(1).entries
+        end
+        it "should also mark the links inside the selected li's as selected" do
+          HTML::Selector.new('li.selected a.selected').select(render(:invoices)).should have(1).entries
+        end
+      end
+
+      context 'without current_navigation set' do
+        it "should not mark any of the items as selected" do
+          HTML::Selector.new('li.selected').select(render).should be_empty
+        end
+        it "should not mark any links as selected" do
+          HTML::Selector.new('a.selected').select(render).should be_empty
+        end
+      end
+
+      context 'nested sub_navigation' do
+        it "should nest the current_primary's subnavigation inside the selected li-element" do
+          HTML::Selector.new('li.selected ul li').select(render(:invoices)).should have(2).entries
+        end
+        it "should be possible to identify sub items using an html selector (using ids)" do
+          HTML::Selector.new('#invoices #subnav1').select(render(:invoices)).should have(1).entries
+        end
+        context 'expand_all => false' do
+          it "should not render the invoices submenu if the user-primary is active" do
+            HTML::Selector.new('#invoices #subnav1').select(render(:users, :level => :all, :expand_all => false)).should be_empty
+            HTML::Selector.new('#invoices #subnav2').select(render(:users, :level => :all, :expand_all => false)).should be_empty
+          end
+        end
+
+        context 'expand_all => true' do
+          it "should render the invoices submenu even if the user-primary is active" do
+            HTML::Selector.new('#invoices #subnav1').select(render(:users, :level => :all, :expand_all => true)).should have(1).entry
+            HTML::Selector.new('#invoices #subnav2').select(render(:users, :level => :all, :expand_all => true)).should have(1).entry
+          end
+        end
+
+      end
+
+      context 'skip_if_empty' do
+
+        def render_container(options={})
+          setup_renderer_for SimpleNavigation::Renderer::List, :rails, options
+          HTML::Document.new(@renderer.render(@container)).root
+        end
+
+        context 'container is empty' do
+          before(:each) do
+            @container = SimpleNavigation::ItemContainer.new(0)
+          end
+          context 'skip_if_empty is true' do
+            it "should not render a ul tag for the empty container" do
+              HTML::Selector.new('ul').select(render_container(:skip_if_empty => true)).should be_empty
+            end
+          end
+          context 'skip_if_empty is false' do
+            it "should render a ul tag for the empty container" do
+              HTML::Selector.new('ul').select(render_container(:skip_if_empty => false)).should have(1).entry
+            end
+          end
+        end
+
+        context 'container is not empty' do
+          before(:each) do
+            @container = primary_container
+          end
+          context 'skip_if_empty is true' do
+            it "should render a ul tag for the container" do
+              HTML::Selector.new('ul').select(render_container(:skip_if_empty => true)).should have(1).entry
+            end
+          end
+          context 'skip_if_empty is false' do
+            it "should render a ul tag for the container" do
+              HTML::Selector.new('ul').select(render_container(:skip_if_empty => false)).should have(1).entry
+            end
+          end
+        end
+      end
+    end
+    
+    describe 'link_options_for' do
+      before(:each) do
+        setup_renderer_for SimpleNavigation::Renderer::List, :rails, {}
+      end
+      context 'no link options specified' do
+        context 'method specified' do
+          context 'item selected' do
+            before(:each) do
+              @item = stub(:item, :method => :delete, :selected_class => 'selected', :html_options => {})
+            end
+            it {@renderer.send(:link_options_for, @item).should == {:method => :delete, :class => 'selected'}}
+          end
+          context 'item not selected' do
+            before(:each) do
+              @item = stub(:item, :method => :delete, :selected_class => nil, :html_options => {})
+            end
+            it {@renderer.send(:link_options_for, @item).should == {:method => :delete}}
+          end
+        end
+        context 'method not specified' do
+          context 'item selected' do
+            before(:each) do
+              @item = stub(:item, :method => nil, :selected_class => 'selected', :html_options => {})
+            end
+            it {@renderer.send(:link_options_for, @item).should == {:class => 'selected'}}
+          end
+          context 'item not selected' do
+            before(:each) do
+              @item = stub(:item, :method => nil, :selected_class => nil, :html_options => {})
+            end
+            it {@renderer.send(:link_options_for, @item).should == {}}
+          end        
+        end
+      end
+      context 'link options specified' do
+        before(:each) do
+          @item = stub(:item, :method => :delete, :selected_class => 'selected', :html_options => {:link => {:class => 'link_class', :style => 'float:left'}})
+        end
+        it {@renderer.send(:link_options_for, @item).should == {:method => :delete, :class => 'link_class selected', :style => 'float:left'}}
+      end
+    end
+    
+  end
+end