🚀 在 VS Code 中

Visual Studio Code 中的 HTML

Visual Studio Code 提供了对 HTML 编程的基本开箱即用支持。它具有语法高亮、IntelliSense 智能补全和可自定义的格式化。VS Code 还包括出色的 Emmet 支持。

IntelliSense

当您在 HTML 中键入时,我们会通过 HTML IntelliSense 提供建议。在下图中,您可以看到建议的 HTML 元素闭合 </div> 以及上下文相关的建议元素列表。

HTML IntelliSense

文档符号也适用于 HTML,允许您通过 id 和类名快速导航到 DOM 节点。

您还可以使用嵌入的 CSS 和 JavaScript。但是,请注意,不会跟踪来自其他文件的脚本和样式包含,语言支持仅查看 HTML 文件的内容。

您可以随时按下 ⌃Space (Windows、Linux Ctrl+Space) 来触发建议。

您还可以控制哪些内置代码完成提供程序处于活动状态。如果您不想看到相应的建议,请在您的用户或工作区设置中覆盖这些设置。

// Configures if the built-in HTML language suggests HTML5 tags, properties and values.
"html.suggest.html5": true

关闭标签

当键入开始标记的 > 时,标记元素会自动关闭。

HTML Close1

当输入结束标记的 / 时,将插入匹配的结束标记。

HTML Close2

您可以使用以下设置关闭自动关闭标记

"html.autoClosingTags": false

自动更新标签

修改标记时,链接编辑功能会自动更新匹配的结束标记。此功能是可选的,可以通过设置启用

"editor.linkedEditing": true

颜色选择器

VS Code 颜色选择器 UI 现在在 HTML 样式部分可用。

color picker in HTML

它支持配置从编辑器中拾取的颜色的色调、饱和度和不透明度。它还提供了通过单击选择器顶部的颜色字符串在不同颜色模式之间触发的能力。选择器在您悬停在颜色定义上方时显示。

悬停

将鼠标移动到 HTML 标记或嵌入的样式和 JavaScript 上,以获取有关光标下符号的更多信息。

HTML Hover

验证

HTML 语言支持对所有嵌入的 JavaScript 和 CSS 执行验证。

您可以使用以下设置关闭该验证

// Configures if the built-in HTML language support validates embedded scripts.
"html.validate.scripts": true,

// Configures if the built-in HTML language support validates embedded styles.
"html.validate.styles": true

折叠

您可以使用行号和行开始之间装订线上的折叠图标来折叠源代码区域。折叠区域适用于源代码中多行注释的所有 HTML 元素。

此外,您可以使用以下区域标记来定义折叠区域:<!-- #region --><!-- #endregion -->

如果您喜欢切换到基于缩进的 HTML 折叠,请使用

"[html]": {
    "editor.foldingStrategy": "indentation"
},

格式化

为了改进 HTML 源代码的格式,您可以使用 格式化文档 命令 ⇧⌥F (Windows Shift+Alt+F,Linux Ctrl+Shift+I) 来格式化整个文件,或使用 格式化选定内容 ⌘K ⌘F (Windows、Linux Ctrl+K Ctrl+F) 仅格式化选定的文本。

HTML 格式化程序基于 js-beautify。该库提供的格式化选项在 VS Code 设置中公开。

  • html.format.wrapLineLength:每行的最大字符数。
  • html.format.unformatted:不应重新格式化的标记列表。
  • html.format.contentUnformatted:不应重新格式化内容的标记列表,以逗号分隔。
  • html.format.extraLiners:应在其前面添加额外换行符的标记列表。
  • html.format.preserveNewLines:是否应保留元素之前已存在的换行符。
  • html.format.maxPreserveNewLines:在一个块中要保留的最大换行符数。
  • html.format.indentInnerHtml:缩进 <head><body> 部分。
  • html.format.wrapAttributes:属性的换行策略
    • auto:当行长度超过时换行
    • force:包装所有属性,除了第一个
    • force-aligned:包装所有属性,除了第一个,并对齐属性
    • force-expand-multiline:包装所有属性
    • aligned-multiple:当行长度超过时换行,垂直对齐属性
    • preserve:保留属性的换行
    • preserve-aligned:保留属性的换行但对齐
  • html.format.wrapAttributesIndentSize:在 html.format.wrapAttributes 中使用 force alignedaligned multiple 时的对齐大小,或使用 null 以使用默认缩进大小。
  • html.format.templating:遵循 django、erb、handlebars 和 php 模板语言标记。
  • html.format.unformattedContentDelimiter:将此字符串之间的文本内容保持在一起。

提示: 格式化程序不会格式化 html.format.unformattedhtml.format.contentUnformatted 设置中列出的标记。除非排除 'script' 标记,否则将格式化嵌入的 JavaScript。

Marketplace 中有几种备用格式化程序可供选择。如果您想使用其他格式化程序,请在您的设置中定义 "html.format.enable": false 以关闭内置格式化程序。

Emmet 代码片段

VS Code 支持 Emmet 代码片段 扩展。Emmet 缩写与编辑器自动完成列表中的其他建议和代码片段一起列出。

Emmet HTML support built-in

提示: 有关有效的缩写,请参阅 Emmet 速查表 的 HTML 部分。

如果您想将 HTML Emmet 缩写与其他语言一起使用,您可以将 Emmet 模式之一(例如 csshtml)与 emmet.includeLanguages 设置 中的其他语言关联。

例如,要在 JavaScript 中使用 Emmet HTML 缩写

{
  "emmet.includeLanguages": {
    "javascript": "html"
  }
}

我们还支持用户定义的代码片段

HTML 自定义数据

您可以通过声明式 自定义数据格式 扩展 VS Code 的 HTML 支持。通过将 html.customData 设置为遵循自定义数据格式的 JSON 文件列表,您可以增强 VS Code 对新的 HTML 标记、属性和属性值的理解。然后,VS Code 将为提供的标记、属性和属性值提供语言支持,例如完成和悬停信息。

您可以在 vscode-custom-data 存储库中阅读有关使用自定义数据的更多信息。

HTML 扩展

安装扩展以添加更多功能。转到 扩展 视图 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 并键入 'html' 以查看相关扩展的列表,以帮助创建和编辑 HTML。

提示:单击上面的扩展磁贴以阅读描述和评论,以决定哪个扩展最适合您。在 Marketplace 中查看更多信息。

后续步骤

继续阅读以了解有关

  • CSS、SCSS 和 Less - VS Code 对 CSS(包括 Less 和 SCSS)具有一流的支持。
  • Emmet - 了解有关 VS Code 强大的内置 Emmet 支持。
  • Emmet 官方文档 - Emmet,Web 开发人员的必备工具包。

常见问题

VS Code 是否具有 HTML 预览?

不,VS Code 没有内置的 HTML 预览支持,但在 VS Code Marketplace 中有扩展可用。打开 扩展 视图 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 并搜索 'live preview' 或 'html preview' 以查看可用 HTML 预览扩展的列表。