UX 指南
这些指南涵盖了创建与 VS Code 的原生界面和模式无缝集成的扩展的最佳实践。在这些指南中,你可以找到
- VS Code 总体 UI 架构和元素概述
- 扩展贡献的 UI 的建议和示例
- 相关指南和示例的链接
在深入细节之前,重要的是要理解 VS Code 的各种架构 UI 部分如何组合在一起,以及你的扩展可以在哪里贡献。
容器
VS Code 界面大致可以分为两个主要概念:容器和项目。一般来说,容器可以被认为是 VS Code 界面的较大 sections,用于渲染一个或多个项目
活动栏
活动栏是 VS Code 中的核心导航表面。扩展可以向活动栏贡献项目,这些项目充当视图容器,用于在主侧边栏中渲染视图。
主侧边栏
主侧边栏渲染一个或多个视图。活动栏和主侧边栏紧密耦合。点击贡献的活动栏项目(即:视图容器)会打开主侧边栏,其中将渲染与该视图容器关联的一个或多个视图。一个具体的示例是资源管理器。点击资源管理器项目将打开主侧边栏,其中文件夹、时间线和大纲视图可见。
次要侧边栏
次要侧边栏也充当渲染带有视图的视图容器的表面。用户可以将终端或问题视图等视图拖动到次要侧边栏,以自定义其布局。
编辑器
编辑器区域包含一个或多个编辑器组。扩展可以贡献自定义编辑器或Webviews以在编辑器区域中打开。它们还可以贡献编辑器操作,以在编辑器工具栏中公开其他图标按钮。
面板
面板是用于公开视图容器的另一个区域。默认情况下,终端、问题和输出等视图可以在面板中一次在一个选项卡中查看。用户还可以将视图拖动到拆分布局中,就像在编辑器中所做的那样。此外,扩展可以选择将视图容器专门添加到面板而不是活动栏/主侧边栏。
状态栏
状态栏提供有关工作区和当前活动文件的上下文信息。它渲染两组状态栏项目。
项目
扩展可以将项目添加到上面列出的各种容器。
视图
视图可以以树视图、欢迎视图或Webview 视图的形式贡献,并且可以拖动到界面的其他区域。
视图工具栏
扩展可以公开特定于视图的操作,这些操作在视图工具栏上显示为按钮。
侧边栏工具栏
作用域限定为整个视图容器的操作也可以在侧边栏工具栏中公开。
编辑器工具栏
扩展可以直接在编辑器工具栏中贡献作用域限定为编辑器的编辑器操作。
面板工具栏
面板工具栏可以公开作用域限定为当前选定视图的选项。例如,终端视图公开了用于添加新终端、拆分视图布局等的操作。切换到“问题”视图会公开一组不同的操作。
状态栏项目
在左侧,状态栏项目的作用域限定为整个工作区。在右侧,项目的作用域限定为活动文件。
常用 UI 元素
命令面板
扩展可以贡献出现在命令面板中的命令,以快速执行某些功能。
快速选择
快速选择以几种不同的方式捕获用户的输入。它们可以要求单项选择、多项选择,甚至自由格式文本输入。
通知
通知用于向用户传达信息、警告和错误消息。它们也可以用于指示进度。
Webviews
Webviews 可用于显示自定义内容和功能,以用于超出 VS Code “原生” API 的用例。
上下文菜单
与命令面板的固定位置相反,上下文菜单让用户能够从特定位置执行操作或配置某些内容。
演练
演练通过包含丰富内容的多步骤清单,为用户提供一致的扩展入门体验。
设置
设置使用户能够配置与扩展相关的选项。