JS Custom

支持JSX, Flow等功能的自定义JavaScript语法高亮，适用于Sublime Text。您可以使用JS Custom作为 babel-sublime 的直接替代品，或创建具有所需功能的自定义语法。由于JS Custom基于JavaScript核心语法，它与大多数为原始语法编写的工具兼容 - 随着原始语法的更新和改进，JS Custom将继承这些改进。

安装

JS Custom可以通过 Package Control 安装。如果卸载JS Custom，它将删除任何编译的语法定义。

使用方法

要使用JS Custom，请指定一个或多个语法配置在JS Custom的首选项中。JS Custom将每个配置编译成一个语法定义。默认情况下，JS Custom提供了两个示例语法配置：“JS Custom - Default”和“JS Custom - React”。这些配置应在安装后自动编译并可使用。

JS Custom编译的所有语法都在您的用户软件包内部创建。它们位于“用户”下的“语法”菜单中，而不是“JS Custom”下。

配置

要自定义语法配置，请从菜单栏中选择偏好设置 → 软件包设置 → JS Custom → 设置。左侧将显示软件包默认设置，右侧显示您的用户设置。当您更改用户设置时，您的自定义语法将自动重新编译。（这可能需要几秒钟时间，特别是如果您有很多语法配置。）

在 食谱 中可以找到一些常用的示例语法配置。还可以查看 配置参考。

如果您在 Sublime Text 之外修改用户设置，此插件可能不会注意到您的修改。要手动重建所有自定义语法，请从菜单栏选择“首选项”→“包设置”→“JS 自定义”→“重建语法”，或在命令面板中选择“JS 自定义：重建语法”。

命令

JS 自定义提供了以下命令。除了“JSX 关闭标签”，它们都可在命令面板和“首选项”→“包设置”→“JS 自定义”下找到。

首选项：JS 自定义

在新窗口中同时打开默认的 JS 自定义首选项和您的 JS 自定义用户首选项。

JS 自定义：重建语法（《build_js_custom_syntaxes》）

重建您的所有自定义语法并删除任何过时的编译语法。

该命令接受可选的 versions 参数，接受配置名称列表。如果您传递了 versions，则仅会重建指定的配置。

JS 自自定义：清除用户数据（《clear_js_custom_user_data》）

删除 Packages/User/JS Custom 目录，包括所有编译语法。

JS 自定义：报告当前文件语法问题（《js_custom_report_syntax_issue》）

在浏览器中打开语法问题报告表单，大部分信息已预填充。

JSX 关闭标签（《jsx_close_tag》）

作为内置的 close_tag 命令，但应该适用于 JSX 标签。

此命令不在命令面板或 JS 自定义菜单中可用。默认情况下，每当您在 JavaScript 文件中运行 close_tag 命令时，则将运行 jsx_close_tag 命令。您可以使用 jsx_close_tag 设置来禁用此功能。

常见问题解答

我的语法在语法选择菜单中未出现。它们在哪里？

它们在语法选择菜单的“用户”下。它们被列在“JS 自自定义”下会更好，但在生成该菜单时，Sublime 只查看语法定义文件的物理位置，而 JS 自自定义将它们编译到 User/JS Custom/Syntaxes。

我已经从 Babel 包 切换过来，我的代码看起来不同。我如何恢复旧的外观？

babel-sublime 的当前版本是使用以下配置构建的，使用了 JS 自自定义

{
    "name": "JavaScript (Babel)",
    "scope": "source.js",
    "file_extensions": [ "js", "jsx", "es6", "babel" ],
    "flow_types": true,
    "jsx": true,
    "string_object_keys": true,
    "custom_templates": {
        "styled_components": true,
    }
}

贡献

要请求一个功能或报告一个错误，创建一个新的问题。所有建议都受欢迎。

在报告错误时，请包括一个演示问题的代码片段。如果该错误存在于 Sublime 的核心 JavaScript、JSX 或 TypeScript 语法中，应在此处报告此处 - 但如果您不确定，那么请先在此处发布。

在请求新的功能时，请提供相关文档的链接。由于 JS 自自定义的独特设计，我们能够适应各种非标准功能。