在 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