Misplaced Pages

Template:Clickable button: Difference between revisions

Article snapshot taken from Wikipedia with creative commons attribution-sharealike license. Give it a read and then ask your questions in the chat. We can research this topic together.
Browse history interactively← Previous editNext edit →Content deleted Content addedVisualWikitext
Revision as of 02:15, 25 July 2012 view sourceRyan Vesey (talk | contribs)Extended confirmed users, Pending changes reviewers, Rollbackers26,108 edits create example← Previous edit Revision as of 07:12, 26 July 2012 view source John of Reading (talk | contribs)Autopatrolled, Extended confirmed users, Pending changes reviewers767,601 edits Try changing <div> to <span>Next edit →
Line 1: Line 1:
<noinclude>{{Clickable button|]}}</noinclude><div class="submit ui-button ui-widget ui-state-default ui-corner-all ui-button-text-only" role="button" aria-disabled="false"><span class="ui-button-text">{{{1|}}}</span></div><noinclude> <noinclude>{{Clickable button|]}}</noinclude><span class="submit ui-button ui-widget ui-state-default ui-corner-all ui-button-text-only" role="button" aria-disabled="false"><span class="ui-button-text">{{{1|}}}</span></span><noinclude>


{{documentation}} {{documentation}}

Revision as of 07:12, 26 July 2012

Clickable button

Template documentation[view] [edit] [history] [purge] Shortcuts
This template uses Lua:
WarningThis template is used in system messages, and on approximately 1,060,000 pages, or roughly 2% of all pages.
Changes to it can cause immediate changes to the Misplaced Pages user interface.
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. Please discuss changes on the talk page before implementing them.
Buttons should not be used in the article namespace. If the desire is to "navigate" a reader to a new page, taking them away from the current page, a link is preferred. Buttons are used within Misplaced Pages to trigger an "action".

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= accepts blue and red, |class= accepts mw-ui-progressive and mw-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

{{Clickable button|Main Page}} → Main Page
{{Clickable button|Main Page|Click here to visit the main page}} → Main Page
{{Clickable button|Click here|link=no}} → Click here

Colors

{{Clickable button|Main Page}} → Main Page – without defined |color= and |class=, the default is a white button
{{Clickable button|Main Page|color=blue}} → Main Page
{{Clickable button|Main Page|color=red}} → Main Page
{{Clickable button|Main Page|class=mw-ui-progressive}} → Main Page
{{Clickable button|Main Page|class=mw-ui-destructive}} → Main Page

URLs

{{Clickable button|url=https://example.com}}
{{Clickable button|Example|url=https://example.com}} → Example
{{Clickable button|2=Example|url=https://example.com}}

Template data

Styles a link like a button, using the mediawiki.ui.button module

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Link/Label1

Defines the page to link to, and uses that page's title as the text for the button

Example
Foobar
Page namerequired
Label2

Defines the text that appears on the button

Default
the page being linked to
Unknownsuggested
URLurl

Defines a web address for the button to link to

Example
https://www.example.com
URLoptional
classclass

Defines the visual type of the button

Suggested values
mw-ui-progressive mw-ui-destructive
Stringoptional
Custom CSS stylingstyle

Allows custom CSS styling to be applied to the button

Default
None
Example
border: 2px solid red;
Stringoptional
Category switchcategory

Whether or not categories should be on

Default
yes
Example
no
Auto value
0
Booleanoptional
colorcolor

no description

Suggested values
blue red green
Unknownoptional

See also

Button templates
General button templates
WikiProject-specific buttons
The above documentation is transcluded from Template:Clickable button/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template. Categories: