Sik.limited Logo

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. コンポーネントコードの確認

名前と説明だけをコピーせず、少なくとも次を確認します。

  1. 状態とイベント: 選択・開閉・エラーは何をきっかけに変わるか。値は親とコンポーネントのどちらが管理するか。
  2. アクセシブルな構造: 名前、役割、aria-*の関連付けは適切か。タブ、ダイアログ、メニューのキーボード操作があるか。
  3. スタイル依存: グローバルCSS、変数、フォント、アイコン、ラッパー要素が必要か。
  4. 製品のデータ規約: 送信データ、入力検証、読み込み、サーバーエラーの処理が既存ルールと一致するか。
  5. レスポンシブ表示と長い文言: 狭い画面、長いラベル、翻訳文、拡大文字でも使えるか。

AIには「この例をコピーして」ではなく、「プロジェクト内の類似パターンと依存を探し、対象フレームワークの例を比較し、既存の状態管理とアクセシビリティ規約に合わせて調整して」と依頼します。

5. デザイントークンとブランドへの適用

共通トークンを使うと、余白や色のような繰り返しの選択を管理しやすくなります。新しい16進カラーや余白値をハードコードする前に、プロジェクトのトークンを探し、その意味に合わせてコンポーネントへ割り当てます。

Quarkの例は共有のpreview.css、--q-*トークン、q-previewラッパーを前提にしています。他のプロジェクトで使う場合は共通スタイルを読み込むか、アプリのトークンに対応させます。例によってはアイコンパッケージをimportするため、実際の依存も確認してください。Quarkのテーマプレビューは共通トークンや一部のボタン動作に対応するアダプターで、すべてのブランドコンポーネントを公式実装に完全変換するものではありません。

トークンを対応させただけで、タイポグラフィ、文体、操作感までブランドに合うわけではありません。デザイナーが判断し、確認する必要があります。

6. 破壊的操作の確認ダイアログ

保存済みの支払い方法を削除する場面を考えます。ダイアログを出す前に、削除を取り消せるか、別の方法が必要か、完了後どこへ戻すかを確認します。取り消せない操作には確認ダイアログが適切かもしれません。復元できる下書きなら、取り消しトーストのほうが速く、操作を妨げにくい場合があります。

AIが生成したダイアログを適用する際は、タイトルが操作と対象を明示しているか、安全な操作に初期フォーカスがあるか、キャンセル・閉じる・Escapeの規則が明確か、確認ボタンが二重送信を防ぐか、サーバーエラー時に再試行できるか、完了後に予測可能な場所へフォーカスが戻るかを確認します。

サンプルは製品方針を決めてくれません。アプリのデータフローとユーザーの期待に合わせて調整する出発点です。

7. AIコーディングのプロンプト例

まずプロジェクトのフレームワーク、既存コンポーネント、トークン、フォーム、アクセシビリティ規約を調べてください。
要件: [ユーザーの目的とタスク]
必要な状態: [通常、読み込み中、空、エラー、成功など]
制約: [対応ブラウザー、画面幅、データ規約、依存関係]
候補コンポーネントの構造とキーボード操作を比較し、適切なものを選んでください。
既存規約に合わせて調整し、レスポンシブ表示、名前、フォーカス、エラー処理を確認してください。
使った例、新しい依存関係、確認できなかった点を報告してください。

UIコンポーネントのリリース前チェックリスト

  • コンポーネントは実際のユーザータスクに合っているか。
  • 入力やサーバー応答で想定される状態を扱っているか。
  • キーボードと支援技術で主要な操作を完了できるか。
  • プロジェクトのフレームワーク、スタイル、データ規約に沿っているか。
  • 狭い画面や長文、翻訳文でも動くか。
  • 依存関係と検証範囲を把握しているか。
  • 人が確認すべき製品方針と視覚表現が明確か。

コンポーネントライブラリは再利用可能な出発点を提供します。名前が一致するものを見つけただけでは選定は終わりません。表現する状態と、製品内での動作を確認して初めて適切な選択になります。

参考資料

最新の記事