VS Codeのエージェントモードを拡張するには、を試してください!

クイックピック

クイックピックは、アクションを実行し、ユーザーから入力を受け取る簡単な方法です。これは、構成オプションの選択、コンテンツのフィルタリング、またはアイテムのリストからの選択が必要な場合に役立ちます。

Quick Pick example

✔️ すべきこと

  • 明確なメタファーのためにアイコンを使用する
  • 明確さを加え、アイテムの区別に役立つ、考え抜かれたアイコンを使用する
  • 現在のアイテムを表示するために説明を使用する(該当する場合)
  • 追加のコンテキスト(簡潔なもの)を提供するために詳細を使用する
  • 一連の基本的な入力にはマルチステップパターンを使用する
  • リストから選択する際に新しいアイテムを作成するオプションを提供する(該当する場合)
  • マルチステップクイックピックにはタイトルを使用する
  • テキスト入力なしのクイックピックにはタイトルを使用する
  • テキスト入力を求めるクイックピックにはタイトルを使用する(ヒントや例を示すにはプレースホルダーを使用する)
  • グローバルボタン(例:更新アイコン)を特徴とするクイックピックにはタイトルを使用する

❌ すべきでないこと

  • 既存の機能を繰り返さない
  • プレースホルダー自体が目的を説明できる場合はタイトルを使用する
  • プレースホルダーなしの入力を使用する

複数ステップ

クイックピックは、複数ステップを特徴とするように構成できます。これらは、関連するが別個の選択を単一のフローで取得する必要がある場合に使用します。多くのステップがある長いフローにクイックピックを使用することは避けてください。ウィザードや同様に複雑なエクスペリエンスとして機能するのに適していません。

Multi-step Quick Pick example

クイックピックのタイトルにある「1/3」のテキストは、フローにおける現在のステップ数と合計ステップ数を示しています。

複数選択

密接に関連する選択肢を1つのステップで選択する必要がある場合は、複数選択クイックピックを使用してください。

Multi-step Quick Pick example

タイトル

クイックピックは、メインの入力および選択UIの上にタイトルバーを表示するように構成することもできます。ユーザーが選択を行うためにより多くのコンテキストを必要とする場合は、タイトルを使用してください。クイックピックの入力プレースホルダーですでに使用されているラベルを使用するタイトルは避けてください。

Multi-step Quick Pick example

区切り文字の使用

クイックピックのアイテムは、クイックピック区切り文字を使用して明確なセクションにグループ化できます。これらは、セクションを明確に示す区切り線とラベルを特徴とします。拡張機能が複数の明白な選択グループを含むクイックピックを特徴とする場合は、区切り文字を使用してください。

Quick Pick with separators