Template:Tooltip/doc
| This is a documentation subpage for Template:Tooltip. It may contain usage information, categories and other content that is not part of the original template page. |
| icon | 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. |
| File:Handheld devices no.svg | This template does not display in the mobile view of Wikipedia; it is desktop only. See Template:Navbox visibility for a brief explanation. |
| Warning | This template is used on approximately 504,000 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. |
| icon | 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 |
Lua error in Module:TNT at line 159: Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Uses TemplateStyles.tab.
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 HTMLtitle=attribute, so it cannot contain HTML (or markup that resolves to HTML when rendered). This includes simple things like''italics''.|dotted=– set tonoto remove dotted underline decoration (default: use dotted underline)|link=– set toyesto 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 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]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 source]Notes
[edit source]- This template is not available on the Wikipedia:mobile app, which lacks the hover feature, but is usable on mobile devices in desktop view. As of 2023, more English Wikipedia page views occur on mobile than on desktop browsers.[1]
- Screen readers often have difficulty with plain hover pop-up text.