Template:Tooltip/doc

From American Election Wiki
Jump to navigation Jump to search

This template may be used to generate a tooltip when hovering over marked text.
Note: this template is § not to be used for expanding initialisms or acronyms; see template {{abbr}} for that instead. See § Notes for more details on access limitations for mobile and screen reader users.

Usage[edit source]

{{Tooltip|text to display inline in the article|pop-up tip}}
{{Tooltip|inline text|pop-up|dotted=no|link=yes|class=...|style=...|id=...}}

When not to use[edit source]

Abbreviations – the {{Tooltip}} template is not intended for use with abbreviations, including acronyms and initialisms); use template {{abbr}} for that instead.

Body text – the tooltip template should not be used within the body text of an article if possible (see MOS:NOTOOLTIPS).

Footnotes – Generic tooltip notes are not a substitute for footnotes and are intended to be used for navigational and other secondary features where space is limited. See Template:Glossary link or Template:Cite book/doc#Usage for practical examples.

Parameters[edit source]

There are two required positional parameters, and five optional named parameters:

  • |1= – the term to be explained; displays as text. Wiki markup is allowed but works more consistently when wrapping the template, see below for linking examples.
  • |2= – the tooltip/pop-up (no wiki or HTML markup allowed). The popup is created by an HTML title= attribute, so it cannot contain HTML (or markup that resolves to HTML when rendered). This includes simple things like ''italics''.
  • |dotted= – set to no to remove dotted underline decoration (default: use dotted underline)
  • |link= – set to yes to link the tooltip to the value in param 1 (default: tooltip is unlinked)

These three parameters take the standard values as defined by HTML and CSS:

  • |class= – one or more CSS classes (space-separated, enclosed in quotes)
  • |id= – an HTML ID must be unique on the entire page.
  • |style= – CSS to apply to the displayed text (no effect on tooltip/popup). Any style values with embedded blanks must be single-quoted, e.g. |style=font-family: 'Times New Roman', serif;

Examples[edit source]

  • {{tooltip|TKO|technical knockout}}TKO
  • {{tooltip|conflict of interest|COI as used in Wikipedia policy|dotted=no}}conflict of interest
  • {{tooltip|תוכן נִסתָר|תוכן ברור|dotted=no}}תוכן נִסתָר
  • {{tooltip|Sex gap|Difference in life expectancy for female and male}}Sex gap
  • {{tooltip|'''$31,152,975'''|Career prize money}}$31,152,975
  • {{tooltip|male|Assigned male at birth}}male
  • {{tooltip|Cupronickel|75% copper, 25% nickel}}Cupronickel
  • {{tooltip|ई|ī}}
  • {{tooltip|''Voyage with a Tail Wind''|simplified Chinese: 顺风相送; traditional Chinese: 順風相送; pinyin: Shùnfēng Xiāngsòng|dotted=no}}Voyage with a Tail Wind

Categorization[edit source]

Template data[edit source]

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Tooltip in articles based on its TemplateData.

TemplateData for Tooltip

A pop-up tooltip displayed on mouse-over.

Template parameters

ParameterDescriptionTypeStatus
Term1

Rendered in-line as normal text

Linerequired
Tooltip2

Shows as a pop-up, mouse-over tooltip

Stringrequired
Linklink

set to 'yes' to link the term to the article specified by Term

Default
no
Example
yes
Booleanoptional
Dotteddotted

applies the specified CSS directives to the content of parameter 1

Default
no
Example
yes
Booleanoptional
Stylestyle

applies the specified CSS directives to the content of parameter 1

Stringoptional
Classclass

Adds one or more CSS classes, separated by a blank

Stringoptional
IDid

Adds an HTML id (must be unique in the page)

Stringoptional

See also[edit source]

Notes[edit source]

  • This template is generally unusable on mobile devices, which lack the hover feature.
  • Screen readers are not able to voice content in hover pop-up text.