React UI パターン
基本原則
- 古いUIを決して表示しない - 実際にローディング中の場合のみスピナーを表示
- エラーは常に表示する - 何かが失敗したことをユーザーに知らせる
- 楽観的更新 - UIを瞬時に見せる
- プログレッシブディスクロージャ - コンテンツを利用可能になった時点で表示
- グレースフルデグラデーション - 部分的なデータでもデータがないよりはまし
ローディング状態パターン
黄金律
表示するデータがない場合にのみローディングインジケータを表示する。
// 正しい - データが存在しない場合のみローディングを表示
const { data, loading, error } = useGetItemsQuery();
if (error) return <ErrorState error={error} onRetry={refetch} />;
if (loading && !data) return <LoadingState />;
if (!data?.items.length) return <EmptyState />;
return <ItemList items={data.items} />;
// 間違い - キャッシュされたデータがあってもスピナーを表示(再フェッチ時にちらつく)
if (loading) return <LoadingState />; // 再フェッチでちらつく!
ローディング状態の決定木
エラーはあるか?
→ はい: 再試行オプション付きのエラー状態を表示
→ いいえ: 次へ
ローディング中かつデータがないか?
→ はい: ローディングインジケータ(スピナー/スケルトン)を表示
→ いいえ: 次へ
データはあるか?
→ はい、アイテムあり: データを表示
→ はい、ただし空: 空の状態を表示
→ いいえ: ローディングを表示(フォールバック)
スケルトン vs スピナー
| スケルトンを使用する場合 | スピナーを使用する場合 |
|---|---|
| 既知のコンテンツ形状 | 未知のコンテンツ形状 |
| リスト/カードレイアウト | モーダルアクション |
| 初期ページ読み込み | ボタン送信 |
| コンテンツプレースホルダー | インライン操作 |
エラーハンドリングパターン
エラーハンドリングの階層
1. インラインエラー(フィールドレベル)→ フォームバリデーションエラー
2. トースト通知 → 回復可能なエラー、ユーザーが再試行可能
3. エラーバナー → ページレベルエラー、データは部分的に使用可能
4. フルエラー画面 → 回復不可能、ユーザーの操作が必要
エラーは常に表示する
重要: エラーを黙って無視しないこと。
// 正しい - エラーは常にユーザーに表示される
const [createItem, { loading }] = useCreateItemMutation({
onCompleted: () => {
toast.success({ title: 'アイテムを作成しました' });
},
onError: (error) => {
console.error('createItem failed:', error);
toast.error({ title: 'アイテムの作成に失敗しました' });
},
});
// 間違い - エラーが黙ってキャッチされ、ユーザーは知ることができない
const [createItem] = useCreateItemMutation({
onError: (error) => {
console.error(error); // ユーザーには何も表示されない!
},
});
エラー状態コンポーネントパターン
interface ErrorStateProps {
error: Error;
onRetry?: () => void;
title?: string;
}
const ErrorState = ({ error, onRetry, title }: ErrorStateProps) => (
<div className="error-state">
<Icon name="exclamation-circle" />
<h3>{title ?? '問題が発生しました'}</h3>
<p>{error.message}</p>
{onRetry && (
<Button onClick={onRetry}>再試行</Button>
)}
</div>
);
ボタン状態パターン
ボタンのローディング状態
<Button
onClick={handleSubmit}
isLoading={isSubmitting}
disabled={!isValid || isSubmitting}
>
送信
</Button>
操作中は無効化
重要: 非同期操作中は常にトリガーを無効化する。
// 正しい - ローディング中はボタンが無効になる
<Button
disabled={isSubmitting}
isLoading={isSubmitting}
onClick={handleSubmit}
>
送信
</Button>
// 間違い - ユーザーが何度もタップできる
<Button onClick={handleSubmit}>
{isSubmitting ? '送信中...' : '送信'}
</Button>
空の状態
空の状態の要件
すべてのリスト/コレクションには空の状態を必須とする:
// 間違い - 空の状態がない
return <FlatList data={items} />;
// 正しい - 明示的な空の状態
return (
<FlatList
data={items}
ListEmptyComponent={<EmptyState />}
/>
);
コンテキストに応じた空の状態
// 結果がない検索
<EmptyState
icon="search"
title="結果が見つかりませんでした"
description="別の検索語を試してください"
/>
// まだアイテムがないリスト
<EmptyState
icon="plus-circle"
title="まだアイテムがありません"
description="最初のアイテムを作成しましょう"
action={{ label: 'アイテムを作成', onClick: handleCreate }}
/>
フォーム送信パターン
const MyForm = () => {
const [submit, { loading }] = useSubmitMutation({
onCompleted: handleSuccess,
onError: handleError,
});
const handleSubmit = async () => {
if (!isValid) {
toast.error({ title: 'エラーを修正してください' });
return;
}
await submit({ variables: { input: values } });
};
return (
<form>
<Input
value={values.name}
onChange={handleChange('name')}
error={touched.name ? errors.name : undefined}
/>
<Button
type="submit"
onClick={handleSubmit}
disabled={!isValid || loading}
isLoading={loading}
>
送信
</Button>
</form>
);
};
アンチパターン
ローディング状態
// 間違い - データが存在するときにスピナー(ちらつきの原因)
if (loading) return <Spinner />;
// 正しい - データがない場合のみローディングを表示
if (loading && !data) return <Spinner />;
エラーハンドリング
// 間違い - エラーを無視
try {
await mutation();
} catch (e) {
console.log(e); // ユーザーは知ることができない!
}
// 正しい - エラーを表示
onError: (error) => {
console.error('operation failed:', error);
toast.error({ title: '操作に失敗しました' });
}
ボタンの状態
// 間違い - 送信中でもボタンが無効化されない
<Button onClick={submit}>送信</Button>
// 正しい - 無効化され、ローディングを表示
<Button onClick={submit} disabled={loading} isLoading={loading}>
送信
</Button>
チェックリスト
UIコンポーネントを完了する前に:
UI状態:
- エラー状態が処理され、ユーザーに表示されている
- ローディング状態はデータがない場合のみ表示される
- コレクションに対して空の状態が提供されている
- 非同期操作中はボタンが無効化されている
- ボタンは適切な場合にローディングインジケータを表示する
データとミューテーション:
- ミューテーションにonErrorハンドラがある
- すべてのユーザーアクションにフィードバック(トースト/視覚)がある
他のスキルとの連携
- graphql-schema: 適切なエラーハンドリングを備えたミューテーションパターンを使用
- testing-patterns: すべてのUI状態(ローディング、エラー、空、成功)をテスト
- formik-patterns: フォーム送信パターンを適用