mac 使用Karabiner配置键盘映射(2)-核心标签的解读

KeyOverlaidModifier

使用场景:一般用在 改变Modifier(控制键,例如ctrl,command,alt等)的行为.

例如正常情况下,单独按下control或command 是没有反应(动作的),

但是我们可以通过KeyOverlaidModifier 增加反应.

实例:

目标:单独按下右边的command 触发Alfred

所以单独按下右边的command,触发F17就行:

<item>         <!--  右边的command,单独按下相当于F17,用于触发Alfred -->         <name>COMMAND_R to F17</name>         <appendix>(COMMAND_R Only, send F17)</appendix>         <identifier>private.command_r_only2f17</identifier>         <autogen>             --KeyOverlaidModifier--             KeyCode::COMMAND_R,             KeyCode::COMMAND_R,             KeyCode::F17         </autogen> </item>

为什么使用F17?因为F17不占用实体键

解说:

对KeyOverlaidModifier 下的行逐行解释:

第一行:原始按键;

第二行:和其他键组合按下时要映射的键(先按下该键,hold住,再按下其他键);

第三行:单独按下要映射的键.

单独按下右边的command,相当于按下F17,

和其他键组合按下时不变.

2.实例解说

 <item>         <!-- 左边的Option/Alt,单独按下相当于 command+T,用于IDEA中通过接口路径搜索 ,          (if no other modifiers pressed) -->         <name>OPTION_L to PAGEUP</name>         <appendix>(OPTION_L Only, send PAGEUP)</appendix>         <identifier>private.option_l2pageup</identifier>         <autogen>             --KeyOverlaidModifier--             KeyCode::OPTION_L, ModifierFlag::OPTION_L | ModifierFlag::NONE,             KeyCode::OPTION_L,             KeyCode::T,ModifierFlag::COMMAND_L         </autogen> </item>

第一行多了 ModifierFlag::OPTION_L | ModifierFlag::NONE

什么意思呢?

表示按下左边的option时,不能按下其他控制键.

先按下command(不松开),再按下左边的option 不会触发;

先按下右边的option,再按下左边的option 不会触发;

如果去掉ModifierFlag::OPTION_L | ModifierFlag::NONE,会是什么效果呢?

先按下command(不松开),再按下左边的option 会触发;

先按下右边的option,再按下左边的option 会触发;

3.__KeyOverlaidModifier__的高级用法

目标:把space映射成为右边的command,但是单独按下时仍然是space.

按下space,不松开(hold住),再按下其他键,那么space映射成为command;

space+C:复制

space+V:黏贴

松开space时,在没有其他键按下的情况下,space的效果就是空格

源码:

<!-- 单独按下space,就是space; 组合按下space,相当于按下command_left -->         <autogen>             __KeyOverlaidModifier__             KeyCode::SPACE, ModifierFlag::NONE,              <!--                 You need to put "KeyCode"s between @begin and @end                 when you want to specify multiple KeyCode.             -->             @begin             <!-- hold 'SPACE' ,即组合键 -->             KeyCode::COMMAND_R,             @end              @begin             <!-- release 'SPACE' -->             KeyCode::SPACE,             @end              Option::KEYTOKEY_AFTER_KEYUP,             KeyCode::VK_CONFIG_FORCE_OFF_notsave_samples_keyoverlaidmodifier_use_separator_1,             KeyCode::VK_CONFIG_FORCE_OFF_notsave_samples_keyoverlaidmodifier_use_separator_2,         </autogen>

4,进阶:为什么要使用ModifierFlag::<xxx> | ModifierFlag::NONE

解说:

(1)第一个autogen 的效果:

单独按下左边的option,触发IDEA中通过接口路径搜索(原始快捷键:command+T)

(2)第二个autogen的效果:

先按下space(hold住),再按下左边的option,触发:

option+space(先按下option,再按下space)

说白了,我要达到的目的是:option_left和space,不管哪个先按下(为了兼容手误),效果都是一样的.

重点:去掉上图标红1的ModifierFlag::OPTION_L | ModifierFlag::NONE 之后,

实现第二个autogen时,会触发第一个autogen,

因为第二个autogen 中也是单独按下了左边的option,

在按下左边的option之后还有按下其他键吗?没有,见上面的先按下space(hold住),再按下左边的option

源码:

<item>         <!-- 左边的Option/Alt,单独按下相当于 command+T,用于IDEA中通过接口路径搜索 ,          (if no other modifiers pressed) -->         <name>OPTION_L to PAGEUP</name>         <appendix>(OPTION_L Only, send PAGEUP)</appendix>         <identifier>private.option_l2pageup</identifier>         <autogen>             --KeyOverlaidModifier--             KeyCode::OPTION_L, ModifierFlag::OPTION_L | ModifierFlag::NONE,             KeyCode::OPTION_L,             KeyCode::T,ModifierFlag::COMMAND_L         </autogen>          <!--  同时按下space(实际已经映射成为COMMAND_R,见152行 )和option_left,触发OPTION_L+space,打开浏览器 -->         <autogen>             --KeyOverlaidModifier--             KeyCode::OPTION_L, ModifierFlag::OPTION_L |ModifierFlag::COMMAND_R | ModifierFlag::NONE,             KeyCode::OPTION_L,             KeyCode::SPACE,ModifierFlag::OPTION_L         </autogen>     </item>

参考:

https://github.com/tekezo/Karabiner/blob/version_10.22.0/src/core/server/Resources/include/checkbox/samples.xml

https://my.oschina.net/huangweiindex/blog/1649219