Template:Key top

From imedwiki
Jump to navigation Jump to search

{{{1}}}

Template documentation[view] [edit] [history] [purge]

Usage

This template renders a key top as found on typewriters and computer keyboards including a standardized or common symbol if available, e.g. from ISO/IEC 9995-7. Keys for which there is an associated Wikipedia article are rendered with a hyperlink. Unlike {{key press}}, this template is not intended to be used for combinations of multiple keys, i.e. “keyboard shortcuts”. It shall be used in descriptions of the physical keys and their functions.

The first, mandatory parameter holds the “natural” key name which is used to select a symbol and link. Its contents is usually also output unchanged next to the symbol unless the second parameter is set to an explicit label, which most often will be blank to suppress the label. The third, also optional parameter, is a binary switch that toggles alternate representations of a very limited selection of symbols: vs. , vs. vs. , vs. , vs. and vs. 🔴.

Examples

Template:Tc↩ return
Template:Tc↩ Return
Template:Tc↩ RETURN
Template:Tc
Template:Tc⌅ Enter
Template:Tc↩ Enter
Template:Tc
Template:Tc
Template:Tc
Template:Tc
Template:Tc
Template:Tc
Template:Tc↵ Return
Template:Tc⌃ Ctrl
Template:Tc⎈ Ctrl
Template:Tc⎇ Alt
Template:Tc⌥ Option
Template:Tc⌥ Alt
Template:Tc⌘ Windows
Template:Tc⌘ Command
Template:Tc◆ Meta
Template:Tc❖ Super
Template:Tc⊞ Windows
Template:Tc❖ Windows

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Key top

Display symbolic key tops as seen on computer keyboards, phones and typewriters.

Template parameters

ParameterDescriptionTypeStatus
name1

The standard or common name of the key.

Example
Shift
Linerequired
label2

Label for the key if different from the name, leave empty to suppress label.

Example
Level 2 Select
Lineoptional
alternate symbol3

Switch for certain alternate symbols (return, control, insert, stop, record)

Example
true
Booleanoptional

See also

  • {{Key press}} – produces a similar visual effect, but includes fewer symbols while directly supporting combinations (e.g. Ctrl+x)
  • {{Button}} – produces a similar visual effect but without the semantic markup (e.g. sample text); more for representing interface elements.
  • {{Playstation key press}} – to simulate gamepad buttons (e.g. {{Playstation key press|s}})
  • {{Kbd}} – to indicate user input (of any kind) without making it look like keys or buttons
This template is based (in parts) on the Template:Key top from the free encyclopedia wikipedia and is licensed under GNU license for free documentation and the Creative Commons Attribution/Share Alike. On wikipedia there is a List of authors accessible. More about importing from wikipedia on page Imedwiki:Importing from wikipedia.