ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Clickable button
 | This template is used in system messages. Changes to it can cause immediate changes to the Wikipedia user interface. To avoid major disruption, 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. Please discuss changes on the talk page before implementing them. |
 | This template uses Lua: |
This template styles a link like a button, using the deprecated mediawiki.ui.button module. This expands the clickable area and tap target for the link.
Usage
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]- All parameters
{{Clickable button|wikilink|display|color=color|url=url|class=class|link=}}- wikilink
- Unnamed first parameter; the title of the page being linked. Brackets are not necessary
- display (optional)
- Optional unnamed second parameter; the text to display. Not needed if the text to display is the wikilink itself
|color=or|class=- Color to display.
|color=acceptsblueandred,|class=acceptsmw-ui-progressiveandmw-ui-destructive |url=- URL to link through the button. If no wikilink/display text is provided, will show the URL, otherwise will show the wikilink/display text
|link=no- Use this parameter set to "no" to display a button without linking to anything
Examples
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]Wikilinks
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]Colors
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]- ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Demo inline – without defined
|color=and|class=, the default is a white button - ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Demo inline
- ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Demo inline
- ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Demo inline
- ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Demo inline
URLs
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]Adding an icon
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]Adding an icon to a button should be avoided. Don't forget to hide the icon from the accessibility DOM by wrapping it in a span that is ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Attr so that a screen reader doesn't read it out loud.
<span class="mw-ui-button mw-ui-progressive"><span aria-hidden="true">[[File:OOjs UI icon logo-wikimediaCommons-invert.svg|15px|link=|alt=]]</span> More details</span>
More details
Template data
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]Styles a link like a button, using the mediawiki.ui.button module
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Link/Label | 1 | Defines the page to link to, and uses that page's title as the text for the button
| Page name | required |
| Label | 2 | Defines the text that appears on the button
| Unknown | suggested |
| URL | url | Defines a web address for the button to link to
| URL | optional |
| class | class | Defines the visual type of the button
| String | optional |
| Custom CSS styling | style | Allows custom CSS styling to be applied to the button
| String | optional |
| Category switch | category | Whether or not categories should be on
| Boolean | optional |
| color | color | Defines the visual type of the button
| String | optional |
See also
[ᥛᥥᥰ ᥗᥖᥴ ᥒᥝᥲ ᥒᥣᥱ]- commons:Template:Clickable button, corresponding clickable button at Commons.
- Wikimedia design style guide advice on buttons
- phab:T146923, which dropped support for
mw-ui-constructive, the CSS class for green buttons