Difference between revisions of "Template:Keypress/doc"

From MidrangeWiki
Jump to: navigation, search
(improving doc for parms 1-2-3 and optional background=)
(adding information about using arrows in Template:keypress)
 
Line 18: Line 18:
 
| (optional parameter) background=
 
| (optional parameter) background=
 
}}</pre>
 
}}</pre>
 +
 +
===Arrows===
 +
Arrows can be placed inside the template by using the [[wikipedia:List_of_XML_and_HTML_character_entity_references]] as shown below.  Due to wiki-substitution the leading {{code|&}} sign was not included in the "code" columns.
 +
{| style="position:relative; margin: 0 0 0.5em 1em; border-collapse: collapse;  background:white; clear:right; text-align:center;" border="1" cellpadding="7"
 +
|-
 +
! rowspan="2" | Description
 +
! colspan="3" | Single line
 +
! colspan="3" | Double line
 +
|-
 +
! code<br>(add leading &)
 +
! colspan="2" | sample
 +
! code<br>(add leading &)
 +
! colspan="2" | sample
 +
|-
 +
| Right arrow
 +
| rarr;
 +
| &rarr;
 +
| {{keypress|&rarr;}}
 +
| rArr;
 +
| &rArr;
 +
| {{keypress|&rArr;}}
 +
|-
 +
| Left arrow
 +
| larr;
 +
| &larr;
 +
| {{keypress|&larr;}}
 +
| lArr;
 +
| &lArr;
 +
| {{keypress|&lArr;}}
 +
|-
 +
| Up arrow
 +
| uarr;
 +
| &uarr;
 +
| {{keypress|&uarr;}}
 +
| uArr;
 +
| &uArr;
 +
| {{keypress|&uArr;}}
 +
|-
 +
| Down arrow
 +
| darr;
 +
| &darr;
 +
| {{keypress|&darr;}}
 +
| dArr;
 +
| &dArr;
 +
| {{keypress|&dArr;}}
 +
|-
 +
| Horizontal arrow
 +
| harr;
 +
| &harr;
 +
| {{keypress|&harr;}}
 +
| hArr;
 +
| &hArr;
 +
| {{keypress|&hArr;}}
 +
|}
  
 
==Examples==
 
==Examples==

Latest revision as of 13:53, 26 March 2008

48px This is the template documentation page for {{Keypress}}.
It is not intended to be viewed directly. If it uses variables, some links may appear broken. Do not replace these variables with hardcoded page names or URLs.

Documentation

{{keypress}} is a standard way to display one (1) to three (3) concurrent keyboard keystrokes, connected by the + sign if there are two or more parameters.

Parameters

  • Positional parameter 1 is required and can be a single letter or string
  • Positional parameters 2 and 3 are optional and can be single letters or strings
  • Named parameter background is optional and is in one of the following formats:
Six digit hex color code, including the leading # symbol
or
The text name of one of the sixteen colors of the HTML 4.01 specification HTML color names
{{keypress 
| letter(s) for first key box 
| (optional parameter) letter(s) for second key box
| (optional parameter) letter(s) for third key box
| (optional parameter) background=
}}

Arrows

Arrows can be placed inside the template by using the wikipedia:List_of_XML_and_HTML_character_entity_references as shown below. Due to wiki-substitution the leading & sign was not included in the "code" columns.

Description Single line Double line
code
(add leading &)
sample code
(add leading &)
sample
Right arrow rarr; rArr;
Left arrow larr; lArr;
Up arrow uarr; uArr;
Down arrow darr; dArr;
Horizontal arrow harr; hArr;

Examples

Code Result
Single parameter, single letter
{{keypress|A}}
A
Single parameter, multiple letters
{{keypress|Shift}}
Shift
Multiple parameter, multiple letters
{{keypress|Ctrl|Alt|Del}}
Ctrl+Alt+Del
Multiple parameter, multiple letters with background= parameter
{{keypress|Shift|F3|background=#FF00FF}}
Shift+F3
{{keypress|Shift|F3|background=aqua}}
Shift+F3