React + TypeScript: React公式ドキュメントの基本解説「Learn React」を学ぶ

React公式ドキュメントサイト[**react.dev**](https://react.dev/)が2023年3月16日に改訂されました(Blog「[Introducing react.dev](https://react.dev/blog/2023/03/16/introducing-react-dev)」参照)。基本解説の「[Learn React](https://react.dev/learn)」には、初心者から読み進められる丁寧な説明から中級者にも役立つ詳しい情報まで、内容は満載です。

それらの記事をTypeScriptの備わった環境で解説し直し、Qiitaに投稿してきました。数がある程度増えたので、拙著Qiita記事と公式サイトの対応リンクをまとめ、簡単な紹介を添えたのが本稿です。各解説は基本的に公式記事の情報はカバーしているものの、邦訳ではありません。足りない部分は補ったり、説明の仕方を改めたり、不要と思われる記述は削除しました。また、TypeScriptを前提に加えたので、JavaScriptの基礎的な説明は省いています。

なお、コード例の一部はCodeSandboxに公開しているので、興味があれば実際にお試しください。

[更新2023/08/16]「カスタムフックでロジックを再利用する」を追加。

## Describing the UI

### [ユーザーインタフェースを組み立てる](https://qiita.com/FumioNonaka/items/2ba530a906bf97480f80)
* [Describing the UI](https://react.dev/learn/describing-the-ui)

主題はReactのコンポーネントと戻り値JSXの書き方です。Reactアプリケーションはコンポーネントを組み合わせて、JSXでページを描画します。

## Adding Interactivity

### [発生したイベントを処理する](https://qiita.com/FumioNonaka/items/3414af535faf2c924786)
* [Responding to Events](https://react.dev/learn/responding-to-events)

解説するのは、つぎのような項目です。

* イベントハンドラをどう定め方るか。
* イベント処理のロジックを親コンポーネントから子にどのように渡すか。
* イベントの制御の仕方。

Reactのイベントハンドラは、JSXにプロパティとして加え、ハンドラ(コールバック)関数を与えます。要素へのマウスクリックやポインタの重なり、フォーム入力のフォーカスといったインタラクションなどに反応して呼び出される関数です。

### [コンポーネントの状態を保持する](https://qiita.com/FumioNonaka/items/0961f93d9dcefca7f4dc)
* [State: A Component's Memory](https://react.dev/learn/state-a-components-memory)

コンポーネントに対するインタラクションに応じて、画面の中身を改めなければならないことがあるでしょう。たとえば、つぎのような場合です。

* フォームに入力したときテキストフィールドの更新。
* カルーセルで[つぎへ]のボタンをクリックしたときの画像の切り替え。
* 商品の[購入]ボタンクリックによるショッピングカートへの追加。

コンポーネントは、こうした変更の現行値を覚えておかなければなりません。Reactでは、コンポーネントごとに値をメモリする仕組みは状態(state)と呼ばれます。

### [レンダーとコミット](https://qiita.com/FumioNonaka/items/e7e285c1bae049706a58)
* [Render and Commit](https://react.dev/learn/render-and-commit)

コンポーネントは画面に表示される前に、Reactがレンダリングしなければなりません。コンポーネントがレストランの料理人だとしましょう。すると、Reactは受けた注文にもとづき、客に料理を運ぶウェイターの役割です。

1. **レンダーを起動**: 客の注文を厨房に届けます。
2. **コンポーネントをレンダリング**: 厨房で料理をつくりあげる仕事です。
3. **DOMにコミット**: 料理を客のテーブルに運びます。

### [スナップショットとしての状態](https://qiita.com/FumioNonaka/items/de813331817014bac2e6)
* [State as a Snapshot](https://react.dev/learn/state-as-a-snapshot)

状態変数は、標準JavaScriptの変数のように、値が読み書きできると思えるかもしれません。けれど、状態のふるまいは「スナップショット」(筆者注: そのときどきの情報の記録)に近いです。状態の設定はすでに定められた値の変更ではありません。再レンダーの起動です。

### [連続した状態変更をキューに加えて処理する](https://qiita.com/FumioNonaka/items/73cb59fb3cabce4106da)
* [Queueing a Series of State Updates](https://beta.reactjs.org/learn/queueing-a-series-of-state-updates)

状態変数を設定すると、レンダリングはキューに入ります。けれど、つぎのレンダリングがキューに加えられる前に、変数値に複数の操作を行いたい場合もあるでしょう。そのためには、Reactが状態の更新をどうバッチ処理するのかを理解しておくと役立ちます。

### [状態に収めたオブジェクトを更新する](https://qiita.com/FumioNonaka/items/d270e27a06db65609dcf)
* [Updating Objects in State](https://react.dev/learn/updating-objects-in-statehttps://react.dev/learn/updating-objects-in-state)

Reactの状態に保持できるのは、オブジェクトを含めたすべてのJavaScriptの値です。ただし、状態に持たせたオブジェクトを直接変更してはいけません。更新したいときは、まず新たなオブジェクト(またはもとオブジェクトの複製)をつくって編集してください。そのうえで、状態はそのオブジェクトを用いて設定するのです。

### [状態に収めた配列を更新する](https://qiita.com/FumioNonaka/items/1195364ce6518be8a9be)
* [Updating Arrays in State](https://react.dev/learn/updating-arrays-in-state)

配列はJavaScriptではミュータブルです。けれど、Reactで状態に収める場合は、イミュータブルとして扱ってください。配列もオブジェクトです。したがって、状態に入れた配列の更新には、まず新たな配列(またはもと配列の複製)をつくります。そのうえで、編集を加えて状態に設定するのです。


## Managing State

### [入力を状態に反応させる](https://qiita.com/FumioNonaka/items/66bb10b77ee99eda6a15)
* [Reacting to Input with State](https://react.dev/learn/reacting-to-input-with-state)

Reactが用いるUIの操作方法は宣言的です。それぞれのUI部分は直接いじりません。コンポーネントが取り得るさまざまな状態を記述し、ユーザー入力に応じて切り替えるのです。デザイナーがUIを考えるのと似ているかもしれません。

### [状態の構造を選択する](https://qiita.com/FumioNonaka/items/5a177bb1cbb22fb4b7b1)
* [Choosing the State Structure](https://qiita.com/FumioNonaka/items/5a177bb1cbb22fb4b7b1)

コンポーネントの変更やデバッグがしやすいか、逆にバグに悩まされるかという差につながるのが、状態を適切に構造化するかどうかです。状態を構造化するときに考えるべき点についてご紹介します。

### [コンポーネント間で状態を共有する](https://qiita.com/FumioNonaka/items/611bd5e0cd254c0e9ea0)
* [Sharing State Between Components](https://react.dev/learn/sharing-state-between-components)

ふたつのコンポーネントの状態を、つねに一緒に変化させたい場合があるでしょう。そのためには、状態をそれぞれのコンポーネントにもたせるのでなく、もっとも近い共通の親に移すべきです。そのうえで、親から子には値をプロパティで渡します。これは状態の引き上げ(リフトアップ)と呼ばれ、Reactのコードでよく用いられるやり方です。

### [状態の保持とリセット](https://qiita.com/FumioNonaka/items/6f51af73b4b9b0bbaeab)
* [Preserving and Resetting State](https://react.dev/learn/preserving-and-resetting-state)

状態はコンポーネントごとに別々です。Reactはどの状態がどのコンポーネントに属するか、UIツリー内の位置にもとづいて把握します。そして、再レンダリング間で、状態をいつ保持し、いつリセットするかは制御できるのです。

### [状態のロジックをリデューサに切り出す](https://qiita.com/FumioNonaka/items/6e7541567b38727d4f6c)
* [Extracting State Logic into a Reducer](https://react.dev/learn/extracting-state-logic-into-a-reducer)

様々な状態更新をもつコンポーネントが多くのイベントハンドラにまたがると、手に負えなくなりそうです。こういう場合、すべての状態更新のロジックをコンポーネントから切り出して、ひとつの関数にまとめることが考えられます。これがリデューサです。

### [コンテクストでデータを深い階層に渡す](https://qiita.com/FumioNonaka/items/babd1168d259416872ed)
* [Passing Data Deeply with Context](https://react.dev/learn/passing-data-deeply-with-context)

通常、親コンポーネントから子には、プロパティで情報を渡します。けれど、プロパティを用いることが、冗長で不便になるのがつぎのような場合です。

* 間に多くのコンポーネントを経て渡すことになってしまう(いわゆる「バケツリレー」)。
* アプリケーション内の多くのコンポーネントが同じ情報を必要としている。

コンテクストを使えば、親コンポーネントの情報が、ツリーの下層のどのコンポーネントからでも参照できるようになります。ツリーの深さは問わず、プロパティを介する必要もありません。

### [リデューサとコンテクストで拡張性を高める](https://qiita.com/FumioNonaka/items/efc7db380a120f99d4bb)
* [Scaling Up with Reducer and Context](https://react.dev/learn/scaling-up-with-reducer-and-context)

コンポーネントの状態更新のロジックを統合するのがリデューサです。また、コンテクストを用いれば、情報を階層深くの他のコンポーネントに渡せます。このふたつを組み合わせることにより、複雑な画面の状態も管理しやすくなるでしょう。


## Escape Hatches

### [refで値を参照する](https://qiita.com/FumioNonaka/items/6960b28c1514049b4419)
* [Referencing Values with Refs](https://react.dev/learn/referencing-values-with-refs)

コンポーネントに何か情報を「記憶」させつつ、その情報による新たなレンダーは引き起こしたくないとき使えるのが`ref`です。

### [refでDOMを操作する](https://qiita.com/FumioNonaka/items/8d53d7b516d47f4837e8)
* [Manipulating the DOM with Refs](https://react.dev/learn/manipulating-the-dom-with-refs)

ReactがDOMを更新してレンダリング出力に合わせる処理は自動的です。そのため、コンポーネントがDOMを操作しなければならないことはあまりありません。けれど、DOMを参照してReactに操作させたい場合も出てくるでしょう。たとえば、つぎのようなときです。

* ノードにフォーカスしたい。
* ノードをスクロールさせたい。
* ノードのサイズや位置を調べたい。

もっとも、Reactにはそのような組み込みの仕組みはありません。そこで、refによりDOMノードを参照するのです。

### [React + TypeScript: エフェクトを使って同期する](https://qiita.com/FumioNonaka/items/e1581148d81aa3a5fa6c)
* [Synchronizing with Effects](https://react.dev/learn/synchronizing-with-effects)

コンポーネントには、外部システムと同期しなければならないものもあります。たとえば、つぎのような場合です。

* React以外のコンポーネントを状態にもとづいて制御したいとき。
* サーバーとの接続を確立したいとき。
* 分析用のログをコンポーネントが画面に表示されたら送りたいとき。

エフェクトは、レンダリング後にそのコードを実行します。すると、Reactの外のシステムとコンポーネントを同期できるのです。

### [エフェクト(useEffect)を使わなくてよい場合とは](https://qiita.com/FumioNonaka/items/f6bfe4ca77e590f9e73f)
* [You Might Not Need an Effect](https://beta.reactjs.org/learn/you-might-not-need-an-effect)

エフェクトは、Reactの仕組みからの非常口です。Reactの「外に出て」コンポーネントを外部システムと同期できます。たとえば、React以外のウィジェットやネットワーク、あるいはブラウザDOMなどです。外部システムが関わらないなら、エフェクトは要りません。コンポーネントの状態を、プロパティや状態が変わったら更新したいといった場合です。不要なエフェクトを除けば、コードはわかりやすく、実行も速くなり、エラーが起こりにくくなります。

### [リアクティブなエフェクト(useEffect)のライフサイクル](https://qiita.com/FumioNonaka/items/a24567403fd7bb20be55)
* [Lifecycle of Reactive Effects](https://beta.reactjs.org/learn/lifecycle-of-reactive-effects)

エフェクトとコンポーネントとは異なるライフサイクルです。

* コンポーネント
  - マウント
  - 更新
  - アンマウント
* エフェクト
  - 同期の開始
  - 同期の停止

エフェクトの依存するプロパティや状態が時間とともに変化する場合、ライフサイクルは繰り返されるかもしれません。Reactの提供するリンタールールにより、エフェクトに正しく依存が定められているか確かめられます。こうして、エフェクトは最新のプロパティや状態と同期されるのです。

### [イベントとエフェクトにロジックを分ける](https://qiita.com/FumioNonaka/items/3484d2a2a5f0514a377c)
* [Separating Events from Effects](https://beta.reactjs.org/learn/separating-events-from-effects)

イベントハンドラは、あらかじめ定めたインタラクションを行ったときにのみ再実行されます。それに対して、プロパティや状態変数のような読み取った値が、直前のレンダリング時と異なるとき再同期するのがエフェクトです。場合によっては、ふたつの動きを組み合わせたいかもしれません。エフェクトをある値に応じては再実行し、他の値には応答させないというときです。こういう処理の考え方についてご説明しましょう。

### [エフェクトの依存を除く](https://qiita.com/FumioNonaka/items/1ca250ec6bf7234a7afd)
* [Removing Effect Dependencies](https://react.dev/learn/removing-effect-dependencies)

エフェクトを書くと、リンターはコードに(プロパティや状態などの)リアクティブな値が含まれているかどうか確かめます。それらの値は、すべてエフェクトが読み取る依存配列に加えられていなければなりません。これにより、エフェクトはコンポーネントの最新のプロパティや状態と同期が保てるのです。要らない依存値が含まれていると、エフェクトは必要以上に実行されたり、無限ループを引き起こすかもしれません。本稿が解説するのは、エフェクトの不要な依存値をいかに見つけ、取り除くかです。

エフェクトを書くと、リンターはコードに(プロパティや状態などの)リアクティブな値が含まれているかどうか確かめます。それらの値は、すべてエフェクトが読み取る依存配列に加えられていなければなりません。これにより、エフェクトはコンポーネントの最新のプロパティや状態と同期が保てるのです。要らない依存値が含まれていると、エフェクトは必要以上に実行されたり、無限ループを引き起こすかもしれません。本稿が解説するのは、エフェクトの不要な依存値をいかに見つけ、取り除くかです。

### [カスタムフックでロジックを再利用する](https://qiita.com/FumioNonaka/items/34a2b6dfa8a6edc14f23)
* [Reusing Logic with Custom Hooks](https://react.dev/learn/reusing-logic-with-custom-hooks)

Reactには、`useState`や`useContext`、`useEffect`などさまざまな組み込みフックが備わっています。けれど、もっと特定の目的に応じたフックが必要になることもあるでしょう。たとえば、つぎのような用途です。

* データの取得。
* ユーザがオンラインかどうかの監視。
* チャットルームへの接続。

Reactの組み込みフックには見当たらないかもしれません。けれど、アプリケーションの必要に合わせて、フックは自作できます。