Template:Tooltip/doc
Template:Strong for Template:Terminate sentence It may contain usage information, categories and other content that is not part of the original template page. |
This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see Wikipedia:COinS. |
This template does not display in the mobile view of Wikipedia; it is desktop only. See Template:Navbox visibility for a brief explanation. |
This template is used on approximately 486,000 pages, or roughly 111468% of all pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
This template is used by one or more bots.
If you intend to change this template in any significant way, move it, or nominate it for deletion, please inform the bot operators. Thank you. The relevant bots are: User:AAlertBot. |
This template uses TemplateStyles: |
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]
{{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]
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]
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 HTMLtitle=
attribute, so it cannot contain HTML (or markup that resolves to HTML when rendered). This includes simple things like''italics''
.|dotted=
– set tono
to remove dotted underline decoration (default: use dotted underline)|link=
– set toyes
to link the tooltip to the value in param1
(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]
{{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]
Template data[edit]
TemplateData for Tooltip
A pop-up tooltip displayed on mouse-over.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Term | 1 | Rendered in-line as normal text | Line | required |
Tooltip | 2 | Shows as a pop-up, mouse-over tooltip | String | required |
Link | link | set to 'yes' to link the term to the article specified by Term
| Boolean | optional |
Dotted | dotted | applies the specified CSS directives to the content of parameter 1
| Boolean | optional |
Style | style | applies the specified CSS directives to the content of parameter 1 | String | optional |
Class | class | Adds one or more CSS classes, separated by a blank | String | optional |
ID | id | Adds an HTML id (must be unique in the page) | String | optional |
See also[edit]
Notes[edit]
- 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.