🚀 在 VS Code 中

侧边栏

主侧边栏和辅助侧边栏由一个或多个 视图 组成,这些视图由 视图容器 贡献。扩展可以将视图贡献到现有的视图容器(例如,资源管理器),或者他们可以贡献一个全新的视图容器。

✔️ 建议

  • 将相关的视图和内容组合在一起
  • 为视图容器及其视图使用清晰、描述性的名称

❌ 不建议

  • 使用过多的视图容器。对于大多数扩展,一个单独的视图容器(例如,带有该扩展特有视图的侧边栏)通常就足够了。
  • 使用过多的视图(对于大多数屏幕尺寸,3-5 个是一个舒适的最大值)
  • 向侧边栏添加可以是一个简单命令的内容。
  • 重复现有功能

Example of two sidebars

主侧边栏

许多扩展选择向主侧边栏贡献视图和/或视图容器,因为它为内容提供了很高的可见性。在此处添加内容时请谨慎判断——过多的贡献 UI 可能会导致体验杂乱,从而使您的用户感到困惑。

Example of the primary sidebar

辅助侧边栏

顾名思义,辅助侧边栏通常被认为是视图的辅助位置。虽然默认情况下扩展无法直接向其贡献视图,但用户可以将视图从主侧边栏或面板拖动到此处以自定义其布局。

Example of the secondary sidebar

默认情况下,侧边栏中具有多个视图的视图容器将在侧边栏工具栏中显示一个 ... 图标按钮,以显示和隐藏每个视图。 看起来像这样

Sidebar with two views

但是,如果仅使用一个视图,则侧边栏将自动合并 UI,以使用侧边栏工具栏来呈现特定于该视图的所有操作。在 ... 按钮的位置,与“Notes”视图关联的两个操作将呈现在其位置

Sidebar with a single view and toolbar with actions

与其他工具栏一样,请注意不要添加过多的操作,以减少混乱和困惑。如果可能,请使用与描述性命令名称配对的现有产品图标。