Permanently protected template

Template:Abbr

From Wikipedia, the free encyclopedia
Jump to: navigation, search
Documentation icon Template documentation[view] [edit] [history] [purge]
For inline cleanup templates requesting definitions or explanations, see {{Definition}} and {{Elucidate}}.

The template {{Abbr}} is used to write an abbreviation with its meaning. It is a front-end for the HTML element <abbr>...</abbr>, the element used by most web browsers to create a tooltip indicating the meaning of an abbreviation or acronym.

Please note: Do not use {{abbr}} or <abbr> to mark up material other than abbreviations or acronyms. Using it to generate tooltips elsewhere is a misuse of the underlying HTML and causes accessibility problems.

Usage

The template {{abbr}} takes two unnamed parameters, in order:

  • abbreviation: The abbreviation; shows as text.
  • meaning: The meaning; shows as the tooltip.

A third unnamed parameter accepts the following values:

Named parameters:

  • class: Adds a CSS class.
  • id: Adds a HTML id; this must be unique on the entire page.
  • style: Adds a style attribute.

Examples

Markup Renders as
{{abbr|MSLP|Mean Sea Level Pressure}} 
MSLP

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

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

Accessibility concerns

This template is intended for use with abbreviations; it is not intended to be a tool for generating tooltips. The 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.

Redirects

The following template names redirect to this one:

Template data

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Abbr

This template defines an abbreviation or acronym, by creating a tooltip that is displayed on mouse-over.

Template parameters
Parameter Description Type Status
Abbreviation 1

Shows as text

Default
empty
Example
empty
Auto value
empty
line required
Meaning 2

Shows as a tooltip

Default
empty
Example
empty
Auto value
empty
string required
IPA IPA

Applies {{IPA}} to fix strings in the International Phonetic Alphabet rendered in Internet Explorer on Windows XP

Default
empty
Example
empty
Auto value
empty
line optional
Unicode unicode

Applies {{unicode}} to fix strings in Unicode rendered in Internet Explorer on Windows XP

Default
empty
Example
empty
Auto value
empty
line optional
Class class

Adds a HTML class

Default
empty
Example
empty
Auto value
empty
line optional
ID id

Adds a HTML id

Default
empty
Example
empty
Auto value
empty
line optional

See also

  • {{abbrlink}}, a variant of this template that includes wikilinking.
  • {{discreet abbreviation}}, a variant of this template without the dotted underlining of the abbreviation/acronym.
  • {{R-phrase}}, which generates the abbreviation (the code number) for a R-phrase (a "risk phrase", e.g. "Explosive when dry"). The R-phrase itself and a link to List of R-phrases are included in a tooltip.
  • {{clarify}}, which produces the inline superscript: [clarification needed].