mirror of
https://github.com/qmk/qmk_firmware.git
synced 2024-12-04 17:05:17 +00:00
f6a7f4d4ac
Co-authored-by: peepeetee <43021794+peepeetee@users.noreply.github.com> Co-authored-by: Joy Lee <chang.li@westberrytech.com> Co-authored-by: LitoMore <LitoMore@users.noreply.github.com> Co-authored-by: Dasky <32983009+daskygit@users.noreply.github.com>
40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# Grave Escape
|
||
|
||
<!---
|
||
original document: 0.15.12:docs/feature_grave_esc.md
|
||
git diff 0.15.12 HEAD -- docs/feature_grave_esc.md | cat
|
||
-->
|
||
|
||
*译注：Grave键即标准键盘中Tab键上方的 <code>`</code> 键，该符号用于英法语等西语体系，辅助调整发音，中文中没有对应概念；Escape即Esc键*
|
||
|
||
若你使用60%或其它没有Fn键配列的键盘，会留意到没有独立的Escape键。Grave Escape功能可以让Grave键(<code>`</code>及`~`)与Escape共享一个按键
|
||
|
||
## 使用方法
|
||
|
||
在配列中使用 `KC_GESC` 替换 `KC_GRAVE` （一般都在`1`键左边）。默认点击会输出 `KC_ESC`，按下Shift或GUI键时，点击会输出 `KC_GRV`
|
||
|
||
## 操作系统视角
|
||
|
||
假如翠花按下GESC键，系统接收到的是KC_ESC字符。若翠花按住Shift再按下GESC，将输出 `~` 或是反引号。若翠花按住GUI/CMD/Win键，将仅输出<code>`</code>字符
|
||
|
||
## 键码
|
||
|
||
|键 |别名 |描述 |
|
||
|---------|-----------|------------------------------------------------------------------|
|
||
|`KC_GESC`|`GRAVE_ESC`|单击输出Escape, 按住Shift或GUI时输出<code>`</code> |
|
||
|
||
### 须留意
|
||
|
||
在macOS上 Command+<code>`</code>默认行为是“移动焦点到下一个窗口”，因此不会输出反引号。另外，即便在键盘配置中更改过快捷键，终端程序(Terminal)也通常会将这个操作视为循环切换窗口
|
||
|
||
## 配置
|
||
|
||
有几种键组合可以变更这种行为，如Windows下的Control+Shift+Escape、macOS下的Command+Option+Escape。若要调整，可以在 `config.h` 中通过 `#define` 配置
|
||
|
||
|定义 |描述 |
|
||
|--------------------------|-----------------------------------------|
|
||
|`GRAVE_ESC_ALT_OVERRIDE` |按住Alt时输出Escape |
|
||
|`GRAVE_ESC_CTRL_OVERRIDE` |按住Control时输出Escape |
|
||
|`GRAVE_ESC_GUI_OVERRIDE` |按住GUI时输出Escape |
|
||
|`GRAVE_ESC_SHIFT_OVERRIDE`|按住Shift时输出Escape |
|