Module: Bootstrap::NavHelper

Defined in:
app/helpers/bootstrap/nav_helper.rb

Overview

Rails view helpers for various Bootstrap navigation components.

See: twitter.github.io/bootstrap/components.html#navbar

Examples:

navigation bar (across top of page)

<%= nav_bar do %>      

  <%= brand('Span Brand')%>
  <%= brand('Link Brand', url: '#')%>

  <%= nav_bar_links do %>
    <%= nav_bar_link('Active', '#', active: true) %>
    <%= nav_bar_link('Link 1', '/link1') %>
    <%= nav_bar_divider %>
    <%= nav_bar_link('Link 2', '/link2') %>
  <% end >

  <%= nav_dropdown(pull: 'right') %>
    <%= nav_dropdown('Foo') do %>
      <%= dropdown_item('One', 'foo')%>
    <% end %>
  <% end %>

<% end %>

navigation list (e.g., in sidebar)

<%= nav_list(id: 'my') do %>
  <%= nav_list_header('Buttons & Labels') %>
  <%= dropdown_item('Buttons', 'butons')%>
  <%= dropdown_item('Labels', 'butons')%>
<% end %>

Instance Method Summary collapse

Instance Method Details

#brand(text, options = {}) ⇒ String

Returns a Bootstrap brand element

Options Hash (options):

  • :url (String) —

    if present, returned tag is an <a> (else <span>)

  • :with_environment (Boolean) —

    if present, environment is appended to text and and a class of “rails-<Rails.env>” is added to the returned tag.



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 53

def brand(text, options = {})
  options = canonicalize_options(options)
  options = ensure_class(options, 'brand')

  with_environment = options.delete(:with_environment)
  if with_environment && Rails.env != 'production'
    text = "#{text} - #{Rails.env}"
    options = ensure_class(options, "rails-#{Rails.env}") 
  end

  url = options.delete(:url)
  
  if url.present?
    link_to(text, url, options)
  else
    content_tag(:span, text, options)
  end
end

#nav_bar { ... } ⇒ String

Returns a Bootstrap navigation bar

Yields:

Yield Returns:

  • the contents of the navigation bar



37
38
39
40
41
42
43
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 37

def nav_bar()
  content_tag(:header, class: 'navbar') do
    content_tag(:nav, class: 'navbar-inner') do
      yield
    end
  end
end

#nav_bar_divider ⇒ String

Returns divider (vertical bar) for separating items in a nav_bar



116
117
118
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 116

def nav_bar_divider
  content_tag(:li, nil, class: "divider-vertical")
end

#nav_bar_link(text, url, options = {}) ⇒ String

Returns a nav_bar_link

Usually called within yield block of #nav_bar

Options Hash (options):

  • :active (true) —

    if set to true, displays as inactive



102
103
104
105
106
107
108
109
110
111
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 102

def nav_bar_link(text, url, options={})
  a_options = canonicalize_options(options)
  active = a_options.delete(:active)
  
  li_options = {class: ('active' if active)}
  
  content_tag(:li, li_options) do
    link_to(text, url, a_options)
  end
end

#nav_bar_links(options = {}) { ... } ⇒ String

Returns <div> for a group of nav bar links, <ul>s.

Usually called in yield block of #nav_bar

Options Hash (options):

  • pull (:left, :right) —

    will add class of “pull-left|right” for Bootstrap nav bar positioning

Yields:

  • block usually consists of calls to #nav_bar_link and #nav_bar_divider



80
81
82
83
84
85
86
87
88
89
90
91
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 80

def nav_bar_links(options={})
  options = canonicalize_options(options)
  options = ensure_class(options, 'nav')
  
  if pull = options.delete(:pull)
    options = ensure_class(options, "pull-#{pull}")
  end
  
  content_tag(:div, options) do
    yield
  end
end

#nav_bar_text(text, options = {}) ⇒ String

Wraps text so it has proper leading and color for text in a nav bar. Usually in a nav_bar_links block

Note that the Bootstrap CSS has no horizontal margins or padding. This method pads with three &nbsp; at front and back. Use pad: false to suppress padding.

Options Hash (options):

  • :pull (:left, :right) — default: :left —

    adds the Boostrap positioning class

  • :pad (Boolean) — default: true —

    include padding around text



154
155
156
157
158
159
160
161
162
163
164
165
166
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 154

def nav_bar_text(text, options={})
  options = canonicalize_options(options)

  unless options.delete(:pad) == false
    padding = ("&nbsp;" * 3).html_safe
    text = padding + h(text) + padding
  end
  
  pull_class = (options.delete(:pull).to_s == 'right' ? 'pull-right' : 'pull-left')
  options = ensure_class(options, [pull_class, 'navbar-text'])
  
  content_tag(:p, text, options)
end

#nav_list(options = {}) { ... } ⇒ String

Returns nav list

Yields:

  • block consists of calls to #nav_list_header and #dropdown_item



125
126
127
128
129
130
131
132
133
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 125

def nav_list(options={})
  options = canonicalize_options(options)
  options = ensure_class(options, 'well')
  content_tag(:div, options) do
    content_tag(:ul, class: 'nav nav-list') do
      yield
    end
  end
end

#nav_list_header(text) ⇒ String

Returns header for nav_list



139
140
141
 
# File 'app/helpers/bootstrap/nav_helper.rb', line 139

def nav_list_header(text)
  content_tag(:li, text, class: 'nav-header')
end