</noinclude>
|
Plantilla:Hatnote
Plantilla:COinS safe
Plantilla:High-use
The template Plantilla:Tl is used to write an abbreviation (including an acronym or initialism) with its meaning. It is a wrapper for the HTML element Plantilla:Tag, to create a tooltip indicating the meaning of the term. The Plantilla:Tl variant is the same, except it uses the Plantilla:Tag element, and is for providing mouse-over notes about non-abbreviations.
Usage
The template Plantilla:Tlx and its Plantilla:Tlx variant take two unnamed parameters, in order:
|1=
or first unnamed parameter: the term to be explained; shows as text, and may use wikimarkup, such as a link to an article about what it refers to.
|2=
or second unnamed parameter: the expansion or definition or other note about the term; shows as the popup when you hover over the term. Plantilla:Strong can be used in this parameter.
Use explicitly numbered parameters if a parameter's content contains the equals (Plantilla:Kbd) character:
- Complex example:
[[Mass–energy equivalence|{{abbr|{{math|''E'' {{=}} ''mc''<sup>2</sup>}}|2=Energy = mass times the speed of light squared}}]] - Produces: [[Mass–energy equivalence|Plantilla:Abbr]]
Named parameters (usually not needed) and the input they take:
|class=
- One or more CSS classes (space-separated if more than one)
|id=
- An HTML
id(i.e., a#Plantilla:Varlink anchor); this must be unique on the entire page. |style=
- Arbitrary inline CSS to apply to the displayed text of the term (has no effect on the tooltip text). For any input that needs to be quotation-marked (e.g. because it contains a space character), use straight single-quotes only, e.g.
|style=font-family: 'Times New Roman', serif;
Examples
When hovering over the text "Plantilla:Abbr", something like Plantilla:Titlehint will appear as a tooltip in most browsers. Popular screen readers, used by visually impaired readers, give the meaning in a different way.
Linking must be done a particular way
To wiki-link the abbreviation being marked up by this template, wrap the template in the link, not vice-versa, or the meaning will not appear in some browsers, including Chrome.
| Compatibility | Markup | Renders as |
|---|---|---|
| Plantilla:Yes | Plantilla:Code | [[Knockout#Technical knockout|Plantilla:Abbr]] |
| Plantilla:No | Plantilla:Code | Plantilla:Abbr |
Do not link, or use any other wikimarkup or HTML markup, in the meaning (popup) – only plain text.
The mouse-over popup for the meaning text is created by a title= attribute inside an Plantilla:Tag HTML element's opening tag, so it cannot itself contain any HTML (or markup that resolves to HTML when rendered). This includes simple things like ''italics''.
Accessibility and HTML validity concerns
This template is intended Plantilla:Em for use with abbreviations (including acronyms and initialisms).
The Web Content Accessibility Guidelines contain guidelines for using the Plantilla:Tag element generated by this template; see section H28: Providing definitions for abbreviations by using the abbr and acronym elements.
Furthermore, the HTML specifications (both those of the W3C and WHATWG) strictly define the Plantilla:Tag element as reserved for markup of abbreviations. Abusing it for mouse-over tooltips breaks our semantic markup and makes our content Plantilla:Em (technically, "not well-formed"; it will pass an basic automated validator test because such a tool can't tell that the logical application of the data to the structure isn't correct, only that tags are nested properly, etc.).
Redirects
The following template names will redirect to Plantilla:Tl:
Plantilla:Tl is a separate template sharing the same documentation.
Template data
This template defines an abbreviation or acronym, by creating a tooltip that is displayed on mouse-over.
| Parámetro | Descripción | Tipo | Estado | |
|---|---|---|---|---|
| Term | 1 | Shows as text | Línea | obligatorio |
| Meaning | 2 | Shows as a mouse-over tooltip | Cadena | obligatorio |
| CSS | style | applies the specified CSS directives to the content of parameter 1 | Cadena | opcional |
| Class | class | Adds a one or more CSS classes | Cadena | opcional |
| ID | id | Adds an HTML id (must be unique in the page) | Cadena | opcional |
See also
- Plantilla:Tl, a variant of this template that includes automatic wikilinking of the term (abbreviation).
- Plantilla:Tl, same as Plantilla:Tl except with parameters 1 and 2 reversed, and some parameters to control linking
- Plantilla:Tl, which generates the code number for an R-phrase (a "risk phrase", e.g. "Explosive when dry"). The R-phrase itself is included in a tooltip, and the code links to List of R-phrases.