module ActionView::Helpers::TagHelper

def build_tag_values(*args)

def build_tag_values(*args)
  tag_values = []
  args.each do |tag_value|
    case tag_value
    when Hash
      tag_value.each do |key, val|
        tag_values << key.to_s if val && key.present?
      end
    when Array
      tag_values.concat build_tag_values(*tag_value)
    else
      tag_values << tag_value.to_s if tag_value.present?
    end
  end
  tag_values
end

def cdata_section(content)

# => world]]>
cdata_section("hello]]>world")

# =>
cdata_section(File.read("hello_world.txt"))

# => ]]>
cdata_section("")

and end with (and may not contain) the string ]]>.
otherwise be recognized as markup. CDATA sections begin with the string
are used to escape blocks of text containing characters which would
Returns a CDATA section with the given +content+. CDATA sections
def cdata_section(content)
  splitted = content.to_s.gsub(/\]\]>/, "]]]]><![CDATA[>")
  "<![CDATA[#{splitted}]]>".html_safe
end

def content_tag(name, content_or_options_with_block = nil, options = nil, escape = true, &block)

# =>
Hello world!

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

# =>
content_tag("select", options, multiple: true)
# =>
Hello world!

content_tag(:div, "Hello world!", class: ["strong", { highlight: current_user.admin? }])
# =>
Hello world!

content_tag(:div, "Hello world!", class: ["strong", "highlight"])
# =>

Hello world!


content_tag(:div, content_tag(:p, "Hello world!"), class: "strong")
# =>

Hello world!


content_tag(:p, "Hello world!")
==== Examples

symbols or strings for the attribute names.
readonly), which you can give a value of true in the +options+ hash. You can use
The +options+ hash can be used with attributes with no value like (disabled and
==== Options

Note: this is legacy syntax, see +tag+ method description for details.
Set escape to false to disable escaping.
in which case, you pass your +options+ as the second parameter.
Instead of passing the content as an argument, you can also use a block
HTML attributes by passing an attributes hash to +options+.
Returns an HTML block tag of type +name+ surrounding the +content+. Add
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

def escape_once(html)

# => "<< Accept & Checkout"
escape_once("<< Accept & Checkout")

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

Returns an escaped version of +html+ without affecting existing escaped entities.
def escape_once(html)
  ERB::Util.html_escape_once(html)
end

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

# =>

tag("div", class: { highlight: current_user.admin? })

# =>

tag("div", data: { name: 'Stephen', city_state: %w(Chicago IL) })

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

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

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

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

# =>

tag("br", nil, true)

# =>

tag("br")

==== Examples

pointing to a hash of sub-attributes.
HTML5 data-* attributes can be set with a single +data+ key

+disabled+ and +readonly+.
Use +true+ with boolean attributes that can render with no value, like

You can use symbols or strings for the attribute names.

==== Options

escaping.
hash to +options+. Set +escape+ to false to disable attribute value
with HTML 4.0 and below. Add HTML attributes by passing an attributes
compliant. Set +open+ to true to create an open tag compatible
It returns an empty HTML tag of type +name+ which by default is XHTML

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

The following format is for legacy syntax support. It will be deprecated in future versions of \Rails.

=== Legacy syntax

# =>


# =>
>

prefixed attributes:
aria: or data: objects into aria- and data-
Transforms keys nested within
ERB. Includes or omits boolean attributes based on their truthiness.
Transforms a Hash into HTML attributes, ready to be interpolated into

=== Building HTML attributes

tag.br # =>

# A void element:

tag.div # =>

# A standard element:

if no content is passed, and omits closing tags for those elements.
{HTML5 void elements}[https://www.w3.org/TR/html5/syntax.html#void-elements]
The tag builder respects

# =>
tag.img src: 'open & shut.png', escape: false

# =>
tag.img src: 'open & shut.png'

+escape+.
The generated tag names and attributes are escaped by default. This can be disabled using

# =>

tag.div data: { city_state: %w( Chicago IL ) }

from 1.4.3.
This may come in handy when using jQuery's HTML5-aware .data()
BigDecimals.
Data attribute values are encoded to JSON, with the exception of strings, symbols, and

Thus data-user-id can be accessed as dataset.userId.

# =>

tag.article data: { user_id: 123 }

To play nicely with JavaScript conventions, sub-attributes are dasherized.

single +data+ or +aria+ key pointing to a hash of sub-attributes.
HTML5 data-* and aria-* attributes can be set with a

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

Pass +true+ for any attributes that can render with no values, like +disabled+ and +readonly+.

# =>

tag.section id: dom_id(@post)

# =>

tag.section class: %w( kitties puppies )

Use symbol keyed options to add attributes to the generated tag.

==== Options

# =>

The next great American novel starts here.


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

Content can also be captured with a block, which is useful in templates:

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

Hello world!



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

All titles fit to print



Tags can pass content to embed within it:

==== Passing content

where tag name can be e.g. br, div, section, article, or any tag really.

tag.(optional content, options)

Builds HTML5 compliant tags with a tag proxy. Every tag can be built with:

=== Building HTML tags

Returns an HTML tag.
def tag(name = nil, options = nil, open = false, escape = true)
  if name.nil?
    tag_builder
  else
    name = ERB::Util.xml_name_escape(name) if escape
    "<#{name}#{tag_builder.tag_options(options, escape) if options}#{open ? ">" : " />"}".html_safe
  end
end

def tag_builder

def tag_builder
  @tag_builder ||= TagBuilder.new(self)
end

def token_list(*args)

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

Returns a string of tokens built from +args+.
def token_list(*args)
  tokens = build_tag_values(*args).flat_map { |value| CGI.unescape_html(value.to_s).split(/\s+/) }.uniq
  safe_join(tokens, " ")
end