Creates an HTML tag with the given name and
optionally text and attributes. Can take a block that will run between the
opening and closing tags. If the block is a Haml
block or outputs text using {#haml_concat}, the text will be properly
indented.
`name` can be a string using the standard Haml
class/id shorthand (e.g. “span#.bar”, “#“). Just
like standard Haml tags, these class and id
values will be merged with manually-specified attributes.
`flags` is a list of symbol flags like those that can be put at the end of
a Haml tag (`:/`, `:<`, and `:>`). Currently,
only `:/` and `:<` are supported.
`haml_tag` outputs directly to
the buffer; its return value should not be used. If you need to get the
results as a string, use {#capture_haml}.
For example,
haml_tag :table do
haml_tag :tr do
haml_tag 'td.cell' do
haml_tag :strong, "strong!"
haml_concat "data"
end
haml_tag :td do
haml_concat "more_data"
end
end
end
outputs
<table>
<tr>
<td class='cell'>
<strong>
strong!
</strong>
data
</td>
<td>
more_data
</td>
</tr>
</table>
@param name [#] The name of the tag @param flags [Array] Haml end-of-tag flags
@overload haml_tag(name,
*flags, attributes = {})
@yield The block of Haml code within the tag
@overload haml_tag(name, text,
*flags, attributes = {})
@param text [#to_s] The text within the tag
439: def haml_tag(name, *rest, &block)
440: ret = ErrorReturn.new("haml_tag")
441:
442: text = rest.shift.to_s unless [Symbol, Hash, NilClass].any? {|t| rest.first.is_a? t}
443: flags = []
444: flags << rest.shift while rest.first.is_a? Symbol
445: name, attrs = merge_name_and_attributes(name.to_s, rest.shift || {})
446:
447: attributes = Haml::Precompiler.build_attributes(haml_buffer.html?,
448: haml_buffer.options[:attr_wrapper],
449: attrs)
450:
451: if text.nil? && block.nil? && (haml_buffer.options[:autoclose].include?(name) || flags.include?(:/))
452: haml_concat "<#{name}#{attributes} />"
453: return ret
454: end
455:
456: if flags.include?(:/)
457: raise Error.new("Self-closing tags can't have content.") if text
458: raise Error.new("Illegal nesting: nesting within a self-closing tag is illegal.") if block
459: end
460:
461: tag = "<#{name}#{attributes}>"
462: if block.nil?
463: text = text.to_s
464: if text.include?("\n")
465: haml_concat tag
466: tab_up
467: haml_concat text
468: tab_down
469: haml_concat "</#{name}>"
470: else
471: tag << text << "</#{name}>"
472: haml_concat tag
473: end
474: return ret
475: end
476:
477: if text
478: raise Error.new("Illegal nesting: content can't be both given to haml_tag :#{name} and nested within it.")
479: end
480:
481: if flags.include?(:<)
482: tag << capture_haml(&block).strip << "</#{name}>"
483: haml_concat tag
484: return ret
485: end
486:
487: haml_concat tag
488: tab_up
489: block.call
490: tab_down
491: haml_concat "</#{name}>"
492:
493: ret
494: end
![[+]](../images/find.png "show/hide quicksearch")