Spec-Zone.ru › Ruby on Rails 7.1

модуль ActionView::Helpers::JavaScriptHelper

Справочник по JavaScript-помощникам Action View

Константы

JS_ESCAPE_MAP

Открытые методы экземпляра

escape_javascript(javascript) Показать исходный код
# File actionview/lib/action_view/helpers/javascript_helper.rb, line 28
def escape_javascript(javascript)
  javascript = javascript.to_s
  if javascript.empty?
    result = ""
  else
    result = javascript.gsub(/(\\|<\/|\r\n|\342\200\250|\342\200\251|[\n\r"']|[`]|[$])/u, JS_ESCAPE_MAP)
  end
  javascript.html_safe? ? result.html_safe : result
end

Экранирует символы возврата каретки и одинарные и двойные кавычки для JavaScript-фрагментов.

Также доступен через псевдоним j(). Особенно полезно при ответах с JavaScript, например:

$('some_element').replaceWith('<%= j render 'some/element_template' %>');
Также алиас: j
j(javascript)
Псевдоним для: escape_javascript
javascript_tag(content_or_options_with_block = nil, html_options = {}, &block) Показать исходный код
# File actionview/lib/action_view/helpers/javascript_helper.rb, line 75
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

  if html_options[:nonce] == true
    html_options[:nonce] = content_security_policy_nonce
  end

  content_tag("script", javascript_cdata_section(content), html_options)
end

Возвращает тег JavaScript с content внутри. Пример:

javascript_tag "alert('All is good')"

Возвращает:

<script>
//<![CDATA[
alert('All is good')
//]]>
</script>

html_options может быть хэш атрибутов для <script> тега.

javascript_tag "alert('All is good')", type: 'application/javascript'

Возвращает:

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

Вместо передачи контента в качестве аргумента, вы также можете использовать блок, в котором случае вы передаёте свой html_options в качестве первого параметра.

<%= javascript_tag type: 'application/javascript' do -%>
  alert('All is good')
<% end -%>

Если у вас включена политика безопасности контента, вы можете добавить автоматическое значение nonce, передав nonce: true как часть html_options. Пример:

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

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API