Module: Bootstrap::DropdownHelper

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

Overview

Rails helper methods for various Bootstrap dropdown menus

Examples:

nav dropdown

<%= nav_dropdown('Admin') do %>
  <%= dropdown_item('Users', '/admin/users') %>
  <%= dropdown_item('Logs', '/admin/logs') %>
  <%= dropdown_divider %>
  <%= dropdown_item('Exceptions', '/admin/exceptions') %>
<% end %>

button dropdown

<%= button_dropdown('Actions') do %>
  <%= dropdown_item('Action 1', '/action1') %>
  <%= dropdown_item('Action 2', '/action2') %>
<% end %>

split-button dropdown

<%= split_button_dropdown('Default', url: '/default') do %>
  <%= dropdown_item('Action 1', '/action1') %>
  <%= dropdown_item('Action 2', '/action2') %>
<% end %>#

Instance Method Summary collapse

Instance Method Details

#button_dropdown('Text') ⇒ Object #button_dropdown('Text', : info) ⇒ Object #button_dropdown('Text', : info, : mini) ⇒ Object

Returns a Bootstrap button dropdown

Parameters have same semantics as in ButtonHelper#button

Yields:

  • yielded block is usually calls to NavHelper#dropdown_item or NavHelper#dropdown_divider# @return [String]



49
50
51
52
53
 
# File 'app/helpers/bootstrap/dropdown_helper.rb', line 49

def button_dropdown(*args)
  content_tag(:div, class: 'btn-group') do
    button_dropdown_link(*args) + dropdown_ul { yield }
  end
end

#dropdown_divider ⇒ String

Returns a divider for various dropdowns

Returns:

  • (String) —

    <li class=“divider”>



89
90
91
 
# File 'app/helpers/bootstrap/dropdown_helper.rb', line 89

def dropdown_divider
  content_tag(:li, nil, class: 'divider')
end

#dropdown_item('Text') ⇒ String #dropdown_item('Text', url: '/url') ⇒ String

Returns a link for use within various *_dropdown methods

Returns:

  • (String) 


77
78
79
80
81
82
83
84
85
 
# File 'app/helpers/bootstrap/dropdown_helper.rb', line 77

def dropdown_item(*args)
  options = args.extract_options!
  text = args.shift or raise "Need text to link to"
  url = args.shift || 'javascript:void(0)'
  
  content_tag(:li) do
    link_to(text, url, options)
  end
end

#nav_dropdown(text) { ... } ⇒ String

Returns a drop-down menu of links

Usually called from yielded block of NavHelper#nav_bar

Parameters:

  • text (String) —

    text of dropdown link

Yields:

  • yielded block is usually calls to NavHelper#dropdown_item or NavHelper#dropdown_divider

Returns:

  • (String) —

    ‘<li class=’dropdown’><ul class=‘dropdown-menu’> with contents of yielded block



35
36
37
38
39
 
# File 'app/helpers/bootstrap/dropdown_helper.rb', line 35

def nav_dropdown(text)
  content_tag(:li, class: 'dropdown') do
    nav_dropdown_link(text) + dropdown_ul { yield }
  end
end

#split_button_dropdown('Text') ⇒ String #split_button_dropdown('Text', url: '/url') ⇒ String #split_button_dropdown('Text', : large, : danger, url: '/url') ⇒ String

Returns a Bootstrap split-button dropdown

Parameters have same semantics as in ButtonHelper#button

Yields:

  • yielded block is usually calls to NavHelper#dropdown_item or NavHelper#dropdown_divider

Returns:

  • (String) 


64
65
66
67
68
69
70
 
# File 'app/helpers/bootstrap/dropdown_helper.rb', line 64

def split_button_dropdown(*args)
  extras = extract_extras(*args)
  
  content_tag(:div, class: 'btn-group') do
    split_button_dropdown_default(*args) + split_button_dropdown_toggle(extras) + dropdown_ul { yield }
  end
end