AIコーディングでUIコンポーネントを選ぶ方法
状態やキーボード操作、対応フレームワークからコンポーネントを選びます。
AIに「モーダルを作って」と頼めば、画面はすぐに出てくるかもしれません。しかしEscapeキーで閉じるのか、フォーカスが中に保たれるのか、確認・キャンセル後にどの状態になるのかは、名前だけでは分かりません。コンポーネント選びは見た目を選ぶだけではなく、ユーザーのタスクと必要な状態を合わせることです。
ここでは、ライブラリの例を製品コードに適用する際に確認する項目を紹介します。Quarkのカタログで提供される実装範囲も説明します。
1. ユーザーのタスクとUIパターンの選択
「タブを追加する」で終わらせず、ユーザーの目的を説明します。たとえば「請求履歴と支払い方法を切り替えながら、同じ領域で内容を確認する」です。これにより、タブ、フィルター、別ページへのリンクのどれが適切か考えやすくなります。
- タブは同じ文脈内で関連するパネルを切り替えます。キーボード移動、選択状態、タブとパネルの関連付けが必要です。
- フィルターは一覧を絞り込んだり、並べ替えたりします。複数選択できるか、件数が変わるかを確認します。
- アコーディオンは補足情報を開閉します。複数項目を同時に開けるか、見出しが状態を伝えるかを決めます。
- モーダルやダイアログは作業を一時的に分けたり、入力を求めたりします。閉じる・キャンセル・送信後のフォーカスとデータ状態まで設計します。
見た目が似ていても、ユーザーの期待やキーボード操作は異なります。どれが適切か分からない場合は、実装を頼む前に候補を比較し、操作の違いを説明させましょう。
2. コンポーネントの状態と遷移
通常状態だけを説明しないでください。短い表にすると、デザイナー・開発者・AIの間で操作モデルを共有できます。
| 対象 | 開始状態 | ユーザー操作 | 期待する結果 |
|---|---|---|---|
| タブ | 1つ目が選択済み | 右矢印キーまたは別タブをクリック | 選択表示とパネルが一緒に切り替わる |
| 検索フィールド | 空欄 | 検索語を入力して消去 | 結果が更新され、消去すると全件に戻る |
| 日付選択 | 日付未選択 | 日付を選び、キャンセルする | 適用を押したときだけ値が確定する |
| ファイルアップロード | ファイルなし | 検証エラーが起きる | 理由と解決方法を伝える |
必要に応じて、読み込み中、検索結果なし、入力エラー、成功通知も追加します。非同期処理では、操作後の表示、二重送信の防止、失敗後に再試行できるかを明記します。
3. フレームワークとプロジェクト規約
ライブラリが対応フレームワークとして示していても、その例が製品に合うとは限りません。Reactのバージョン、スタイル方式、アイコンパッケージ、フォームの規約を先に確認し、既存コードに合わせて例を適用します。
リポジトリのコンポーネントフォルダを確認すると、Quarkには80個のコンポーネント定義があり、それぞれのメタデータでSvelte、React、Vue、Vanilla JSを対応フレームワークとして示し、各形式の例を用意しています。Vanillaの例はパッケージ化されたコンポーネントではなく、通常DOM要素を返すJavaScriptモジュールです。
このメタデータは、4つのフレームワークすべてに製品用パッケージがあることや、すべての例が同じ水準で検証済みであることを意味しません。一部の詳細仕様は、フレームワーク別に「まず既存のコンポーネントやUIライブラリを使い、独自実装が必要な場合にだけガイドを参照する」と案内しています。Quarkの公開カタログは現在64のコンポーネントグループを掲載しています。グループ、バリエーション、ソースフォルダはそれぞれ異なる数です。選んだ項目のソース、実装ガイド、プレビュー、依存関係を確認し、アプリ内で検証してください。
4. コンポーネントコードの確認
名前と説明だけをコピーせず、少なくとも次を確認します。
- 状態とイベント: 選択・開閉・エラーは何をきっかけに変わるか。値は親とコンポーネントのどちらが管理するか。
- アクセシブルな構造: 名前、役割、
aria-*の関連付けは適切か。タブ、ダイアログ、メニューのキーボード操作があるか。 - スタイル依存: グローバルCSS、変数、フォント、アイコン、ラッパー要素が必要か。
- 製品のデータ規約: 送信データ、入力検証、読み込み、サーバーエラーの処理が既存ルールと一致するか。
- レスポンシブ表示と長い文言: 狭い画面、長いラベル、翻訳文、拡大文字でも使えるか。
AIには「この例をコピーして」ではなく、「プロジェクト内の類似パターンと依存を探し、対象フレームワークの例を比較し、既存の状態管理とアクセシビリティ規約に合わせて調整して」と依頼します。
5. デザイントークンとブランドへの適用
共通トークンを使うと、余白や色のような繰り返しの選択を管理しやすくなります。新しい16進カラーや余白値をハードコードする前に、プロジェクトのトークンを探し、その意味に合わせてコンポーネントへ割り当てます。
Quarkの例は共有のpreview.css、--q-*トークン、q-previewラッパーを前提にしています。他のプロジェクトで使う場合は共通スタイルを読み込むか、アプリのトークンに対応させます。例によってはアイコンパッケージをimportするため、実際の依存も確認してください。Quarkのテーマプレビューは共通トークンや一部のボタン動作に対応するアダプターで、すべてのブランドコンポーネントを公式実装に完全変換するものではありません。
トークンを対応させただけで、タイポグラフィ、文体、操作感までブランドに合うわけではありません。デザイナーが判断し、確認する必要があります。
6. 破壊的操作の確認ダイアログ
保存済みの支払い方法を削除する場面を考えます。ダイアログを出す前に、削除を取り消せるか、別の方法が必要か、完了後どこへ戻すかを確認します。取り消せない操作には確認ダイアログが適切かもしれません。復元できる下書きなら、取り消しトーストのほうが速く、操作を妨げにくい場合があります。
AIが生成したダイアログを適用する際は、タイトルが操作と対象を明示しているか、安全な操作に初期フォーカスがあるか、キャンセル・閉じる・Escapeの規則が明確か、確認ボタンが二重送信を防ぐか、サーバーエラー時に再試行できるか、完了後に予測可能な場所へフォーカスが戻るかを確認します。
サンプルは製品方針を決めてくれません。アプリのデータフローとユーザーの期待に合わせて調整する出発点です。
7. AIコーディングのプロンプト例
まずプロジェクトのフレームワーク、既存コンポーネント、トークン、フォーム、アクセシビリティ規約を調べてください。
要件: [ユーザーの目的とタスク]
必要な状態: [通常、読み込み中、空、エラー、成功など]
制約: [対応ブラウザー、画面幅、データ規約、依存関係]
候補コンポーネントの構造とキーボード操作を比較し、適切なものを選んでください。
既存規約に合わせて調整し、レスポンシブ表示、名前、フォーカス、エラー処理を確認してください。
使った例、新しい依存関係、確認できなかった点を報告してください。
UIコンポーネントのリリース前チェックリスト
- コンポーネントは実際のユーザータスクに合っているか。
- 入力やサーバー応答で想定される状態を扱っているか。
- キーボードと支援技術で主要な操作を完了できるか。
- プロジェクトのフレームワーク、スタイル、データ規約に沿っているか。
- 狭い画面や長文、翻訳文でも動くか。
- 依存関係と検証範囲を把握しているか。
- 人が確認すべき製品方針と視覚表現が明確か。
コンポーネントライブラリは再利用可能な出発点を提供します。名前が一致するものを見つけただけでは選定は終わりません。表現する状態と、製品内での動作を確認して初めて適切な選択になります。