Template:Tag

<tag>…</tag>

Template documentation[view] [edit] [history] [purge]

This page is about 'displaying' markup tags. For 'using' markup tags, see the #tag magic word

The {{Tag}} template is designed to made demonstrating techniques involving HTML/XML/XHTML and other markup-style tag structures easier for editors and more accessible for readers by producing clear and logical preformatted output. It supports demonstrating tag pairs, single opening or closing tags, self-closing tags and tags surrounding other content, as well as linking tag names to more targeted documentation about themselves.

A markup tag is paired open (<) and close (>) angle brackets, and the content within them, in a markup language such as XML or HTML. For example, the <title> tag defines the title of a web page as see in your browser's title bar.

Usage

{{Tag|tag name|type|content=text|attribs=attributes and values}}

Parameters

See also: Span and div

Required parameters are shown in bold italics.

|1= (tag name above)

The XML/HTML tag's name (e.g. code, ref).

|2= (type above)

To indicate which of the tag's types is/are presented:

p / pair (default): A matching pair of open and close tags (e.g. <div>…</div>).
To suppress the ellipsis (…) between the tags, add an empty |content= parameter (for example, {{Tag|div|pair|content=}}).
o / open): An open tag (e.g. ).
c / close: A close tag (e.g. ).
e / empty / s / single / v / void: An empty element, formed as a single, self-terminating tag (e.g. <hr />); in HTML5 these are now known as "void" elements, though "empty" is the more common term.

|content=

Text to place between open and close tags.

|attribs= / |params=

Attributes and values to be included as part of an open tag.

|wrap=yes

Disable nowrap for long samples, allowing line breaks with the tag-wrapped content.

|link=yes

Link to the element's entry at the HTML element English Wikipedia article, e.g.:
{{Tag|del|link=y}}
produces:
<del>…</del>
This is only for HTML elements; the page is hard-coded, so it cannot be used for, e.g., XML elements from a particular schema. If desired, a feature for specifying the link page can be added.

Examples

{{Tag|ref}} → <ref>…</ref>
{{Tag|ref|content=}} → <ref></ref>
{{Tag|ref|content=hello}} → <ref>hello</ref>
{{Tag|span|content=foo}} → foo
{{Tag|span|open}} → 
{{Tag|span|open|content=hello}} → hello
{{Tag|span|close|content=hello}} → hello
{{Tag|span|pair|content=hello}} → hello
{{Tag|ref|open|attribs=group="note"}} → <ref group="note">
{{Tag|references|single}} → <references />
{{Tag|br|single}} →  
{{Tag|!--|content= Comment }} → 
{{Tag|math|attribs=chem}} → <math chem>…</math>
{{Tag|a|attribs=href="https://en.wikipedia.org/"|content=English Wikipedia}} → <a href="https://en.wikipedia.org/">English Wikipedia</a>

TemplateData

This is the TemplateData for Template:Tag, for use by TemplateWizard, VisualEditor and other tools.

Template description

Produce preformatted examples of markup-style (HTML, XML…) tags in a monospace font

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Tag name	`1`	The name of the tag (appears immediately after the < character Example figure	Line	required
Output type	`2`	Select the desired tag output structure from among: close only, empty/single/void and pair Suggested values `c` `close` `e` `empty` `o` `open` `p` `pair` `s` `single` `v` `void` Default pair Example v	Line	required
Tag-wrapped content	`content`	The text content to be shown "wrapped" by the tags, immediately following the open tag and/or followed by the close tag Example Structured data	Content	optional
Tag attributes	`attribs` `params`	Additional tag attributes to be shown following the tag name in the open tag; only valid when output type is set to: e/empty, o/open, p/pair, s/single or v/void Example id="meh" inline	Line	optional
Link tag name	`link`	Links the tag name to the English Wikipedia article section that describes it when assigned any value Suggested values `true` `on` `yes` `y` `1` Example on	Line	optional
Allow line breaks	`wrap`	Remove class=nowrap from the span tags generated to contain the template output, permitting line breaks as needed Suggested values `true` `on` `yes` `y` `1` Example yes	Line	optional
Custom CSS styles	`style`	Add custom CSS style declarations to the span tags that enclose the template output Example color: firebrick; font-size: 1.1em;	Line	optional