simple_navigation_renderers 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 75c2d6062eed56d76c167e010f5b7aed27febb81
+  data.tar.gz: a33a8834eab2ee4956a7085b9866c8ce1731ae34
+SHA512:
+  metadata.gz: 6294b0a57fb7f3d55845674ea6cf1e956be576a6ba4c275b07918355af5e39f92644e18630df4cf37125f4770ef05ce83e8d037ad641a527220dfaa84c1d8da1
+  data.tar.gz: 58c7f34eac95c85d521db3bb89000155907c3445771a68bb71c0a892e153923174f53214a462258dba29312e9f48b78a17b552146cb4e44dca4d7d00943a05b0

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+doc/
+pkg
+rdoc
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color -f d

data/.rvmrc

@@ -0,0 +1 @@
+rvm use ruby-2.0.0-p247@simple_navigation_renderers

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## v0.0.1
+
+* Bootstrap 2 and Bootstrap 3 renderers

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in simple_navigation_renderers.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Pavel Shpak
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,187 @@
+# SimpleNavigationRenderers
+
+This gem adds several [Simple Navigation](https://github.com/andi/simple-navigation) renderers.  
+For now, it is include renderers for:
+* [Bootstrap 2 navigation](http://getbootstrap.com/components/#navbar)
+* [Bootstrap 3 navigation](http://getbootstrap.com/2.3.2/components.html#navbar)
+
+With these renderers you can create any bootstrap navigation elements, such as: submenus, dividers, headers. As well as add icons to menu elements, such as: gliphicons, font-awesome icons, even custom icons.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    ```ruby
+    gem 'simple_navigation_renderers'
+    ```
+
+and then execute:
+
+    ```console
+    $ bundle
+    ```
+
+Or install it yourself as:
+
+    ```console
+    $ gem install simple_navigation_renderers
+    ```
+
+
+## Usage
+
+### Set up renderer
+
+There are two ways to say that you want to use any of renderers.
+
+1. You can specify it in you view as a parameter to `render_navigation`:
+
+    ```erb
+    <nav class="navbar navbar-default navbar-fixed-top" role="navigation">
+      <div class="container">
+        <div class="navbar-header">
+          <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-ex1-collapse">
+            <span class="sr-only">Toggle navigation</span>
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+          </button>
+          <%= link_to "Name", root_path, class: "navbar-brand" %>
+        </div>
+        <div class="collapse navbar-collapse navbar-ex1-collapse">
+
+          <%= render_navigation( expand_all: true, renderer: :bootstrap3 ) %>
+
+        </div>
+      </div>
+    </nav>
+    ```
+
+2. Or you can set it in the very navigation configuration file (e.g. `config/navigation.rb`):
+
+    ```ruby
+    SimpleNavigation::Configuration.run do |navigation|
+      navigation.renderer = SimpleNavigationRenderers::Bootstrap2
+      # navigation itself goes here...
+    end
+    ```
+
+### Define navigation items
+
+I think you already using `simple-navigation` gem and know how to define navigation items.  
+If not, you can always look at the [configuration instructions](https://github.com/andi/simple-navigation/wiki/Configuration) on the Simple Navigation wiki or read comments and examples in the generated by default `config/navigation.rb` file.
+
+In addition to standard options you can use ones specific for Bootstrap renderers.  
+Lets look at the example:
+
+    ```ruby
+    SimpleNavigation::Configuration.run do |navigation|
+      navigation.renderer = SimpleNavigationRenderers::Bootstrap3
+      navigation.items do |primary|
+        primary.item :news, {icon: "fa fa-fw fa-bullhorn", text: "News"}, news_index_path, highlights_on: :subpath
+        primary.item :concerts, "Concerts", concerts_path, highlights_on: :subpath
+        primary.item :video, "Video", videos_path, highlights_on: :subpath
+        primary.item :info, {icon: "fa fa-fw fa-book", title: "Info"}, info_index_path, divider: true, split: true, highlights_on: :subpath do |info_nav|
+          info_nav.item :main_info_page, "Main info page", info_path(:main_info_page)
+          info_nav.item :about_info_page, "About", info_path(:about_info_page)
+          info_nav.item :misc_info_pages, "Misc.", divider: true do |misc_page|
+            misc_page.item :header_misc_pages, "Misc. Pages", header: true
+            Info.all.each do |info_page|
+              misc_page.item :"#{info_page.permalink}", info_page.title, info_path(info_page)
+            end
+          end
+          info_nav.item :contact_info_page, "Contact", info_path(:contact_info_page), divider: true
+        end
+      end
+    end
+    ```
+
+Specific options used in the example:
+
+* `:split` - Use it to split first level item link with caret. If you add `split: true` option to item, then caret itself will toggle first level submenu and link will have standard behaviour, instead of toggle submenu. You can use `:split` only with first level items, for the rest it will not do anything.
+* `:divider` - Use it to add Bootstrap divider before item. if you add `divider: true` option to first level item, then it will first create addition li-tag with `divider-vertical` Bootstrap 2 class and after that create li-tag for item itself. (You can add `divider-vertical` class to Bootstrap 3 - see below) For the second level item and deeper it will create li-tag with class `divider` (the same in Bootstrap 2 and 3)
+* `:header` - Use it to add Bootstrap menu header. If you add `header: true` option to item, then all parameters, except `:name` and `:divider` option, will be ignored. You can use `:header` only with submenus, for the first level items it will not do anything.
+* `:name hash` - Use it in place of `:name` if you want. Hash can have three keys: `:text`, `:icon` and `:title`, which is only recognized. You can use it together or separatly, but at least one of `:text` and `:icon` parameters should be provided. For example:
+  * `{text: "News", icon: "fa fa-fw fa-bullhorn"}` will create Font Awesome icon and add text after it (name of the item)
+  * `{icon: "glyphicon glyphicon-book", title: "Info"}` will create Bootstrap icon with title without any text after it
+
+#### Caveats
+
+1. Bootstrap 3 has only one level submenu. If you want to use nested submenus as in example above, import `bootstrap2_dropdown_submenu.css.scss` file into your Sass file (e.g. `application.css.scss`) as following:
+
+    ```scss
+    @import "bootstrap2_dropdown_submenu";
+    ```
+
+2. Bootstrap 3 has not `divider-vertical` class. If you want to use it as in example above, import `bootstrap2_navbar_divider_vertical.css.scss` file:
+
+    ```scss
+    @import "bootstrap2_navbar_divider_vertical";
+    ```
+
+3. You may also want to include following file which changes some first level submenu style:
+
+    ```scss
+    @import "simple_navigation_bootstrap_overrides";
+    ```
+
+or you can add them all together:
+
+    ```scss
+    @import "simple_navigation_bootstrap";
+    ```
+
+#### Result
+
+Thus, above example will produce something like following code:
+
+    ```html
+    <ul class="nav navbar-nav">
+      <li class="active simple-navigation-active-leaf" id="news">
+        <a href="/news_index_path"><span class="fa fa-fw fa-bullhorn"></span> News</a>
+      </li>
+      <li id="concerts"><a href="/concerts_path">Concerts</a></li>
+      <li id="video"><a href="/videos_path">Video</a></li>
+      <li class="divider-vertical"></li>
+      <li class="dropdown-split-left" id="info">
+        <a href="/info_index_path"><span class="fa fa-fw fa-book" title="Info"></span></a>
+      </li>
+      <li class="dropdown dropdown-split-right">
+        <a class="dropdown-toggle" data-target="#" data-toggle="dropdown" href="#"><b class="caret"></b></a>
+        <ul class="pull-right dropdown-menu">
+          <li id="main_info_page"><a href="/info/main_info_page">Main info page</a></li>
+          <li id="about_info_page"><a href="/info/about_info_page">About</a></li>
+          <li class="divider"></li>
+          <li class="dropdown-submenu" id="misc_info_pages">
+            <a href="#">Misc.</a>
+            <ul class="dropdown-menu">
+              <li class="dropdown-header">Misc. Pages</li>
+              <li id="page1"><a href="/info/page1">Page1</a></li>
+              <li id="page2"><a href="/info/page2">Page2</a></li>
+            </ul>
+          </li>
+          <li class="divider"></li>
+          <li id="contact_info_page"><a href="/info/contact_info_page">Contact</a></li>
+        </ul>
+      </li>
+    </ul>
+    ```
+
+
+## Test
+
+Just run following commands:
+
+    ```console
+    $ bundle
+    $ rake
+    ```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/simple_navigation_renderers.rb

@@ -0,0 +1,11 @@
+require "simple-navigation"
+require "simple_navigation_renderers/exceptions"
+require "simple_navigation_renderers/bootstrap"
+require "simple_navigation_renderers/engine" if defined? Rails::Engine
+require "simple_navigation_renderers/version"
+
+module SimpleNavigationRenderers
+end
+
+SimpleNavigation.register_renderer :bootstrap2 => SimpleNavigationRenderers::Bootstrap2
+SimpleNavigation.register_renderer :bootstrap3 => SimpleNavigationRenderers::Bootstrap3

data/lib/simple_navigation_renderers/bootstrap.rb

@@ -0,0 +1,107 @@
+module SimpleNavigationRenderers
+
+  module Bootstrap
+
+    def render( item_container )
+      config_selected_class = SimpleNavigation.config.selected_class
+      SimpleNavigation.config.selected_class = "active"
+      @config_name_generator = SimpleNavigation.config.name_generator
+      SimpleNavigation.config.name_generator = self.method(:name_generator)
+
+      item_container.dom_class = [ item_container.dom_class,
+                                   (item_container.level == 1) ? "nav#{(options[:bv] == 2) ? '' : ' navbar-nav'}" :
+                                                                 "dropdown-menu" ].flatten.compact.join(' ')
+      
+      list_content = item_container.items.inject([]) do |list, item|
+        li_options = item.html_options
+
+        if li_options.delete(:divider)
+          if (item_container.level != 1)
+            list << content_tag(:li, '', {class: "divider"})
+          else
+            list << content_tag(:li, '', {class: "divider-vertical"})
+          end
+        end
+
+        if li_options.delete(:header) && (item_container.level != 1)
+          list << content_tag(:li, item.name, { class: ((options[:bv] == 2) ? "nav-header" : "dropdown-header") })
+        else
+
+          link_options = li_options.delete(:link) || {}
+          split = li_options.delete(:split)
+          li_content = if include_sub_navigation?(item)
+            if item_container.level == 1
+              if split
+                main_li_options = li_options.dup
+                main_li_options[:class] = [ main_li_options[:class], "dropdown-split-left" ].flatten.compact.join(' ')
+                list << content_tag(:li, simple_link(item, link_options), main_li_options)
+                li_options[:id] = nil
+                item.sub_navigation.dom_class = [ item.sub_navigation.dom_class, "pull-right" ].flatten.compact.join(' ')
+              end
+              li_options[:class] = [ li_options[:class], "dropdown", (split ? "dropdown-split-right" : nil) ].flatten.compact.join(' ')
+              dropdown_link(item, split, link_options) + render_sub_navigation_for(item)
+            else
+              li_options[:class] = [ li_options[:class], "dropdown-submenu"].flatten.compact.join(' ')
+              simple_link(item, link_options) + render_sub_navigation_for(item)
+            end
+          else
+            simple_link(item, link_options)
+          end
+          list << content_tag(:li, li_content, li_options)
+
+        end
+      end.join
+
+      SimpleNavigation.config.selected_class = config_selected_class
+      SimpleNavigation.config.name_generator = @config_name_generator
+
+      (skip_if_empty? && item_container.empty?) ? '' :
+        content_tag(:ul, list_content, {id: item_container.dom_id, class: item_container.dom_class})
+    end
+
+
+    protected
+
+      def simple_link( item, link_options )
+        link_options[:method] ||= item.method
+        link_to(item.name, (item.url || "#"), link_options)
+      end
+
+      def dropdown_link( item, split, link_options )
+        link_options = {} if split
+        link_options[:class] = [ link_options[:class], "dropdown-toggle" ].flatten.compact.join(' ')
+        link_options[:"data-toggle"] = "dropdown"
+        link_options[:"data-target"] = "#"
+        link = [ (split ? nil : item.name), content_tag(:b, '', class: "caret") ].compact.join(' ')
+        link_to(link, "#", link_options)
+      end
+
+      def name_generator( name )
+        if name.instance_of?(Hash)
+          raise SimpleNavigationRenderers::InvalidHash unless name.keys.include?(:icon) || name.keys.include?(:text)
+          [ (name[:icon] ? content_tag(:span, '', {class: name[:icon]}.merge(name[:title] ? {title: name[:title]} : {}) ) : nil), name[:text] ].compact.join(' ')
+        else
+          @config_name_generator.call(name)
+        end
+      end
+
+  end
+
+
+  class Bootstrap2 < SimpleNavigation::Renderer::Base
+    include SimpleNavigationRenderers::Bootstrap
+
+    def initialize( options )
+      super( options.merge!({bv: 2}) ) # add bootstrap version option
+    end
+  end
+
+  class Bootstrap3 < SimpleNavigation::Renderer::Base
+    include SimpleNavigationRenderers::Bootstrap
+
+    def initialize( options )
+      super( options.merge!({bv: 3}) ) # add bootstrap version option
+    end
+  end
+
+end

data/lib/simple_navigation_renderers/engine.rb

@@ -0,0 +1,4 @@
+module SimpleNavigationRenderers
+  class Engine < ::Rails::Engine
+  end
+end

data/lib/simple_navigation_renderers/exceptions.rb

@@ -0,0 +1,8 @@
+module SimpleNavigationRenderers
+  # Exception raised when you set Hash without both 'text' and 'icon' parameters as Item 'name' parameter 
+  class InvalidHash < StandardError
+    def initialize( msg = "Hash does not contain any of parameters: 'text', 'icon'" )
+      super
+    end
+  end
+end

data/lib/simple_navigation_renderers/version.rb

@@ -0,0 +1,3 @@
+module SimpleNavigationRenderers
+  VERSION = "0.0.1"
+end

data/simple_navigation_renderers.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'simple_navigation_renderers/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "simple_navigation_renderers"
+  spec.version       = SimpleNavigationRenderers::VERSION
+  spec.authors       = ["Pavel Shpak"]
+  spec.email         = ["shpakvel@gmail.com"]
+  spec.description   = %q{simple_navigation_renderers gem adds renderers for Bootstrap 2 and 3. With these renderers you can create any bootstrap navigation elements, such as: submenus, dividers, headers. As well as add icons to menu elements, such as: gliphicons, font-awesome icons, even custom icons. }
+  spec.summary       = %q{simple_navigation_renderers gem adds renderers for Bootstrap 2 and 3. With these renderers you can create any bootstrap navigation elements, such as: submenus, dividers, headers. As well as add icons to menu elements, such as: gliphicons, font-awesome icons, even custom icons. }
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "simple-navigation", "~> 3.11"
+
+  spec.add_development_dependency "actionpack"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/spec/lib/simple_navigation_renderers/bootstrap_spec.rb

@@ -0,0 +1,197 @@
+require 'spec_helper'
+require 'html/document' unless defined? HTML::Document
+
+describe SimpleNavigationRenderers::Bootstrap do
+
+  describe '.render' do
+
+    # 'bv' is bootstrap version
+    # 'stub_name' neads to check raising error when invalid 'Item name hash' provided
+    def render_result( bv=3, stub_name=false )
+      SimpleNavigation::Configuration.instance.renderer = (bv == 3) ? SimpleNavigationRenderers::Bootstrap3 : SimpleNavigationRenderers::Bootstrap2
+
+      SimpleNavigation.stub(adapter: ( SimpleNavigation::Adapters::Rails.new( double(:context, view_context: ActionView::Base.new) )) )
+
+      SimpleNavigation::Item.any_instance.stub( selected?: false, selected_by_condition?: false )
+      primary_navigation = SimpleNavigation::ItemContainer.new(1)
+      fill_in( primary_navigation ) # helper method
+      primary_navigation.items.find { |item| item.key == :news }.stub( selected?: true, selected_by_condition?: true )
+
+      primary_navigation.items[0].instance_variable_set(:@name, {}) if stub_name
+
+      HTML::Document.new( primary_navigation.render(expand_all: true) ).root
+    end
+
+
+
+    context "for 'bootstrap3' renderer" do
+      it "wraps main menu in ul-tag with 'nav navbar-nav' classes" do
+        HTML::Selector.new('ul.nav.navbar-nav').select(render_result).should have(1).entries
+      end
+    end
+
+    context "for 'bootstrap2' renderer" do
+      it "wraps main menu in ul-tag with 'nav' class" do
+        HTML::Selector.new('ul.nav.navbar-nav').select(render_result(2)).should have(0).entries
+        HTML::Selector.new('ul.nav').select(render_result(2)).should have(1).entries
+      end
+    end
+
+    it "sets up 'active' class on selected items (on li-tags)" do
+      HTML::Selector.new('ul.nav.navbar-nav > li.active > a[href="news_index_path"]').select(render_result).should have(1).entries
+    end
+
+    it "wraps submenu in ul-tag 'dropdown-menu' class" do
+      HTML::Selector.new('ul > li > ul.dropdown-menu > li > ul.dropdown-menu').select(render_result).should have(1).entries
+    end
+
+    context "for the first level submenu (the second level menu)" do
+      it "sets up 'dropdown' class on li-tag which contains that submenu" do
+        HTML::Selector.new('ul > li.dropdown').select(render_result).should have(1).entries
+      end
+
+      it "sets up 'dropdown-toggle' class on link-tag which is used for toggle that submenu" do
+        HTML::Selector.new('ul > li.dropdown > a.dropdown-toggle').select(render_result).should have(1).entries
+      end
+
+      it "sets up 'data-toggle' attribute to 'dropdown' on link-tag which is used for toggle that submenu" do
+        HTML::Selector.new('ul > li.dropdown > a[data-toggle=dropdown]').select(render_result).should have(1).entries
+      end
+
+      it "sets up 'data-target' attribute to '#' on link-tag which is used for toggle that submenu" do
+        HTML::Selector.new('ul > li.dropdown > a[data-target=#]').select(render_result).should have(1).entries
+      end
+
+      it "sets up 'href' attribute to '#' on link-tag which is used for toggle that submenu" do
+        HTML::Selector.new('ul > li.dropdown > a[href=#]').select(render_result).should have(1).entries
+      end
+
+      it "puts b-tag with 'caret' class in li-tag which contains that submenu" do
+        HTML::Selector.new('ul > li.dropdown > a[href=#] > b.caret').select(render_result).should have(1).entries
+      end
+    end
+
+    context "for nested submenu (the third level menu and deeper)" do
+      it "sets up 'dropdown-submenu' class on li-tag which contains that submenu" do
+        HTML::Selector.new('ul > li > ul.dropdown-menu > li.dropdown-submenu').select(render_result).should have(1).entries
+      end
+    end
+
+
+
+    context "when ':split' option provided" do
+      context "for the first level item which contains submenu" do
+        it "splits item on two li-tags (left and right) and right li-tag will contain the first level submenu (second level menu)" do
+          HTML::Selector.new('ul > li.dropdown-split-left + li.dropdown.dropdown-split-right > ul.dropdown-menu').select(render_result).should have(1).entries
+        end
+
+        it "sets up 'pull-right' class on ul-tag which is the submenu" do
+          HTML::Selector.new('ul > li > ul.dropdown-menu.pull-right').select(render_result).should have(1).entries
+        end
+      end
+
+      context "for the second level item and deeper which contains submenu" do
+        it "does not splits item on two li-tags" do
+          HTML::Selector.new('ul.dropdown-menu > li.dropdown-split-left + li.dropdown.dropdown-split-right > ul.dropdown-menu').select(render_result).should have(0).entries
+          HTML::Selector.new('ul.dropdown-menu > li.dropdown-submenu > ul.dropdown-menu').select(render_result).should have(1).entries
+        end
+
+        it "does not sets up 'pull-right' class on ul-tag which is the submenu" do
+          HTML::Selector.new('ul.dropdown-menu > li > ul.dropdown-menu.pull-right').select(render_result).should have(0).entries
+        end
+      end
+
+      context "for item which does not contain submenu" do
+        it "does not splits item on two li-tags" do
+          HTML::Selector.new('ul > li.to_check_split.dropdown-split-left + li.dropdown.dropdown-split-right').select(render_result).should have(0).entries
+          HTML::Selector.new('ul > li.to_check_split').select(render_result).should have(1).entries
+        end
+      end
+    end
+
+
+
+    context "when ':divider' option provided" do
+      context "for the first level item" do
+        it "adds li-tag with class 'divider-vertical' before normal li-tag" do
+          HTML::Selector.new('ul > li.divider-vertical + li > a[href="info_index_path"]').select(render_result).should have(1).entries
+        end
+      end
+
+      context "for the second level item and deeper" do
+        it "adds li-tag with class 'divider' before normal li-tag" do
+          HTML::Selector.new('ul.dropdown-menu > li.divider + li > a[href="misc_info_pages"]').select(render_result).should have(1).entries
+          HTML::Selector.new('ul.dropdown-menu > li.divider + li > a[href="contact_info_page"]').select(render_result).should have(1).entries
+        end
+      end
+    end
+
+
+
+    context "when ':header' option provided" do
+      context "for the first level item" do
+        it "does not set up 'dropdown-header' class on li-tag" do
+          HTML::Selector.new('ul.nav.navbar-nav > li.to_check_header.dropdown-header').select(render_result).should have(0).entries
+          HTML::Selector.new('ul.nav > li.to_check_header.dropdown-header').select(render_result(2)).should have(0).entries
+        end
+
+        it "creates link-tag for the item (standard item)" do
+          HTML::Selector.new('ul.nav.navbar-nav > li.to_check_header > a').select(render_result).should have(1).entries
+          HTML::Selector.new('ul.nav > li.to_check_header > a').select(render_result(2)).should have(1).entries
+        end
+      end
+
+      context "for the second level item and deeper" do
+        context "for 'bootstrap3' renderer" do
+          it "sets up 'dropdown-header' class on li-tag" do
+            HTML::Selector.new('ul.dropdown-menu > li.dropdown-header').select(render_result).should have(1).entries
+          end
+        end
+
+        context "for 'bootstrap2' renderer" do
+          it "sets up 'nav-header' class on li-tag" do
+            HTML::Selector.new('ul.dropdown-menu > li.nav-header').select(render_result(2)).should have(1).entries
+          end
+        end
+
+        it "does not create link-tag for the item (puts only item name as plain text)" do
+          HTML::Selector.new('ul.dropdown-menu > li.dropdown-header > a').select(render_result).should have(0).entries
+          HTML::Selector.new('ul.dropdown-menu > li.nav-header > a').select(render_result(2)).should have(0).entries
+          HTML::Selector.new('ul.dropdown-menu > li.dropdown-header').select(render_result)[0].children[0].to_s.should == "Misc. Pages"
+          HTML::Selector.new('ul.dropdown-menu > li.nav-header').select(render_result(2))[0].children[0].to_s.should == "Misc. Pages"
+        end
+      end
+    end
+
+
+
+    context "when 'hash' provided in place of 'name'" do
+      context "with ':icon' parameter" do
+        it "adds span-tag with classes from the parameter" do
+          HTML::Selector.new('ul > li > a > span.fa.fa-fw.fa-bullhorn').select(render_result).should have(1).entries
+        end
+      end
+
+      context "with ':title' parameter" do
+        it "sets up 'title' attribute on icon's span-tag to the parameter value" do
+          HTML::Selector.new('ul > li > a > span.fa.fa-fw.fa-book[title="Info"]').select(render_result).should have(1).entries
+        end
+      end
+
+      context "with ':text' parameter" do
+        it "uses the parameter value as 'name' of the item" do
+          HTML::Selector.new('ul > li > a > span.fa.fa-fw.fa-bullhorn').select(render_result)[0].parent.children[1].to_s.should == " News"
+        end
+      end
+
+      context "without ':text' and ':icon' parameters" do
+        it "raises 'InvalidHash' error" do
+          expect {
+            render_result(3, true)
+          }.to raise_error( SimpleNavigationRenderers::InvalidHash )
+        end
+      end
+    end
+
+  end
+end

data/spec/lib/simple_navigation_renderers/exceptions_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe SimpleNavigationRenderers::InvalidHash do
+  it "has specific default message" do
+    subject.message.should == "Hash does not contain any of parameters: 'text', 'icon'"
+  end
+end

data/spec/lib/simple_navigation_renderers_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe SimpleNavigationRenderers do
+  it "register 'bootstrap2' renderer" do
+    SimpleNavigation.registered_renderers[:bootstrap2].should == SimpleNavigationRenderers::Bootstrap2
+  end
+
+  it "register 'bootstrap3' renderer" do
+    SimpleNavigation.registered_renderers[:bootstrap3].should == SimpleNavigationRenderers::Bootstrap3
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,28 @@
+ENV["RAILS_ENV"] = "test"
+require 'action_controller'
+module Rails
+  module VERSION
+    MAJOR = 2
+  end
+end unless defined? Rails
+RAILS_ROOT = './' unless defined?(RAILS_ROOT)
+RAILS_ENV = 'test' unless defined?(RAILS_ENV)
+
+require "simple_navigation_renderers"
+
+# helper method
+def fill_in( primary )
+  primary.item :news, {icon: "fa fa-fw fa-bullhorn", text: "News"}, "news_index_path"
+  primary.item :concerts, "Concerts", "concerts_path", class: "to_check_header", header: true
+  primary.item :video, "Video", "videos_path", class: "to_check_split", split: true
+  primary.item :info, {icon: "fa fa-fw fa-book", title: "Info"}, "info_index_path", divider: true, split: true do |info_nav|
+    info_nav.item :main_info_page, "Main info page", "main_info_page"
+    info_nav.item :about_info_page, "About", "about_info_page"
+    info_nav.item :misc_info_pages, "Misc.", "misc_info_pages", divider: true, split: true do |misc_nav|
+      misc_nav.item :header_misc_pages, "Misc. Pages", header: true
+      misc_nav.item :page1, "Page1", "page1"
+      misc_nav.item :page2, "Page2", "page2"
+    end
+    info_nav.item :contact_info_page, "Contact", "contact_info_page", divider: true
+  end
+end

data/vendor/assets/stylesheets/bootstrap2_dropdown_submenu.css.scss

@@ -0,0 +1,51 @@
+.dropdown-submenu:hover > a,
+.dropdown-submenu:focus > a {
+  text-decoration: none;
+  color: $dropdown-link-hover-color;
+  @include gradient-vertical($dropdown-link-hover-bg, darken($dropdown-link-hover-bg, 5%));
+}
+// Sub menus
+// ---------------------------
+.dropdown-submenu {
+  position: relative;
+}
+// Default dropdowns
+.dropdown-submenu > .dropdown-menu {
+  top: 0;
+  left: 100%;
+  margin-top: -6px;
+  margin-left: -1px;
+  border-radius: 0 6px 6px 6px;
+}
+.dropdown-submenu:hover > .dropdown-menu {
+  display: block;
+}
+// Caret to indicate there is a submenu
+.dropdown-submenu > a:after {
+  display: block;
+  content: " ";
+  float: right;
+  width: 0;
+  height: 0;
+  border-top: $caret-width-base solid transparent;
+  border-bottom: $caret-width-base solid transparent;
+  border-left: $caret-width-base solid $navbar-default-link-color;
+  border-right: 0 dotted;
+  margin-top: 5px;
+  margin-right: -10px;
+}
+.dropdown-submenu:hover > a:after {
+  border-left-color: $dropdown-link-hover-color;
+}
+// Left aligned submenus
+.dropdown-submenu.pull-left {
+  // Undo the float
+  // Yes, this is awkward since .pull-left adds a float, but it sticks to our conventions elsewhere.
+  float: none;
+  // Positioning the submenu
+  > .dropdown-menu {
+    left: -100%;
+    margin-left: 10px;
+    border-radius: 6px 0 6px 6px;
+  }
+}

data/vendor/assets/stylesheets/bootstrap2_navbar_divider_vertical.css.scss

@@ -0,0 +1,11 @@
+.navbar .divider-vertical {
+  height: $navbar-height;
+  margin: 0 9px;
+  border-left: 1px solid $navbar-default-bg;
+  border-right: 1px solid lighten($navbar-default-bg, 5%);;
+}
+// Inverted navbar
+.divider-vertical {
+border-left-color: $navbar-inverse-bg;
+border-right-color: lighten($navbar-inverse-bg, 5%);;
+}

data/vendor/assets/stylesheets/simple_navigation_bootstrap.css.scss

@@ -0,0 +1,4 @@
+
+@import "bootstrap2_dropdown_submenu";
+@import "bootstrap2_navbar_divider_vertical";
+@import "simple_navigation_bootstrap_overrides";

data/vendor/assets/stylesheets/simple_navigation_bootstrap_overrides.css.scss

@@ -0,0 +1,16 @@
+
+// add style for navigation splitted dropdowns
+.navbar .nav > li.dropdown-split-left > a {
+  border-right: none;
+}
+.navbar .nav > li.dropdown-split-right > a {
+  border-left: none;
+}
+
+// correct some style
+.navbar .nav > li > .dropdown-menu.pull-right {
+  float: none ! important;
+}
+.navbar .nav > li > a > .caret {
+  margin: 0;
+}

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: simple_navigation_renderers
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Pavel Shpak
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: simple-navigation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.11'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'simple_navigation_renderers gem adds renderers for Bootstrap 2 and 3.
+  With these renderers you can create any bootstrap navigation elements, such as:
+  submenus, dividers, headers. As well as add icons to menu elements, such as: gliphicons,
+  font-awesome icons, even custom icons. '
+email:
+- shpakvel@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/simple_navigation_renderers.rb
+- lib/simple_navigation_renderers/bootstrap.rb
+- lib/simple_navigation_renderers/engine.rb
+- lib/simple_navigation_renderers/exceptions.rb
+- lib/simple_navigation_renderers/version.rb
+- simple_navigation_renderers.gemspec
+- spec/lib/simple_navigation_renderers/bootstrap_spec.rb
+- spec/lib/simple_navigation_renderers/exceptions_spec.rb
+- spec/lib/simple_navigation_renderers_spec.rb
+- spec/spec_helper.rb
+- vendor/assets/stylesheets/bootstrap2_dropdown_submenu.css.scss
+- vendor/assets/stylesheets/bootstrap2_navbar_divider_vertical.css.scss
+- vendor/assets/stylesheets/simple_navigation_bootstrap.css.scss
+- vendor/assets/stylesheets/simple_navigation_bootstrap_overrides.css.scss
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.10
+signing_key: 
+specification_version: 4
+summary: 'simple_navigation_renderers gem adds renderers for Bootstrap 2 and 3. With
+  these renderers you can create any bootstrap navigation elements, such as: submenus,
+  dividers, headers. As well as add icons to menu elements, such as: gliphicons, font-awesome
+  icons, even custom icons.'
+test_files:
+- spec/lib/simple_navigation_renderers/bootstrap_spec.rb
+- spec/lib/simple_navigation_renderers/exceptions_spec.rb
+- spec/lib/simple_navigation_renderers_spec.rb
+- spec/spec_helper.rb