Module: ActionView::Helpers::JavaScriptHelper

Included in:
ActionView::Helpers
Defined in:
actionpack/lib/action_view/helpers/javascript_helper.rb

Constant Summary

JS_ESCAPE_MAP =
{
'\\'    => '\\\\',
'</'    => '<\/',
"\r\n"  => '\n',
"\n"    => '\n',
"\r"    => '\n',
'"'     => '\\"',
"'"     => "\\'" }

Instance Method Summary (collapse)

Instance Method Details

- (Object) button_to_function(name, function = nil, html_options = {})

Returns a button whose onclick handler triggers the passed JavaScript.

The helper receives a name, JavaScript code, and an optional hash of HTML options. The name is used as button label and the JavaScript code goes into its onclick attribute. If html_options has an :onclick, that one is put before function.

button_to_function "Greeting", "alert('Hello world!')", :class => "ok"
# => <input class="ok" onclick="alert('Hello world!');" type="button" value="Greeting" />


75
76
77
78
79
# File 'actionpack/lib/action_view/helpers/javascript_helper.rb', line 75

def button_to_function(name, function=nil, html_options={})
  onclick = "#{"#{html_options[:onclick]}; " if html_options[:onclick]}#{function};"

  tag(:input, html_options.merge(:type => 'button', :value => name, :onclick => onclick))
end

- (Object) escape_javascript(javascript) Also known as: j

Escape carrier returns and single and double quotes for JavaScript segments. Also available through the alias j(). This is particularly helpful in JavaScript responses, like:

$('some_element').replaceWith('<%=j render 'some/element_template' %>');


19
20
21
22
23
24
25
26
# File 'actionpack/lib/action_view/helpers/javascript_helper.rb', line 19

def escape_javascript(javascript)
  if javascript
    result = javascript.gsub(/(\\|<\/|\r\n|[\n\r"'])/) {|match| JS_ESCAPE_MAP[match] }
    javascript.html_safe? ? result.html_safe : result
  else
    ''
  end
end

- (Object) javascript_cdata_section(content)

:nodoc:



62
63
64
# File 'actionpack/lib/action_view/helpers/javascript_helper.rb', line 62

def javascript_cdata_section(content) #:nodoc:
  "\n//#{cdata_section("\n#{content}\n//")}\n".html_safe
end

- (Object) javascript_tag(content_or_options_with_block = nil, html_options = {}, &block)

Returns a JavaScript tag with the content inside. Example:

javascript_tag "alert('All is good')"

Returns:

<script type="text/javascript">
//<![CDATA[
alert('All is good')
//]]>
</script>

html_options may be a hash of attributes for the <script> tag. Example:

javascript_tag "alert('All is good')", :defer => 'defer'
# => <script defer="defer" type="text/javascript">alert('All is good')</script>

Instead of passing the content as an argument, you can also use a block in which case, you pass your html_options as the first parameter.

<%= javascript_tag :defer => 'defer' do -%>
  alert('All is good')
<% end -%>


50
51
52
53
54
55
56
57
58
59
60
# File 'actionpack/lib/action_view/helpers/javascript_helper.rb', line 50

def javascript_tag(content_or_options_with_block = nil, html_options = {}, &block)
  content =
    if block_given?
      html_options = content_or_options_with_block if content_or_options_with_block.is_a?(Hash)
      capture(&block)
    else
      content_or_options_with_block
    end

  (:script, javascript_cdata_section(content), html_options.merge(:type => Mime::JS))
end

Returns a link whose onclick handler triggers the passed JavaScript.

The helper receives a name, JavaScript code, and an optional hash of HTML options. The name is used as the link text and the JavaScript code goes into the onclick attribute. If html_options has an :onclick, that one is put before function. Once all the JavaScript is set, the helper appends "; return false;".

The href attribute of the tag is set to "#" unles html_options has one.

link_to_function "Greeting", "alert('Hello world!')", :class => "nav_link"
# => <a class="nav_link" href="#" onclick="alert('Hello world!'); return false;">Greeting</a>


93
94
95
96
97
98
# File 'actionpack/lib/action_view/helpers/javascript_helper.rb', line 93

def link_to_function(name, function, html_options={})
  onclick = "#{"#{html_options[:onclick]}; " if html_options[:onclick]}#{function}; return false;"
  href = html_options[:href] || '#'

  (:a, name, html_options.merge(:href => href, :onclick => onclick))
end