🚀 在 VS Code 中

快速选择

快速选择是执行操作和接收用户输入的简便方法。这在选择配置选项、需要筛选内容或从项目列表中选择时非常有用。

Quick Pick example

✔️ 这样做

  • 使用图标以实现清晰的隐喻
  • 使用周到的图标,以增加清晰度并帮助区分项目
  • 使用描述来显示当前项目(如果适用)
  • 使用详情来提供(简要的)附加上下文
  • 对于一系列基本输入,使用多步骤模式
  • 在从列表中选择时,提供创建新项目的选项(如果适用)
  • 对于多步骤快速选择,使用标题
  • 对于没有文本输入的快速选择,使用标题
  • 对于请求文本输入的快速选择,使用标题(使用占位符显示提示或示例)
  • 对于具有全局按钮(例如,刷新图标)的快速选择,使用标题

❌ 不要这样做

  • 重复现有功能
  • 当占位符可以自行描述目的时,请勿使用标题
  • 不要使用没有占位符的输入

多步骤

快速选择可以配置为具有多个步骤。当您需要在单个流程中捕获相关但独立的选项时,请使用这些。避免将快速选择用于具有许多步骤的长流程——它们不适合用作向导或类似的复杂体验。

Multi-step Quick Pick example

注意快速选择标题中的“1/3”文本,它指示流程中当前步骤和总步骤数。

多项选择

对于需要在一步中选择的密切相关的选项,请使用多选快速选择。

Multi-step Quick Pick example

标题

快速选择也可以配置为在主输入和选择 UI 上方显示标题栏。当用户需要更多关于正在进行的选择的上下文时,请使用标题。避免使用已在快速选择的输入占位符中使用的标签作为标题。

Multi-step Quick Pick example

使用分隔符

可以使用快速选择分隔符将快速选择项目分组到清晰的部分中。这些分隔符具有分隔线和标签,以清晰地显示部分。如果扩展的快速选择包含多个明显的选择组,请使用分隔符。

Quick Pick with separators