Module: Bootstrap::ModalHelper

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

Overview

Rails helper for producing Bootstrap modal dialogs

Instance Method Summary collapse

Instance Method Details

Returns a Bootstrap modal dialog



16
17
18
19
20
21
22
23
24
25
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 16

def modal(options={})
  options = canonicalize_options(options)
  options.has_key?(:id) or raise(ArgumentError, "missing :id option")
  options = ensure_class(options, %w(modal hide fade))
  options.merge!(tabindex: "-1", role: "dialog")
  
  content_tag(:div, options) do
    yield
  end
end

#modal_alert(*args, &block) ⇒ Object 



98
99
100
101
102
103
104
105
106
107
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 98

def modal_alert(*args, &block)
  options = canonicalize_options(args.extract_options!)
  header = options.delete(:header) || "Alert"

  modal(options) do
    modal_header(header) + 
    modal_body(*args, &block) + 
    modal_footer
  end
end

#modal_body(*args, &block) ⇒ Object

Returns a DIV for Bootstrap modal body



44
45
46
47
48
49
50
51
52
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 44

def modal_body(*args, &block)
  options = canonicalize_options(args.extract_options!)
  options = ensure_class(options, 'modal-body')
  content = block_given? ? capture(&block) : args.shift

  content_tag(:div, options) do
    content
  end
end

#modal_confirm(*args, &block) ⇒ Object 



109
110
111
112
113
114
115
116
117
118
119
120
121
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 109

def modal_confirm(*args, &block)
  options = canonicalize_options(args.extract_options!)
  header = options.delete(:header) || "Confirmation"

  modal(options) do
    modal_header(header) + 
    modal_body(*args, &block) + 
    modal_footer do
      modal_footer_close_button(icon('remove', 'Cancel')) + 
      modal_footer_ok_button(icon('ok', :white, 'Ok'), :primary)
    end
  end
end

#modal_footer(*args, &block) ⇒ Object

Returns a DIV for Bootstrap modal footer Defaults to including #modal_footer_close_button.



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

def modal_footer(*args, &block)
  options = canonicalize_options(args.extract_options!)
  options = ensure_class(options, 'modal-footer')
  
  content = if block_given?
    capture(&block)
  elsif args.size > 0
    args.shift
  else
    modal_footer_close_button
  end

  content_tag(:div, options) do
    content
  end
end

#modal_footer_close_button(*args) ⇒ Object

Returns a close button for Bootstrap modal footer.



80
81
82
83
84
85
86
87
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 80

def modal_footer_close_button(*args)
  options = canonicalize_options(args.extract_options!)
  options = ensure_class(options, 'modal-close modal-footer-close')
  options.merge!(data: {dismiss: 'modal'})
  args.unshift("Close") if args.empty?

  button(*args, options)
end

#modal_footer_ok_button(*args) ⇒ Object 



89
90
91
92
93
94
95
96
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 89

def modal_footer_ok_button(*args)
  options = canonicalize_options(args.extract_options!)
  options = ensure_class(options, 'modal-footer-ok')
  options.merge!(data: {dismiss: 'modal'})
  args.unshift("Ok") if args.empty?

  button(*args, options)
end

#modal_header(*args, &block) ⇒ Object

Returns a DIV for Bootstrap modal header



28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 28

def modal_header(*args, &block)
  options = canonicalize_options(args.extract_options!)
  options = ensure_class(options, 'modal-header')
  show_close = options.delete(:close) != false

  content = block_given? ? capture(&block) : args.shift

  content_tag(:div, options) do
    modal_header_close_button(show_close) +
    content_tag(:h3) do
      content
    end
  end
end

#modal_header_close_button(show = true) ⇒ Object

Returns a Bootstrap modal close button



74
75
76
77
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 74

def modal_header_close_button(show=true)
  return ''.html_safe unless show
  button("×".html_safe, type: 'button', class: 'close modal-close modal-header-close', data: {dismiss: 'modal'})
end

#modal_trigger(text, options = {}) ⇒ Object

Returns an A tag to trigger (open) a Boostrap modal



6
7
8
9
10
11
12
13
 
# File 'app/helpers/bootstrap/modal_helper.rb', line 6

def modal_trigger(text, options={})
  options = canonicalize_options(options)
  href = options.delete(:href) or raise(ArgumentError, 'missing :href option')
  options.merge!(role: 'button', href: href, data: { toggle: 'modal'})
  options = ensure_class(options, 'btn')
  
  content_tag(:a, text, options)
end