🎉🎉 发布新插件“JavaScript Enhancements”🎉🎉

利用Facebook的<强>Flow（Facebook的JavaScript静态类型检查器），

现在此新插件支持的操作系统

JavaScript Completions

Sublime Text的JavaScript Completions

通过提示和补全来加速您编写脚本。

<强>jQuery和<强>NativeScript补全默认禁用！您可以在首选项 -> 插件设置 -> JavaScript Completions中启用它们。

某些功能可能需要npm！

它将自动使用nodejs下载！

功能列表：- “查找JavaScript描述”功能 - “悬停描述”功能 - “评估JavaScript”功能 - “我能用吗？”功能 - “JSDoc”功能 - 上下文菜单选项

用法

要尝试它，只需写下。

示例

<代码>description-Name_of_function/property/method将向您显示函数/属性/方法的解释及其语法。

功能/属性/方法描述的信息已从以下网站获取

• http://html5index.org/index.html
• https://html.whatwg.com.cn/
• http://www.ecma-international.org/ecma-262/5.1/
• https://www.w3.org
• https://api.jqueryjs.cn/
• https://docs.nativescript.cn/api-reference/globals.html

启用或禁用补全

您可以使用首选项 -> 插件设置 -> JavaScript Completions来启用或禁用补全。

“查找JavaScript描述”功能

仅由Sublime Text 3支持

您可以通过选择您想要查找的单词（或，如果在闪烁光标附近，它将选择第一个单词）并同时点击鼠标右键，然后选择“查找JavaScript描述”来检查函数/属性/方法的描述。

它将显示一个包含可能描述列表的弹出窗口，或者在某些情况下，直接显示描述。

键映射列表：首选项 -> 软件包设置 -> JavaScript 完整性 -> 键绑定 - 默认。

“悬停描述”功能

仅支持 Sublime Text 3，版本 >= 3124

只需将光标放在一个函数、属性或构造函数的名称上，就会显示一个包含从已启用 /sublime-completions 列表中匹配的所有项目的弹出窗口。

• F = 函数
• P = 属性
• C = 构造函数

示例

“评估 JavaScript”功能

仅由Sublime Text 3支持

此功能使用由此插件在本地上安装的 node.js。

您可以在首选项 -> 软件包设置 -> JavaScript 完整性 -> 设置 - 默认中更改“node.js”和“npm”的路径。

您可以直接评估整个文本选择或当前行！如果您选择一个文本区域并评估它，编辑器的空白边缘将出现 2 个白色圆点。第一个白色圆点表示区域的开始，第二个白色圆点表示区域的结束。您可以最终修改区域，而无需重新选择同一区域即可再次评估它！如果您想隐藏这两个点，可以在“评估 JavaScript”的上下文菜单中找到一个条目。

当您评估代码时，此插件将自动添加 "use strict";！

评估代码有两种主要模式：- eval - print

键映射列表：首选项 -> 软件包设置 -> JavaScript 完整性 -> 键绑定 - 默认。

“Can I use？”功能

仅支持 Sublime Text 3，版本 >= 3124

此功能使用来自此 仓库 的“can i use”json数据，其中包含来自 https://caniuse.cn 支持表的原始数据。

感谢 @Fyrd。

您可以在 HTML、CSS 和 JavaScript 上下文中使用此功能！

只需将光标放在您要检查的单词上，右键单击 -> "Can I use?"，就会显示一个包含与单词匹配的所有项目的输入面板。

您可以使用键映射：ctrl+alt+w（在 Windows 上为 super+alt+w）。键映射列表：首选项 -> 软件包设置 -> JavaScript 完整性 -> 键绑定 - 默认。

从列表中选/item之后，将显示一个包含 https://caniuse.cn 支持表中所有信息的弹出窗口。

您可以在 "工具" 菜单 -> "JavaScript 完整性" -> 在 "Can I use" 列表中搜索 下找到它。

示例

“JSDoc”功能

仅由Sublime Text 3支持

需要 npm

此功能使用https://github.com/jsdoc3/jsdoc生成API文档。

您可以在 "工具" 菜单 -> "JavaScript 完整性" 下面找到它。

有两个主要菜单项：- 生成文档 - 向当前项目文件夹添加 jsdoc 配置文件

这些项目只能在打开项目文件夹的情况下使用。

"生成文档" 使用 jsdoc 命令行生成文档。

它使用默认的 conf.json 文件进行配置。

可用的选项（带有默认值）是

{
  "tags": {
    "allowUnknownTags": true,
    "dictionaries": ["jsdoc","closure"]
  },
  "source": {
    "include": [  ],
    "exclude": [  ],
    "includePattern": ".+\\.js(doc|x)?$",
    "excludePattern": "(^|\\/|\\\\)_"
  },
  "opts": {
    "template": "templates/default",
    "encoding": "utf8",
    "destination": "./out/",
    "recurse": true,
    "tutorials": ""
  },
  "plugins": [],
  "templates": {
    "cleverLinks": false,
    "monospaceLinks": false
  }
}

"向当前项目文件夹添加 jsdoc 配置文件" 将带有默认值的 conf.json 文件添加到当前项目文件夹。

如何使用 JSDoc: http://usejsdoc.org/

上下文菜单选项

上下文菜单选项：- 包围 - 删除包围 - 从对象字面值创建类 - 排序数组 - 将字符串行拆分为变量

包围

您必须首先选择文本以“启用”这些选项。

您可以用以下方式包围代码：- if语句 - if else语句（仅当您选择了2个区域时才有效，见示例）- while语句 - do while语句 - for语句 - try catch语句 - try catch finally语句

此选项也可以一次选取多个项使用。

删除包围

选项包括：- 移除带引号的字符串

此选项也可以一次选取多个项使用。

从对象字面量创建类

此选项可以从对象字面量创建JavaScript类（包含每个字段的setter和getter构造函数）。

您可以为默认值或使用字符串"required"来指定某字段没有默认值。

要正常工作，您必须声明一个变量并分配一个对象字面量给它，如下所示示例

var Person = {
  name: "required",
  surname: "required",
  email: "",
  age: 18
}

此选项也可以一次选取多个项使用。

排序数组

只需将光标放在括号之间，就会出现这些选项的菜单：- 升序排序数组（比较函数：function(x,y){return x-y;}）- 降序排序数组（比较函数：function(x,y){return y-x;}）- 按字母顺序升序排序数组 - 按字母顺序降序排序数组

此选项也可以一次选取多个项使用。

用法示例

将字符串行分割到变量中

只需将光标放在多行字符串中，此选项就会在上下文中出现。

它将拆分字符串，并将每一行连接到名为“str”的变量中。

此选项也可以一次选取多个项使用。

示例

MIT许可证