mirror of
				https://github.com/mfulz/qmk_firmware.git
				synced 2025-11-03 23:02:34 +01:00 
			
		
		
		
	Doc followup 9942 (#10473)
* Update feature_advanced_keycodes.md * Update mod_tap.md
This commit is contained in:
		
							parent
							
								
									f63a60a72a
								
							
						
					
					
						commit
						0cb7133e0d
					
				@ -2,21 +2,24 @@
 | 
			
		||||
 | 
			
		||||
These allow you to combine a modifier with a keycode. When pressed, the keydown event for the modifier, then `kc` will be sent. On release, the keyup event for `kc`, then the modifier will be sent.
 | 
			
		||||
 | 
			
		||||
|Key       |Aliases                        |Description                                         |
 | 
			
		||||
|----------|-------------------------------|----------------------------------------------------|
 | 
			
		||||
|`LCTL(kc)`|`C(kc)`                        |Hold Left Control and press `kc`                    |
 | 
			
		||||
|`LSFT(kc)`|`S(kc)`                        |Hold Left Shift and press `kc`                      |
 | 
			
		||||
|`LALT(kc)`|`A(kc)`, `LOPT(kc)`            |Hold Left Alt and press `kc`                        |
 | 
			
		||||
|`LGUI(kc)`|`G(kc)`, `LCMD(kc)`, `LWIN(kc)`|Hold Left GUI and press `kc`                        |
 | 
			
		||||
|`RCTL(kc)`|                               |Hold Right Control and press `kc`                   |
 | 
			
		||||
|`RSFT(kc)`|                               |Hold Right Shift and press `kc`                     |
 | 
			
		||||
|`RALT(kc)`|`ROPT(kc)`, `ALGR(kc)`         |Hold Right Alt and press `kc`                       |
 | 
			
		||||
|`RGUI(kc)`|`RCMD(kc)`, `LWIN(kc)`         |Hold Right GUI and press `kc`                       |
 | 
			
		||||
|`SGUI(kc)`|`SCMD(kc)`, `SWIN(kc)`         |Hold Left Shift and GUI and press `kc`              |
 | 
			
		||||
|`LCA(kc)` |                               |Hold Left Control and Alt and press `kc`            |
 | 
			
		||||
|`LCAG(kc)`|                               |Hold Left Control, Alt and GUI and press `kc`       |
 | 
			
		||||
|`MEH(kc)` |                               |Hold Left Control, Shift and Alt and press `kc`     |
 | 
			
		||||
|`HYPR(kc)`|                               |Hold Left Control, Shift, Alt and GUI and press `kc`|
 | 
			
		||||
|Key       |Aliases                        |Description                                           |
 | 
			
		||||
|----------|-------------------------------|------------------------------------------------------|
 | 
			
		||||
|`LCTL(kc)`|`C(kc)`                        |Hold Left Control and press `kc`                      |
 | 
			
		||||
|`LSFT(kc)`|`S(kc)`                        |Hold Left Shift and press `kc`                        |
 | 
			
		||||
|`LALT(kc)`|`A(kc)`, `LOPT(kc)`            |Hold Left Alt and press `kc`                          |
 | 
			
		||||
|`LGUI(kc)`|`G(kc)`, `LCMD(kc)`, `LWIN(kc)`|Hold Left GUI and press `kc`                          |
 | 
			
		||||
|`RCTL(kc)`|                               |Hold Right Control and press `kc`                     |
 | 
			
		||||
|`RSFT(kc)`|                               |Hold Right Shift and press `kc`                       |
 | 
			
		||||
|`RALT(kc)`|`ROPT(kc)`, `ALGR(kc)`         |Hold Right Alt and press `kc`                         |
 | 
			
		||||
|`RGUI(kc)`|`RCMD(kc)`, `LWIN(kc)`         |Hold Right GUI and press `kc`                         |
 | 
			
		||||
|`SGUI(kc)`|`SCMD(kc)`, `SWIN(kc)`         |Hold Left Shift and GUI and press `kc`                |
 | 
			
		||||
|`LCA(kc)` |                               |Hold Left Control and Alt and press `kc`              |
 | 
			
		||||
|`LSA(kc)` |                               |Hold Left Shift and Left Alt and press `kc`           |
 | 
			
		||||
|`RSA(kc)` |`SAGR(kc)`                     |Hold Right Shift and Right Alt (AltGr) and press `kc` |
 | 
			
		||||
|`RCS(kc)` |                               |Hold Right Control and Right Shift and press `kc`     |
 | 
			
		||||
|`LCAG(kc)`|                               |Hold Left Control, Alt and GUI and press `kc`         |
 | 
			
		||||
|`MEH(kc)` |                               |Hold Left Control, Shift and Alt and press `kc`       |
 | 
			
		||||
|`HYPR(kc)`|                               |Hold Left Control, Shift, Alt and GUI and press `kc`  |
 | 
			
		||||
 | 
			
		||||
You can also chain them, for example `LCTL(LALT(KC_DEL))` or `C(A(KC_DEL))` makes a key that sends Control+Alt+Delete with a single keypress.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
@ -27,22 +27,25 @@ This key would activate Left Control and Left Shift when held, and send Escape w
 | 
			
		||||
 | 
			
		||||
For convenience, QMK includes some Mod-Tap shortcuts to make common combinations more compact in your keymap:
 | 
			
		||||
 | 
			
		||||
|Key         |Aliases                                                          |Description                                            |
 | 
			
		||||
|------------|-----------------------------------------------------------------|-------------------------------------------------------|
 | 
			
		||||
|`LCTL_T(kc)`|`CTL_T(kc)`                                                      |Left Control when held, `kc` when tapped               |
 | 
			
		||||
|`LSFT_T(kc)`|`SFT_T(kc)`                                                      |Left Shift when held, `kc` when tapped                 |
 | 
			
		||||
|`LALT_T(kc)`|`LOPT_T(kc)`, `ALT_T(kc)`, `OPT_T(kc)`                           |Left Alt when held, `kc` when tapped                   |
 | 
			
		||||
|`LGUI_T(kc)`|`LCMD_T(kc)`, `LWIN_T(kc)`, `GUI_T(kc)`, `CMD_T(kc)`, `WIN_T(kc)`|Left GUI when held, `kc` when tapped                   |
 | 
			
		||||
|`RCTL_T(kc)`|                                                                 |Right Control when held, `kc` when tapped              |
 | 
			
		||||
|`RSFT_T(kc)`|                                                                 |Right Shift when held, `kc` when tapped                |
 | 
			
		||||
|`RALT_T(kc)`|`ROPT_T(kc)`, `ALGR_T(kc)`                                       |Right Alt when held, `kc` when tapped                  |
 | 
			
		||||
|`RGUI_T(kc)`|`RCMD_T(kc)`, `RWIN_T(kc)`                                       |Right GUI when held, `kc` when tapped                  |
 | 
			
		||||
|`SGUI_T(kc)`|`SCMD_T(kc)`, `SWIN_T(kc)`                                       |Left Shift and GUI when held, `kc` when tapped         |
 | 
			
		||||
|`LCA_T(kc)` |                                                                 |Left Control and Alt when held, `kc` when tapped       |
 | 
			
		||||
|`LCAG_T(kc)`|                                                                 |Left Control, Alt and GUI when held, `kc` when tapped  |
 | 
			
		||||
|`RCAG_T(kc)`|                                                                 |Right Control, Alt and GUI when held, `kc` when tapped |
 | 
			
		||||
|`C_S_T(kc)` |                                                                 |Left Control and Shift when held, `kc` when tapped     |
 | 
			
		||||
|`MEH_T(kc)` |                                                                 |Left Control, Shift and Alt when held, `kc` when tapped|
 | 
			
		||||
|Key         |Aliases                                                          |Description                                                   |
 | 
			
		||||
|------------|-----------------------------------------------------------------|--------------------------------------------------------------|
 | 
			
		||||
|`LCTL_T(kc)`|`CTL_T(kc)`                                                      |Left Control when held, `kc` when tapped                      |
 | 
			
		||||
|`LSFT_T(kc)`|`SFT_T(kc)`                                                      |Left Shift when held, `kc` when tapped                        |
 | 
			
		||||
|`LALT_T(kc)`|`LOPT_T(kc)`, `ALT_T(kc)`, `OPT_T(kc)`                           |Left Alt when held, `kc` when tapped                          |
 | 
			
		||||
|`LGUI_T(kc)`|`LCMD_T(kc)`, `LWIN_T(kc)`, `GUI_T(kc)`, `CMD_T(kc)`, `WIN_T(kc)`|Left GUI when held, `kc` when tapped                          |
 | 
			
		||||
|`RCTL_T(kc)`|                                                                 |Right Control when held, `kc` when tapped                     |
 | 
			
		||||
|`RSFT_T(kc)`|                                                                 |Right Shift when held, `kc` when tapped                       |
 | 
			
		||||
|`RALT_T(kc)`|`ROPT_T(kc)`, `ALGR_T(kc)`                                       |Right Alt when held, `kc` when tapped                         |
 | 
			
		||||
|`RGUI_T(kc)`|`RCMD_T(kc)`, `RWIN_T(kc)`                                       |Right GUI when held, `kc` when tapped                         |
 | 
			
		||||
|`SGUI_T(kc)`|`SCMD_T(kc)`, `SWIN_T(kc)`                                       |Left Shift and GUI when held, `kc` when tapped                |
 | 
			
		||||
|`LCA_T(kc)` |                                                                 |Left Control and Alt when held, `kc` when tapped              |
 | 
			
		||||
|`LSA_T(kc)` |                                                                 |Left Shift and Alt when held, `kc` when tapped                |
 | 
			
		||||
|`RSA_T(kc)` |`SAGR_T(kc)`                                                     |Right Shift and Right Alt (AltGr) when held, `kc` when tapped |
 | 
			
		||||
|`RCS_T(kc)` |                                                                 |Right Control and Right Shift when held, `kc` when tapped     |
 | 
			
		||||
|`LCAG_T(kc)`|                                                                 |Left Control, Alt and GUI when held, `kc` when tapped         |
 | 
			
		||||
|`RCAG_T(kc)`|                                                                 |Right Control, Alt and GUI when held, `kc` when tapped        |
 | 
			
		||||
|`C_S_T(kc)` |                                                                 |Left Control and Shift when held, `kc` when tapped            |
 | 
			
		||||
|`MEH_T(kc)` |                                                                 |Left Control, Shift and Alt when held, `kc` when tapped       |
 | 
			
		||||
|`HYPR_T(kc)`|`ALL_T(kc)`                                                      |Left Control, Shift, Alt and GUI when held, `kc` when tapped - more info [here](http://brettterpstra.com/2012/12/08/a-useful-caps-lock-key/)|
 | 
			
		||||
 | 
			
		||||
## Caveats
 | 
			
		||||
 | 
			
		||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user