ReactのuseStateとは?基本の使い方と画面が更新される仕組みを初心者向けに解説

ReactのuseStateの基本解説記事のアイキャッチ

コンポーネントとPropsの基本を理解してコンポーネント間でのデータの受け渡しができるようになると、次に挑戦したくなるのが「ボタンを押して数字を増やす」「入力フォームの文字をリアルタイムで画面に反映する」といった動的な画面作りです。

私も放課後にReactのコードを書き始めた最初の頃に、JavaScriptと同じ感覚で let count = 0; と変数を作って、ボタンを押すたびに count++ と値を書き換える処理を書いたことがありました。でもコンソールで確認すると数字は増えているのに、なぜか画面の数字は変わらなくて「もうなんで画面が書き換わらないの〜っ?」と悩みました。

Reactで「ユーザーの操作に合わせて画面の表示を更新する」ためには、通常の変数ではなく State(ステート・状態) という仕組みを使う必要があります。

この記事では、Reactの最も基本的で重要な機能の1つである useState(ユーステート) の使い方と画面が更新される仕組みについて分かりやすく解説します。

なぜ普通の変数(let)では画面が更新されないの?

まずは、私がつまずいた「普通の変数では画面が更新されない理由」から整理しておきましょう。

// NGな例:普通の変数を使っても画面は更新されない
function Counter() {
  let count = 0;

  const handleClick = () => {
    count = count + 1;
    console.log(count); // コンソール上では増えているが画面は変わらない
  };

  return (
    <div>
      <p>カウント: {count}</p>
      <button onClick={handleClick}>増やす</button>
    </div>
  );
}

変数宣言(let, const)で学んだ通り、count の値自体は書き換わっています。

しかし、Reactは「State(状態)が更新されたタイミング」で画面を再描画(再レンダリング)する仕組みになっています。普通の変数を書き換えてもReactに「画面を塗り替えてね!」というサインが伝わらないため、表示が変わらなかったんですよね。

画面の表示と連動させたいデータは、必ず useState を使って管理する必要があります。

useState の基本構文と書き方

useState は、Reactが用意している Hook(フック) と呼ばれる便利機能の1つです。ファイルの先頭で react からインポートして使用します。

基本的な書き方は以下の通りです。

import { useState } from 'react';

// useStateの呼び出し
const [state名, 更新関数名] = useState(初期値);

一見すると不思議な書き方に見えますが、ここで使われているのが 分割代入(Destructuring) です。

useState 関数を実行すると、要素が2つ入った配列が返されてきます。

  1. 1つ目の要素(現在の値): 画面に表示するためのデータ本体(例:count)
  2. 2つ目の要素(更新関数): データを書き換えるための専用関数(例:setCount)

更新関数の名前は、値の名前の前に set をつけた名前(setCount や setText など)にするのが一般的なルールです。

カウンターのコードを useState で書き換えてみる

先ほどのNG例を useState を使って書き直してみます。

import { useState } from 'react';

function Counter() {
  // 初期値を 0 に設定
  const [count, setCount] = useState(0);

  const handleClick = () => {
    // 専用の更新関数を使って値を変更する
    setCount(count + 1);
  };

  return (
    <div>
      <p>カウント: {count}</p>
      <button onClick={handleClick}>増やす</button>
    </div>
  );
}

ボタンをクリックすると setCount(count + 1) が実行されます。この更新関数が呼ばれることで、Reactが「count の状態が変わったから画面を新しく描画し直そう!」と判断し、画面上の数字がスムーズに切り替わるようになります。

【落とし穴】前回の値を使って更新する場合は「関数型アップデート」を使う

ここで、初心者が次に出くわしやすい落とし穴についても触れておきます。

例えば、1回のクリックで数字を「2」増やしたくて、次のように setCount(count + 1) を2回続けて書いたとします。

const handleClick = () => {
  setCount(count + 1);
  setCount(count + 1); // 2つ増えそうに見えるが、実際は 1 しか増えない
};

一見すると +2 増えそうですが、実はこれだと +1 しか増えません。更新関数に直接 count + 1 を渡すと、両方とも「現在の count(例えば 0)に 1 を足す」という処理になってしまうためです。

連続して更新したい場合や、確実に関数実行時の最新の値をもとに更新したい場合は、更新関数に コールバック関数 を渡す 関数型アップデート という書き方を使います。

const handleClick = () => {
  // 引数 prev に最新の状態(直前の State)が入ってくる
  setCount(prev => prev + 1);
  setCount(prev => prev + 1); // これなら確実に +2 増える!
};

「前回の値をもとに計算して新しい状態を作る」ときは、この関数型アップデートの書き方を使う習慣をつけておくと安心です。

オブジェクトや配列の State を更新するときの重要ルール

数値や文字列だけでなく、オブジェクトや配列を useState で管理することも多いです。

ただし、オブジェクトや配列の値を更新するときには1つ大きな注意点があります。それは「元のオブジェクトを直接書き換えてはいけない」というルールです。

// NGな例:直接プロパティを書き換えて更新関数に渡す
const [user, setUser] = useState({ name: 'りあぴ', age: 17 });

const handleUpdate = () => {
  user.age = 18; // 直接変更するのはNG!
  setUser(user); // Reactが「値が変わった」と認識できない
};

Reactは「値の参照(メモリ上の置き場所)」が変わったかどうかで変化を検知します。直接中身を書き換えて同じオブジェクトを渡しても、Reactは「前と同じオブジェクトだな」と判定して再描画してくれません。

スプレッド構文を使って新しいオブジェクトを作る

オブジェクトや配列の状態を更新するときは、スプレッド構文(…) を使って「新しいオブジェクト(コピー)を作成して渡す」のが正解です。

// OKな例:スプレッド構文でコピーを作成して更新する
const [user, setUser] = useState({ name: 'りあぴ', age: 17 });

const handleUpdate = () => {
  setUser({
    ...user,    // 既存の name: 'りあぴ' などをコピー
    age: 18     // 変更したい部分だけ上書き
  });
};

配列に要素を追加したい場合も同様に、直接 push() を使うのではなく、スプレッド構文で新しい配列を作成します。

const [todos, setTodos] = useState(['部屋の掃除', 'Reactの勉強']);

const addTodo = (newTodo) => {
  // 直接 push はせず、新しい配列を作って更新する
  setTodos([...todos, newTodo]);
};

JavaScriptの基礎で学んだスプレッド構文が、まさにこの useState の場面で大活躍します。

まとめ

  • 画面が更新される仕組み: 普通の変数(let)ではなく useState の更新関数を使うことで、Reactが画面の再描画を検知する
  • 書き方のルール: const [state名, setState名] = useState(初期値) の形で分割代入を使って受け取る(1つ目の要素が値、2つ目の要素が更新関数)
  • 関数型アップデート: 前回の状態をもとに確実に更新したいときは setCount(prev => prev + 1) と書く
  • 直接書き換えない: 配列やオブジェクトを更新する際は、直接変更せずスプレッド構文(...)で新しいコピーを作成して更新関数に渡す

useState を使いこなせるようになると、カウンターやフォーム入力、ドロワーメニューの開閉など、ユーザーの操作に応じて動くWebアプリケーションが作れるようになります。

まずは数字を増減させるシンプルなカウンターやテキスト入力フォームなどから手を動かして試してみるのがオススメです!

コメント

タイトルとURLをコピーしました