请求的译文尚未完成,当前显示原始繁体中文。
SKILL.md
只读
名称
how-to-use-react
描述
React 19.3のコンポーネント、ローダー、およびサーバー処理の記述、修正、レビュー時に参照する。ステートの配置場所、非同期処理の構成方法、並行UI APIの使用箇所、およびpropsの形式を決定する。
how-to-use-react
原文は masseater/typescript-template から作成されたリポジトリ向けに改変されている。原文と矛盾する箇所については、改変版が優先される。
- Effect AtomとTanStack Query間でステートを分割
- 非同期ウォーターフォールを排除
- React Compiler を使用するリポジトリでは、
useMemo、useCallback、memoを記述しないこと。 - 原文から Next.js、SWR、Redux、または
better-allを採用しないこと。
なぜこのスキルが必要なのか、および実現すべき状態
React では同一の画面を多様な方法で記述でき、どの方法も最初は動作するため、このスキルが必要となる。データが増加し、通信が遅くなり、操作が重複すると差異が現れるため、記述時点では誤った方法を選んだことに気づかない。
このスキルで実現すべき状態は、画面がブロックしたりユーザーを待たせたりせず、またどこにステートを配置すべきか迷うことがない状態である。
配置先
| やりたいこと | 使用するもの | 使用しないもの |
|---|---|---|
| 一時的な画面状態、フォーム値、ツリー全体で共有される値 | Effect Atom (Atom.make, useAtom, useAtomValue) |
useState, useReducer, createContext, useContext (msch の lint ルール msch-lint/ui-state-in-atoms が拒否) |
| サーバーデータ | TanStack Query (FSDの api セグメント内の queryOptions) |
use(promise) によるフェッチ、useEffect と fetch の組み合わせ、サーバーレスポンスをAtomに格納する |
| Mutation pending およびエラー | TanStack Query の useMutation |
自作の保留フラグ、useActionState、useFormStatus |
| 順序が仕様の一部であるミューテーション | 同一の scope.id を持つ useMutation |
自作のキュー、操作シーケンスを停止させるボタンの無効化 |
| 楽観的更新 | useOptimistic |
自作のロールバック状態 |
| 非緊急の更新および重い導出 | useTransition / startTransition / useDeferredValue |
タイマーのデバウンス |
| ref | 関数のプロップ | forwardRef、文字列参照 |
| 状態を非表示にしたまま保持すること | <Activity mode="hidden"> |
条件付きアンマウントで状態を破棄すること |
| トランジションアニメーション | <ViewTransition> |
|
| Effect で最新のプロップを使用すること | useEffectEvent |
その関数を依存配列に追加して再サブスクライブし、ハンドラを参照に格納すること |
メモ化
- React Compiler が有効なリポジトリでは、
useMemo、useCallback、memoを記述しないこと - Compiler が無効なリポジトリでは、
react-perfルールが指す箇所にのみuseCallbackまたはuseMemoを記述すること - それ以外の場合は、計測結果が遅いことが示された後にのみ追加すること
非同期ウォーターフォール
また、async も参照すること。React の他のパフォーマンストピックよりも先にこのセクションを適用すること。
Effect.allまたはEffect.forEachに{ concurrency: "unbounded" }を渡すことで、直前の結果を使用しない操作を同時に開始すること。- 順序が仕様の一部である場合は、
{ concurrency: 1 }と記述すること。省略しないこと。 - Effect 外の Promise には
Promise.allを使用すること。 - Promise が何らかの要素にのみ依存している場合は、依存側を
Effect.flatMapでビルドし、独立した側と共に一つのEffect.allに配置すること。
const loaded = Effect.all(
{
config: fetchConfig,
profile: fetchUser.pipe(Effect.flatMap((user) => fetchProfile(user.id))),
},
{ concurrency: "unbounded" },
);
元の要素の一部が採用されていない場合
| 元の | 代わりに |
|---|---|
Next.js (next/dynamic、after()、リクエストをまたいだ React の cache() の使用) |
TanStack Start のローダー |
| SWR | TanStack Query |
better-all |
Effect.all |
| Redux Action / Reducer / Selector | Effect Atom と TanStack Query、FSD の model / api / ui |
判断に迷う API シェイプについては、react.dev の関連リファレンスを参照すること。上記の表で使用しないよう指定されているフックがあるため、元のサンプルをコピーしないこと。
参考文献
以下もすべて読んでください。
effects-and-data。Effect で記述できる内容と、データが配置される場所design-theory。遷移と Suspense の設計に関する前提action-queue。インタラクションをブロックしないミューテーションdeferred-consistency。重いリストと入力を分離することconcurrent-ux.<Activity>,<ViewTransition>,useEffectEventcomponent-apis. The shape of propsnaming。名前とファイル






