跳至内容

鼠标绑定

鼠标映射文件(扩展名为 .sublime-mousemap)控制用户使用鼠标执行操作时执行的命令,例如单击鼠标按钮、滚动滚轮等。

文件格式

鼠标映射文件是 JSON 文件,遵循键绑定的命名方案。

以下是 Default/Default (Windows).sublime-mousemap 中的一小段摘录

json
[
    // Basic drag select
    {
        "button": "button1", "count": 1,
        "press_command": "drag_select"
    },
    {
        "button": "button1", "count": 1, "modifiers": ["ctrl"],
        "press_command": "drag_select",
        "press_args": {"additive": true}
    },
    {
        "button": "button1", "count": 1, "modifiers": ["alt"],
        "press_command": "drag_select",
        "press_args": {"subtractive": true}
    },
]

以下是鼠标映射文件中单个 JSON 条目可以接受的键。

button : 按钮名称。

这定义了按钮的名称。最多可以有 16 个按钮,从 button1button16,以及用于滚轮的 scroll_upscroll_down

modifiers : 修饰键列表。

这定义了必须同时按下(以及相应的按钮点击)才能触发命令的修饰键列表,例如 ["ctrl", "alt"]。可以在键绑定部分的 修饰键 中找到所有修饰键的列表。

count : 按钮按下的次数。

这定义了必须按下按钮的次数才能触发相应的 command。默认为 1

command : 要执行的 command

这定义了在释放相应按钮时要执行的命令。

args : command 的参数。

这是要传递给 command 的参数映射。

press_command : 要执行的 press_command

这定义了在按下相应按钮时要执行的命令。

press_args : press_command 的参数。

这是要传递给 press_command 的参数映射。