状態管理(useState)

Webアプリケーションでは、「ボタンを押した回数を数える」「入力欄に打ち込まれた文字を保持する」「モーダルウィンドウの開閉を切り替える」など、時間経過やユーザ操作に応じて変化する値をコンポーネントが持ちたい場面がよくあります。この「コンポーネントが自分の中に持ち、変わったときに画面に反映してほしい値」を、Reactでは状態(state)と呼びます。

状態を持たせるには、通常のJavaScriptのように変数を宣言して代入するだけでは不十分で、Reactが変更を検知して画面を再描画できる形にする必要があります。そのために使うのが React Hooks の1つである useState です。書き方は以下のとおりです。

const [状態変数, セッター関数] = useState(初期値);

useState は「現在の状態」と「状態を更新する関数」の2つを配列で返すので、分割代入で受け取ります。セッター関数を呼ぶと状態が更新され、Reactがコンポーネントを再実行して画面を更新してくれます。

1. 状態を持たない場合の問題

まず、状態を使わずに変数だけでボタンの動きを書こうとするとどうなるかを確認します。src/App.tsx を以下のコードに書き換えます。

export default function App() {
  let count = 0;

  return (
    <div>
      <p>現在の値: {count}</p>
      <button onClick={() => (count = count + 1)}>+1する</button>
    </div>
  );
}

保存してブラウザで「+1する」ボタンを何度クリックしても、画面の数字は 0 のまま変わりません。

現在の値: 0

count 変数は増えていますが、Reactは「状態が変わった」ことを検知できず、画面が再描画されないためです。関数コンポーネントは、状態が変わったときだけ再実行されて画面を更新します。ふつうのローカル変数を書き換えても、Reactはそれを追いかけません。

2. useState による状態の保持

同じカウンタを、useState を使って書き直します。src/App.tsx を以下のコードに書き換えます。

import { useState } from "react";

export default function App() {
  const [count, setCount] = useState(0);

  return (
    <div>
      <p>現在の値: {count}</p>
      <button onClick={() => setCount(count + 1)}>+1する</button>
    </div>
  );
}

保存してブラウザで「+1する」ボタンをクリックするたびに、現在の値: の数字が1ずつ増えていきます。以下は、初期状態(0)・1回クリックした状態(1)・3回クリックした状態(3)の3枚です。

現在の値: 3

ボタンをクリックするたびに 現在の値 の数字が追随して増えていけば、useState による状態管理が動作しています。

コードを解説します。

import { useState } from "react";

useState は React が提供する関数(Hook)なので、react から import して使います。Hooksはコンポーネントの関数内でしか呼び出せないというルールがあります。

const [count, setCount] = useState(0);

useState(0) は「初期値 0 の状態」を作り、[現在の値, 更新関数] の配列を返します。分割代入で count(現在の値)と setCount(更新関数)を受け取ります。変数名は自由に付けられますが、「状態名」と「set + 状態名」のペアにするのが慣例です。

<button onClick={() => setCount(count + 1)}>+1する</button>

onClick に渡した関数がクリック時に実行されます。setCount(count + 1) を呼ぶと、count の値が更新され、Reactが App コンポーネントを再実行して画面を更新します。この「セッター関数を呼ぶ → コンポーネントが再実行される → 画面が更新される」という流れが、Reactの状態管理の中核です。

📝 Hooks の呼び出しルール
useState などのHooksは、コンポーネント関数のトップレベルでしか呼び出せません。if 文や for ループの中で条件付きに呼び出すことは禁止されています。理由は、Reactが「何番目に呼ばれた useState はこの状態」という順序で状態を管理しているためです。詳細は Rules of Hooks(React公式ドキュメント) に記載があります。

3. 入力フォームでの状態管理

状態管理の応用として、入力フォームの値を状態として保持する例を見ます。フォームの入力値をReactに管理させることで、送信ボタンの活性・非活性の制御や、入力バリデーションの結果表示が書きやすくなります。src/App.tsx を以下のコードに書き換えます。

import { useState } from "react";

export default function App() {
  const [name, setName] = useState("");

  return (
    <div>
      <label>
        名前:
        <input
          type="text"
          value={name}
          onChange={(e) => setName(e.target.value)}
        />
      </label>
      <p>入力中の名前: {name}</p>
    </div>
  );
}

保存してブラウザの入力欄に文字を打つと、入力欄の値と段落の表示が同期します。以下は、入力前の状態と テスト太郎 と入力した状態の2枚です。

入力中の名前: テスト太郎

入力するたびに 入力中の名前: の後の文字がリアルタイムで更新されれば、onChange と useState が正しく連携しています。

コードを解説します。

const [name, setName] = useState("");

空文字を初期値として、name に現在の入力値を持たせます。

<input
  type="text"
  value={name}
  onChange={(e) => setName(e.target.value)}
/>

value={name} で入力欄の表示を状態と同期させ、onChange で入力があるたびに setName を呼んで状態を更新します。この「入力値をReactの状態として管理する」書き方を、Reactでは制御されたコンポーネント(controlled component)と呼びます。