菜单

另请参阅

菜单文档 : 解释菜单的工作原理以及您可以使用它们做什么。

文件格式

格式	描述
格式	JSON（带注释）
扩展名	.sublime-menu
名称	可用菜单列表中的一个。有关完整名称列表及其代表的菜单，请参阅 可用菜单。
位置	任何位于 Packages 下的目录
内容	一个 菜单项 对象 列表

示例

以下是默认 Main.sublime-menu 文件的摘录。

[
    {
        "caption": "Edit",
        "mnemonic": "E",
        "id": "edit",
        "children":
        [
            { "command": "undo", "mnemonic": "U" },
            { "command": "redo_or_repeat", "mnemonic": "R" },
            {
                "caption": "Undo Selection",
                "children":
                [
                    { "command": "soft_undo" },
                    { "command": "soft_redo" }
                ]
            },
            { "caption": "-", "id": "clipboard" },
            { "command": "copy", "mnemonic": "C" },
            { "command": "cut", "mnemonic": "t" },
            { "command": "paste", "mnemonic": "P" },
            { "command": "paste_and_indent", "mnemonic": "I" },
            { "command": "paste_from_history", "caption": "Paste from History" }
        ]
    }
]

菜单项 对象

菜单项 可能具有以下属性。

除非您通过 ID 引用现有项，否则每个菜单项必须定义 children、command 或 caption。

command : 选择菜单项时要调用的命令的名称。

args : 命令的参数对象。对于 **侧边栏** 和 **侧边栏挂载点** 菜单，它通过包含侧边栏中所有选定项的 files 参数扩展，该参数以列表形式表示。

caption : 要在菜单中显示的文本。单个连字符 (-) 将该项转换为 菜单分隔符。

children : 当悬停在该项上时显示的 菜单项 对象 列表。覆盖 command 属性的存在。

mnemonic : 用于菜单加速键的单个字符。该字符必须包含在标题中，区分大小写。

id : 菜单项的唯一字符串标识符。这可用于扩展菜单部分或子菜单，或完全更改菜单项。

有关其工作原理，请参阅 主文档。

platform : 应使菜单条目可见的平台名称。有效值为 OSX、Linux 和 Windows。它还支持否定形式 !OSX，这意味着对除 OSX 之外的所有平台显示菜单条目。