现已发布!阅读有关 11 月份的新功能和修复的信息。

Webviews

如果需要显示 VS Code API 不支持的自定义功能,可以使用完全可自定义的 Webview。重要的是要理解,只有在绝对需要的情况下才应该使用 Webview。

✔️ 应该做

  • 仅在绝对必要时使用 Webview
  • 仅在上下文合适时激活扩展
  • 仅为活动窗口打开 Webview
  • 确保视图中的所有元素都是可主题化的(请参阅 webview-view-sample颜色令牌 文档)
  • 确保你的视图遵循 可访问性指南 (颜色对比度、ARIA 标签、键盘导航)
  • 在工具栏和视图中使用命令操作

❌ 不应该做

  • 不要用于促销(升级、赞助等)
  • 不要用于向导
  • 不要在每个窗口上打开
  • 不要在扩展更新时打开(而是通过通知询问)
  • 不要添加与编辑器或工作区无关的功能
  • 不要重复现有功能(欢迎页面、设置、配置等)

Webview 示例

简单浏览器

此扩展在编辑器旁边打开一个浏览器预览。

Weview sample - Browser

此示例展示了在 VS Code 内部开发的 VS Code Web。Webview 面板用于渲染类似浏览器的窗口。

拉取请求

此扩展在自定义树视图中显示工作区存储库的拉取请求,然后使用 Webview 显示拉取请求的详细视图。

Webview sample - Pull Request

Webview 视图

你还可以将 Webview 放入任何视图容器(侧边栏或面板)中,这些元素称为 Webview 视图。相同的 Webview 指南适用于 Webview 视图。

Webview View

此 Webview 视图显示用于创建使用下拉列表、输入框和按钮的拉取请求的内容。