Template:Key top/doc

使用

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. 🔴.

例子

{{key top|return}} → ↩ return

{{key top|Return}} → ↩ Return

{{key top|RETURN}} → ↩ RETURN

{{key top|Return|}} → ↩

{{key top|Enter}} → ⌅ Enter

{{key top|Return|Enter}} → ↩ Enter

{{key top|Return||}} → ↩

{{key top|Return||true}} → ↩

{{key top|Return||narrow}} → ↵

{{key top|Return||hollow}} → ⏎

{{key top|Return||thin}} → ↵

{{key top|Return||thick}} → ⏎

{{key top|Return|Return|narrow}} → ↵ Return

{{key top|Ctrl}} → ⌃ Ctrl

{{key top|Ctrl|3=true}} → ⎈ Ctrl

{{key top|Alt}} → ⎇ Alt

{{key top|Option}} → ⌥ Option

{{key top|Option|Alt}} → ⌥ Alt

{{key top|Windows}} → ⌘ Windows

{{key top|Command}} → ⌘ Command

{{key top|Meta}} → ◆ Meta

{{key top|Super}} → ❖ Super

{{key top|Windows|3=true}} → ⊞ Windows

{{key top|Super|Windows}} → ❖ Windows

模板資料

这是用于新版可视化编辑器及其他工具的模板数据文档。

Key top模板数据

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

模板参数

参数		描述	类型	状态
name	1	The standard or common name of the key. 示例值 Shift	单行文本	必需
label	2	Label for the key if different from the name, leave empty to suppress label. 示例值 Level 2 Select	单行文本	可选
alternate symbol	3	Switch for certain alternate symbols (return, control, insert, stop, record) 示例值 true	布尔	可选

參見

• {{Key press}} – 產生類似視覺效果，但包含更少的符號，同時直接支持組合（e.g. Ctrl）
• {{Button}} – 產生類似視覺效果，但沒有語義標記（e.g. sample text）；更多用於表示界面元素。
• {{Playstation key press}} – 模擬遊戲手柄按鈕（e.g. {{Playstation key press|s}}）
• {{Kbd}} – to indicate user input (of any kind) without making it look like keys or buttons