Module: ActionView::Helpers::JavaScriptHelper
Relationships & Source Files | |
Extension / Inclusion / Inheritance Descendants | |
Included In:
| |
Defined in: | actionview/lib/action_view/helpers/javascript_helper.rb |
Constant Summary
-
JS_ESCAPE_MAP =
# File 'actionview/lib/action_view/helpers/javascript_helper.rb', line 6{ '\\' => '\\\\', '</' => '<\/', "\r\n" => '\n', "\n" => '\n', "\r" => '\n', '"' => '\\"', "'" => "\\'" }
Instance Method Summary
-
#escape_javascript(javascript)
(also: #j)
Escapes carriage returns and single and double quotes for JavaScript segments.
-
#j(javascript)
Alias for #escape_javascript.
-
#javascript_tag(content_or_options_with_block = nil, html_options = {}, &block)
Returns a JavaScript tag with the
content
inside.
Instance Method Details
#escape_javascript(javascript) Also known as: #j
Escapes carriage 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' %>');
# File 'actionview/lib/action_view/helpers/javascript_helper.rb', line 25
def escape_javascript(javascript) if javascript result = javascript.gsub(/(\\|<\/|\r\n|\342\200\250|\342\200\251|[\n\r"'])/u) {|match| JS_ESCAPE_MAP[match] } javascript.html_safe? ? result.html_safe : result else '' end end
#j(javascript)
Alias for #escape_javascript.
# File 'actionview/lib/action_view/helpers/javascript_helper.rb', line 34
alias_method :j, :escape_javascript
#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>
//<![CDATA[
alert('All is good')
//]]>
</script>
html_options
may be a hash of attributes for the <script>
tag.
javascript_tag "alert('All is good')", defer: 'defer'
Returns:
<script defer="defer">
//<![CDATA[
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 -%>
# File 'actionview/lib/action_view/helpers/javascript_helper.rb', line 64
def javascript_tag( = nil, = {}, &block) content = if block_given? = if .is_a?(Hash) capture(&block) else end content_tag(:script, javascript_cdata_section(content), ) end