Template:Tooltip

From Second Life Wiki
Jump to navigation Jump to search

This word will show a tooltip when hovered upon.

[Edit] [🔄Purge] Template-info.png Template documentation
For inline cleanup templates requesting definitions or explanations, see {{Definition}} and {{Explain}}.


The template {{Abbr}} is used to write an abbreviation (including an acronym or initialism) with its meaning. It is a wrapper for the "Wikipedia logo"HTML "Wikipedia logo"element <abbr>...</abbr>, to create a tooltip indicating the meaning of the term. The {{Tooltip}} variant is the same, except it uses the <span>...</span> element, and is for providing mouse-over notes about non-abbreviations.

Please note: Do not use {{abbr}} or <abbr> to mark up material other than abbreviations (including acronyms). Using it to generate tooltips elsewhere is a misuse of the underlying HTML and causes "Wikipedia logo"accessibility problems. For general-purpose tooltips, use {{tooltip}} instead.

Note that readers on mobile devices typically do not have a mouse to hover with, and so generally cannot see tooltip contents. Mobile users may access tooltips via a tap by modifying the settings for "Wikipedia logo"Reference Tooltips, but this is not so useful on linked text, because the same tap that brings up the tooltip also follows the hyperlink to the destination page. As of 2021, approximately the same number of English Wikipedia page views occur on mobile vs. desktop web browsers.[1]

Usage

The template {{abbr}} and its {{tooltip}} 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. No wikimarkup can be used in this parameter.

Use explicitly numbered parameters if a parameter's content contains the equals (=) character:

  • Complex example: [[Mass–energy equivalence|{{abbr|{{math|''E'' {{=}} ''mc''<sup>2</sup>}}|2=Energy = mass times the speed of light squared}}]]
  • Produces: E = mc2

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 #ID name here link 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

{{abbr|MSLP|Mean Sea Level Pressure}}

When hovering over the text "MSLP", something like Mean Sea Level Pressure will appear as a tooltip in most browsers. Popular "Wikipedia logo"screen readers, used by visually impaired readers, give the meaning in a different way.

{{abbr|UK|United Kingdom|class=country-name|id=foobar}}

{{Wikipedia|WP:COI|{{tooltip|conflict of interest|in the specific sense employed in Wikipedia policy}}}} "Wikipedia logo"conflict of interest

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
Compatible [[Knockout#Technical knockout|{{abbr|TKO|technical knockout}}]] TKO
Less compatible {{abbr|[[Knockout#Technical knockout|TKO]]|technical knockout}} TKO

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 <abbr> 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

{{Abbr}} template is intended only for use with abbreviations (including acronyms and initialisms).

The "Wikipedia logo"Web Content Accessibility Guidelines contain guidelines for using the <abbr> 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 "Wikipedia logo"W3C and "Wikipedia logo"WHATWG) strictly define the <abbr> element as reserved for markup of abbreviations. Abusing it for mouse-over tooltips breaks our "Wikipedia logo"semantic markup and makes our content invalid HTML (technically, "not "Wikipedia logo"well-formed"; it will pass a basic "Wikipedia logo"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 "Wikipedia logo"redirect to {{Abbr}}:

{{Tooltip}} is a separate template sharing the same documentation.


Template data

This is the "Wikipedia logo"TemplateData for this template used by TemplateWizard, "Wikipedia logo"VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Tooltip

{
        "description": "This template defines an abbreviation or acronym, by creating a tooltip that is displayed on mouse-over.",
        "params": {
                "1": {
                        "label": "Term",
                        "description": "Shows as text",
                        "type": "string/line",
                        "required": true
                },
                "2": {
                        "label": "Meaning",
                        "description": "Shows as a mouse-over tooltip",
                        "type": "string",
                        "required": true
                },
                "style": {
                        "label": "CSS",
                        "description": "applies the specified CSS directives to the content of parameter 1",
                        "type": "string",
                        "required": false
                },
                "class": {
                        "label": "Class",
                        "description": "Adds a one or more CSS classes",
                        "type": "string",
                        "required": false
                },
                "id": {
                        "label": "ID",
                        "description": "Adds an HTML id (must be unique in the page)",
                        "type": "string",
                        "required": false
                }
        }
}

See also

  • {{Abbrlink}}, a variant of this template that includes automatic wikilinking of the term (abbreviation).
  • {{Hover title}}, same as {{Tooltip}} except with parameters 1 and 2 reversed, and some parameters to control linking [Note: this is not certain here on the Second Life Wiki]
  • {{dfn}}