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

# File actionview/lib/action_view/helpers/tag_helper.rb, line 347
def cdata_section(content)
  splitted = content.to_s.gsub(/\]\]\>/, "]]]]><![CDATA[>")
  "<![CDATA[#{splitted}]]>".html_safe
end

Возвращает секцию CDATA с заданным content. Секции CDATA используются для экранирования блоков текста, содержащих символы, которые в противном случае будут распознаны как разметка. Секции CDATA начинаются со строки <![CDATA[ и заканчиваются (и не могут содержать) строкой ]]>.

cdata_section("<hello world>")
# => <![CDATA[<hello world>]]>

cdata_section(File.read("hello_world.txt"))
# => <![CDATA[<hello from a text file]]>

cdata_section("hello]]>world")
# => <![CDATA[hello]]]]><![CDATA[>world]]>

# File actionview/lib/action_view/helpers/tag_helper.rb, line 307
def content_tag(name, content_or_options_with_block = nil, options = nil, escape = true, &block)
  if block_given?
    options = content_or_options_with_block if content_or_options_with_block.is_a?(Hash)
    tag_builder.content_tag_string(name, capture(&block), options, escape)
  else
    tag_builder.content_tag_string(name, content_or_options_with_block, options, escape)
  end
end

Возвращает HTML-тег блока типа name, окружающий content. Добавляйте HTML-атрибуты, передавая хеш атрибутов в options. Вместо передачи содержимого в качестве аргумента, вы также можете использовать блок, в этом случае вы передаете свой options в качестве второго параметра. Установите escape в false, чтобы отключить экранирование значений атрибутов. Примечание: это устаревший синтаксис, см. описание метода tag для подробностей.

Параметры

Хеш options может использоваться с атрибутами без значения, такими как (disabled и readonly), которым вы можете присвоить значение true в хеше options. Вы можете использовать символы или строки для имён атрибутов.

Примеры

content_tag(:p, "Hello world!")
 # => <p>Hello world!</p>
content_tag(:div, content_tag(:p, "Hello world!"), class: "strong")
 # => <div class="strong"><p>Hello world!</p></div>
content_tag(:div, "Hello world!", class: ["strong", "highlight"])
 # => <div class="strong highlight">Hello world!</div>
content_tag(:div, "Hello world!", class: ["strong", { highlight: current_user.admin? }])
 # => <div class="strong highlight">Hello world!</div>
content_tag("select", options, multiple: true)
 # => <select multiple="multiple">...options...</select>

<%= content_tag :div, class: "strong" do -%>
  Hello world!
<% end -%>
 # => <div class="strong">Hello world!</div>

# File actionview/lib/action_view/helpers/tag_helper.rb, line 359
def escape_once(html)
  ERB::Util.html_escape_once(html)
end

Возвращает экранированную версию html без изменения уже существующих экранированных сущностей.

escape_once("1 < 2 &amp; 3")
# => "1 &lt; 2 &amp; 3"

escape_once("&lt;&lt; Accept & Checkout")
# => "&lt;&lt; Accept &amp; Checkout"

# File actionview/lib/action_view/helpers/tag_helper.rb, line 271
def tag(name = nil, options = nil, open = false, escape = true)
  if name.nil?
    tag_builder
  else
    "<#{name}#{tag_builder.tag_options(options, escape) if options}#{open ? ">" : " />"}".html_safe
  end
end

Возвращает HTML-тег.

Создание HTML-тегов

Создаёт HTML5-совместимые теги с помощью прокси-тега. Каждый тег можно создать с помощью:

tag.<tag name>(optional content, options)

где имя тега может быть, например, br, div, section, article или любым другим тегом.

Передача содержимого

Tags можно передать содержимое для вставки в него:

tag.h1 'All titles fit to print' # => <h1>All titles fit to print</h1>

tag.div tag.p('Hello world!')  # => <div><p>Hello world!</p></div>

Содержимое также можно получить с помощью блока, что полезно в шаблонах:

<%= tag.p do %>
  The next great American novel starts here.
<% end %>
# => <p>The next great American novel starts here.</p>

Параметры

Используйте параметры с ключами-символами, чтобы добавить атрибуты к сгенерированному тегу.

tag.section class: %w( kitties puppies )
# => <section class="kitties puppies"></section>

tag.section id: dom_id(@post)
# => <section id="<generated dom id>"></section>

Передайте true для любых атрибутов, которые могут отображаться без значений, таких как disabled и readonly.

tag.input type: 'text', disabled: true
# => <input type="text" disabled="disabled">

Атрибуты HTML5 data-* и aria-* можно задать с помощью одного ключа data или aria , указывающего на хэш под-атрибутов.

Для совместимости с соглашениями JavaScript под-атрибуты преобразуются в дефисный формат.

tag.article data: { user_id: 123 }
# => <article data-user-id="123"></article>

Таким образом, data-user-id можно получить как dataset.userId.

Значения атрибутов данных кодируются в JSON, за исключением строк, символов и BigDecimals. Это может быть полезно при использовании jQuery's HTML5-совместимого .data() с версии 1.4.3.

tag.div data: { city_state: %w( Chicago IL ) }
# => <div data-city-state="[&quot;Chicago&quot;,&quot;IL&quot;]"></div>

Сгенерированные атрибуты по умолчанию экранируются. Это можно отключить, используя escape_attributes.

tag.img src: 'open & shut.png'
# => <img src="open &amp; shut.png">

tag.img src: 'open & shut.png', escape_attributes: false
# => <img src="open & shut.png">

Генератор тегов учитывает HTML5 пустые элементы, если содержимое не передаётся, и опускает закрывающие теги для этих элементов.

# A standard element:
tag.div # => <div></div>

# A void element:
tag.br  # => <br>

Синтаксис предыдущих версий

Следующий формат поддерживает синтаксис предыдущих версий. Он будет устаревшим в будущих версиях Rails.

tag(name, options = nil, open = false, escape = true)

Он возвращает пустой HTML-тег типа name, который по умолчанию соответствует XHTML. Установите open в значение true, чтобы создать открывающий тег, совместимый с HTML 4.0 и ниже. Добавьте HTML-атрибуты, передав хэш атрибутов в options. Установите escape в значение false, чтобы отключить экранирование значений атрибутов.

Параметры

Вы можете использовать символы или строки для имён атрибутов.

Используйте true с булевыми атрибутами, которые могут отображаться без значения, такими как disabled и readonly.

Атрибуты HTML5 data-* могут быть заданы с помощью одного ключа data , указывающего на хэш под-атрибутов.

Примеры

tag("br")
# => <br />

tag("br", nil, true)
# => <br>

tag("input", type: 'text', disabled: true)
# => <input type="text" disabled="disabled" />

tag("input", type: 'text', class: ["strong", "highlight"])
# => <input class="strong highlight" type="text" />

tag("img", src: "open & shut.png")
# => <img src="open &amp; shut.png" />

tag("img", { src: "open &amp; shut.png" }, false, false)
# => <img src="open &amp; shut.png" />

tag("div", data: { name: 'Stephen', city_state: %w(Chicago IL) })
# => <div data-name="Stephen" data-city-state="[&quot;Chicago&quot;,&quot;IL&quot;]" />

tag("div", class: { highlight: current_user.admin? })
# => <div class="highlight" />

# File actionview/lib/action_view/helpers/tag_helper.rb, line 327
def token_list(*args)
  tokens = build_tag_values(*args).flat_map { |value| value.to_s.split(/\s+/) }.uniq

  safe_join(tokens, " ")
end

Возвращает строку токенов, созданных из args.

Примеры

token_list("foo", "bar")
 # => "foo bar"
token_list("foo", "foo bar")
 # => "foo bar"
token_list({ foo: true, bar: false })
 # => "foo"
token_list(nil, false, 123, "", "foo", { bar: true })
 # => "123 foo bar"