Template:Button doc

This is a documentation subpage for Template:Button.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 48,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template provides a "clickable button" formatting style for text. This button is not clickable, and care should be taken when using it to avoid readers thinking the result may be. (It has an explanatory tooltip for users hovering over it, but that may not always be displayed, or only displayed after too long a delay, so that it may not show up to people trying to click it.)

If you need a clickable button, use {{Clickable button}}.

Usage

{{Button|text=button text}} produces button text
{{Button|text=button text|format=bold}} produces button text
{{Button|[[File:WikEd close.png]]|padTB=.1em|padLR=.1em}} produces
{{Button|text=button text|bgcolor1=#EEF|bgcolor2=#BBE}} produces button text
[[target title|{{Button|linked text}}]] produces linked text, and [https://en.wikipedia.org {{Button|linked text}}] for linked text. {{clickable button}} is more suitable for that purpose though.

Alternatively, {{Button|button text}} also produces button text

{{Key press}} – used to illustrate keystrokes, including key combinations (e.g. Ctrl+x)
{{Key top}} – produces a similar visual effect, but includes more symbols and does not directly support key combos (e.g. ⇬ Caps Lock)
{{Kbd}} – to indicate user input (of any kind) without making it look like keys or buttons

v t e Button templates
General button templates	{{Clickable button}} {{Branded button}} {{Button}} (not clickable) {{Blue button}} {{MediaWiki button}} {{Expandable button}}
WikiProject-specific buttons	Article Wizard button button2 button wizard {{Big Blue Button}} {{Big Red Button}} {{Big Cyan Button}} {{Big Green Button}} {{Big Lime Button}} {{Big Orange Button}} {{Big Turquoise Button}} {{Big Fuchsia Button}} {{Big Skyblue Button}} {{Big Purple Button}} {{Big Yellow Button}} {{AfC button}} {{Cleanup Button}}
Category

Semantic markup templates

Template	Example output	Use
{{strong}}	Important!	To indicate <strong> importance, seriousness, or urgency instead of just simple typographical boldfacing
{{strongbad}}	"Never use ..."	Same as {{strong}} but in red
{{stronggood}}	"Only use ..."	Same as {{strong}} but in green
{{em}}	"An emphatic phrase"	To indicate <em> stress emphasis (not just purely typographical italicization like for book titles or foreign terms)
{{var}}	`strPrefix`	To indicate text is a variable name. Use for any variable names except those including "I" (uppercase i) and/or "l" (lowercase L); for these, {{var serif}} should be used to ensure a noticeable distinction
{{var serif}}	`strIllustratePrefix`	(see {{var}} above)
{{mvar}}	Let $x$ be the maximum value used.	Used to refer to individual variables in <math> (formula) elements in normal running text.
{{dfn}}	This term has a definition	To indicate a term defined in nearby text.
{{dfni}}	This term has a definition	Wrapper for {{dfn}} that applies metadata and italic styling.
{{lang}}	She said: "Je suis française."	Indicate that a piece of text belongs to a particular language other than that of the page as a whole.
{{tld}}	`{{DEFAULTSORT:Y, X}}`	To display wikicode variables and magic words as they would appear in code
{{parameter}}	`\|year=2008`	To display template parameters with or without values
{{param}}	`{{{title\|alt}}}`	To display parameters as used in code (i.e. with triple braces), especially to indicate relationships between them. May be combined with {{parameter}} above
{{param value}}	`··2·blanks·fore·and·aft··`	To display parameter values lightly bordered; replaces <code>...</code>, especially when value contains embedded or leading/trailing blanks; visualized here with middot (·) but can use ␠, ▯, or any character.
{{tlx}} etc.	`{{Template\|1\|2\|...\|10}}`	To display a template call (with or without parameters and values) as code
{{tag}}	"The `<img>...</img>` tags ..."	To render HTML elements ("tags") in prose
{{code}}/{{codett}}	"Ensure the `alt=` parameter ..."	To indicate text is source code. To nest other templates within {{code}}, use `<code>...</code>`. {{codett}} differs only in styling: `someMethod` becomes `someMethod`
{{PreCode}}	"FORTH has keyword `?BRANCH`."	Like {{code}}, but prevents line breaks inside the code. Only for very short code parts.
{{subst:codenowiki}}	`{{small\|small text example}}`	To wrap example code in `<code><nowiki>...</nowiki></code>`
{{subst:kbdnowiki}}	`{{large\|large text example}}`	To wrap example code in `<kbd><nowiki>...</nowiki></kbd>`
{{syntaxhighlight}}	<table align=center style="background: ivory">	( or `{{sxhl}}` ) Wrapper for `<syntaxhighlight>...</syntaxhighlight>`, but will wrap overflowing text
{{deprecated code}}	"Do not use `<blink>`."	( or `{{dc}}` ) To indicate deprecated source code in template documentation, articles on HTML specs, etc. The `{{dc2}}` variant uses strike-through (`<blink>`) while `{{dcr}}` uses red (`<blink>`).
{{pre}}	You miss 100% of the shots you don't take	For larger blocks of source code and other pre-formatted text
{{blockquote}}	No good deed goes unpunished	For block quotations (only – never for non-quotations)
{{block indent}}	Hurry and succumb to temptation before it goes away	For indented blocks of material; visually identical to `{{quote}}` but without quote markup
{{kbd}}	`user input`	To indicate user input
{{key press}}	`Ctrl`+`x`	To indicate specific-keystroke input, including combinations
{{key top}}	`Left shift`	Similar; includes more symbols, but does not directly support combinations
{{button}}	`Don't save`	To indicate a button in a user interface
{{samp}}	`example output`	To indicate sample or example output

Template:Button/doc

Usage

See also

Content Disclaimer