Visual Studio Code 中的 HTML
Visual Studio Code 开箱即用,为 HTML 编程提供了基本支持。它具有语法高亮、IntelliSense 提供的智能补全以及可定制的格式化功能。VS Code 还包含了出色的 Emmet 支持。
IntelliSense
当您在 HTML 中输入时,我们通过 HTML IntelliSense 提供建议。在下图中,您可以看到一个建议的 HTML 元素闭合标签 </div>
,以及一个上下文相关的建议元素列表。
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.autoClosingTags": false
自动更新标签
修改标签时,链接编辑功能会自动更新匹配的闭合标签。此功能是可选的,可以通过设置启用
"editor.linkedEditing": true
颜色选择器
VS Code 颜色选择器 UI 现在在 HTML 样式部分可用。
它支持配置从编辑器中选择的颜色的色相、饱和度和不透明度。它还提供了通过单击选择器顶部的颜色字符串在不同颜色模式之间切换的能力。当您将鼠标悬停在颜色定义上时,选择器会显示出来。
悬停
将鼠标悬停在 HTML 标签或嵌入的样式和 JavaScript 上,以获取有关光标下符号的更多信息。
验证
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 aligned
和aligned multiple
时的对齐大小,或null
表示使用默认缩进大小。 - html.format.templating:尊重 django、erb、handlebars 和 php 模板语言标签。
- html.format.unformattedContentDelimiter:将文本内容保持在此字符串之间。
提示: 格式化程序不会格式化 html.format.unformatted 和 html.format.contentUnformatted 设置中列出的标签。除非排除 'script' 标签,否则嵌入的 JavaScript 将被格式化。
市场中有几种替代的格式化程序可供选择。如果您想使用不同的格式化程序,请在设置中定义 "html.format.enable": false
以关闭内置格式化程序。
Emmet 片段
VS Code 支持 Emmet 片段扩展。Emmet 缩写与编辑器自动补全列表中的其他建议和片段一起列出。
提示: 有关有效的缩写,请参阅 Emmet 速查表的 HTML 部分。
如果您想在其他语言中使用 HTML Emmet 缩写,可以通过 emmet.includeLanguages 设置将 Emmet 模式(例如 css
、html
)与其它语言关联。该设置接受一个语言标识符,并将其与 Emmet 支持模式的语言 ID 关联起来。
例如,要在 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。
提示:点击上面的扩展磁贴以阅读描述和评论,决定哪个扩展最适合您。请参阅市场中的更多内容。
后续步骤
继续阅读以了解:
- CSS、SCSS 和 Less - VS Code 对 CSS(包括 Less 和 SCSS)提供一流支持。
- Emmet - 了解 VS Code 强大的内置 Emmet 支持。
- Emmet 官方文档 - Emmet,Web 开发人员的必备工具包。
常见问题
VS Code 有 HTML 预览吗?
没有,VS Code 没有内置的 HTML 预览支持,但 VS Code 市场中提供了扩展。打开扩展视图(⇧⌘X (Windows, Linux Ctrl+Shift+X)),搜索“实时预览”或“html 预览”以查看可用的 HTML 预览扩展列表。