Next.jsで学ぶReact講座 90日コース | React基礎 - Day 16:useState

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

Day 16:useStateで状態を管理する

State(状態)は、画面に表示され、操作によって変化するデータです。カウンターの数値や入力欄の内容などがStateにあたります。ReactのuseStateを使うと、Stateを保存し、更新に合わせて画面を再表示できます。(🔗 react.dev)

この日は、増加・減少・リセット・任意の数値で増減できるカウンターアプリを作ります。

1. Stateとは

たとえば、カウンター画面に「現在の値:0」と表示されているとします。利用者がボタンを押して値が1になったとき、画面も「現在の値:1」に変わる必要があります。

このように、アプリの操作に応じて変化し、画面表示に使われるデータがStateです。

  • カウンターの数値
  • 入力欄に入力されている文字
  • メニューが開いているかどうか
  • 読み込み中かどうか

普通の変数を書き換えただけでは、Reactは画面を更新する必要があると判断できません。画面に反映したい値は、useStateで管理します。

2. useStateの基本

useStateは、現在の状態と、その状態を更新する関数を返します。

// ReactからuseStateを読み込みます
import { useState } from "react";

// カウンターコンポーネントです
function Counter() {
  // countは現在の状態、setCountは状態を更新する関数です
  const [count, setCount] = useState(0);

  // 現在のcountとボタンを表示します
  return (
    <section>
      <p>現在の値:{count}</p>

      {/* クリックするとcountを1増やします */}
      <button onClick={() => setCount(count + 1)}>
        1増やす
      </button>
    </section>
  );
}
JSX

useState(0)の0は初期値です。countには現在の状態が入り、setCountを呼び出すと状態を更新できます。

const [count, setCount]という書き方は、配列の分割代入です。状態を使うときは、通常この形で現在値と更新関数を受け取ります。

3. 状態を更新すると画面が再表示される

setCount(...)で状態を更新すると、Reactは新しい状態を使ってコンポーネントを再実行し、画面を更新します。これを再レンダーと呼びます。

// ボタンがクリックされたときの関数です
function handleClick() {
  // 状態更新をReactに依頼します
  setCount(5);
}
JSX

状態を更新した直後に、同じ関数内のcountがすぐ新しい値に置き換わるわけではありません。countは、その時点のレンダーで使われている値です。更新後の表示は、Reactが次に画面を描画したときに反映されます。(🔗 react.dev)

// 状態更新を依頼する例です
function handleClick() {
  // Reactに次の状態を依頼します
  setCount(count + 1);

  // この行で参照するcountは、現在のレンダーの値です
  console.log(count);
}
JSX

更新直後に画面が変わらないように見えても、すぐに状態更新が失敗したと判断しないでください。Reactが更新を処理した後の画面で確認しましょう。

4. 前の状態を使って更新する

現在の状態をもとに次の値を計算する場合は、更新関数の形を使うと分かりやすく、安全です。

// 直前の状態を使ってカウントを増やします
setCount((currentCount) => currentCount + 1);
JSX

currentCountには、更新時点の最新の状態が渡されます。カウンターの増減のように「前の値に足す・引く」処理では、この形を基本として使いましょう。Reactは状態更新をまとめて処理することがあるため、前の状態を使う更新は特に役立ちます。(🔗 react.dev)

5. Next.jsの準備

Next.jsのApp Routerを使っている場合、クリックイベントやuseStateを使うページはClient Componentにします。ページファイルの先頭に'use client'を記述します。(🔗 nextjs.org)

今回のページは、次のどちらかに作成します。

  • app/page.js
  • src/app/page.js

プロジェクトにある構成に合わせて選んでください。開発サーバーが起動していない場合は、プロジェクトのフォルダーで次を実行します。

# Next.jsの開発サーバーを起動します
npm run dev

6. カウンターの画面を作る

最初に、カウントを増やす・減らす・リセットする部分を作ります。

// useStateを読み込みます
import { useState } from "react";

// カウンターページを定義します
export default function CounterPage() {
  // カウントの初期値を0にします
  const [count, setCount] = useState(0);

  // 画面にカウンターを表示します
  return (
    <main>
      <h1>カウンター</h1>

      {/* 現在の状態を表示します */}
      <p>現在の値:{count}</p>

      {/* 直前の状態を使って1減らします */}
      <button
        type="button"
        onClick={() => setCount((currentCount) => currentCount - 1)}
      >
        1減らす
      </button>

      {/* 状態を初期値の0に戻します */}
      <button
        type="button"
        onClick={() => setCount(0)}
      >
        リセット
      </button>

      {/* 直前の状態を使って1増やします */}
      <button
        type="button"
        onClick={() => setCount((currentCount) => currentCount + 1)}
      >
        1増やす
      </button>
    </main>
  );
}
JSX

このページはクリック操作を使うので、ファイルの先頭に'use client'を追加してください。完成版では、任意の数値を入力する機能も加えます。

7. 任意の数値を入力する

任意の数値を使ってカウントを増減できるように、入力欄を追加します。入力欄の値も画面に関わるため、Stateとして管理します。

HTMLの入力欄から取得する値は文字列です。数値として計算するにはNumber()で変換し、入力が妥当か確認します。

// 任意の数値を受け取る入力欄の例です
function StepInput() {
  // 入力値は文字列として管理します
  const [step, setStep] = useState("1");

  // 入力欄と現在の値を表示します
  return (
    <section>
      <label htmlFor="step">増減する数値</label>

      {/* 入力値をStateと同期します */}
      <input
        id="step"
        type="number"
        value={step}
        onChange={(event) => setStep(event.target.value)}
      />

      {/* 入力値をそのまま表示します */}
      <p>入力中:{step}</p>
    </section>
  );
}
JSX

stepを文字列として管理するのは、入力途中の空欄も自然に扱えるためです。計算するときに数値へ変換し、値が整数か、正の数かを確認します。

8. 完成版:増加・減少・リセット・任意の数値追加

次のコードをapp/page.jsまたはsrc/app/page.jsに書いてください。

// このファイルをClient Componentとして扱います
"use client";

// Reactの状態管理機能を読み込みます
import { useState } from "react";

// カウンターアプリのページです
export default function CounterPage() {
  // カウントを数値のStateとして管理します
  const [count, setCount] = useState(0);

  // 増減に使う数値を文字列のStateとして管理します
  const [step, setStep] = useState("1");

  // 入力エラーを表示するためのStateです
  const [errorMessage, setErrorMessage] = useState("");

  // 入力値を確認し、正しい数値なら返す関数です
  function getValidStep() {
    // 前後の空白を取り除いて数値に変換します
    const amount = Number(step.trim());

    // 空欄、整数以外、0以下の値は受け付けません
    if (
      step.trim() === "" ||
      !Number.isSafeInteger(amount) ||
      amount <= 0
    ) {
      // 入力の問題を画面に表示します
      setErrorMessage("1以上の整数を入力してください。");

      // 入力値が不正だと分かる値を返します
      return null;
    }

    // 入力エラーを消します
    setErrorMessage("");

    // 確認済みの数値を返します
    return amount;
  }

  // 入力した数値だけカウントを増やします
  function handleAddStep() {
    // 入力値を確認します
    const amount = getValidStep();

    // 入力値が不正なら、更新せずに終了します
    if (amount === null) {
      return;
    }

    // 最新のカウントに入力値を足します
    setCount((currentCount) => currentCount + amount);
  }

  // 入力した数値だけカウントを減らします
  function handleSubtractStep() {
    // 入力値を確認します
    const amount = getValidStep();

    // 入力値が不正なら、更新せずに終了します
    if (amount === null) {
      return;
    }

    // 最新のカウントから入力値を引きます
    setCount((currentCount) => currentCount - amount);
  }

  // 現在のカウントと操作欄を表示します
  return (
    <main>
      <h1>カウンターアプリ</h1>

      {/* 現在のStateを画面に表示します */}
      <p aria-live="polite">現在の値:{count}</p>

      {/* 1ずつ増減するボタンです */}
      <section>
        <h2>1ずつ増減</h2>

        {/* 最新の状態から1を引きます */}
        <button
          type="button"
          onClick={() => setCount((currentCount) => currentCount - 1)}
        >
          1減らす
        </button>

        {/* Stateを0に戻します */}
        <button
          type="button"
          onClick={() => setCount(0)}
        >
          リセット
        </button>

        {/* 最新の状態に1を足します */}
        <button
          type="button"
          onClick={() => setCount((currentCount) => currentCount + 1)}
        >
          1増やす
        </button>
      </section>

      {/* 入力した任意の数値で増減する部分です */}
      <section>
        <h2>任意の数値で増減</h2>

        <label htmlFor="step">増減する数値</label>

        {/* 入力欄の値をStateと同期します */}
        <input
          id="step"
          type="number"
          min="1"
          step="1"
          value={step}
          onChange={(event) => {
            // 入力値は文字列としてStateに保存します
            setStep(event.target.value);

            // 入力し直すときは古いエラーを消します
            setErrorMessage("");
          }}
        />

        {/* 入力した数値でカウントを増やします */}
        <button type="button" onClick={handleAddStep}>
          入力値だけ増やす
        </button>

        {/* 入力した数値でカウントを減らします */}
        <button type="button" onClick={handleSubtractStep}>
          入力値だけ減らす
        </button>

        {/* 入力に問題があるときだけメッセージを表示します */}
        {errorMessage !== "" && (
          <p role="alert">{errorMessage}</p>
        )}
      </section>
    </main>
  );
}
JSX

このコードでは、count、step、errorMessageをそれぞれ別のStateとして管理しています。役割ごとに分けると、どの値をどの操作で更新しているか追いやすくなります。

9. イミュータブルな更新とは

イミュータブルな更新とは、現在のデータを直接書き換えず、新しいデータを作って更新する考え方です。カウンターの数値は、setCount(...)に新しい数値を渡しているため、元の値を直接変更していません。

オブジェクトや配列をStateとして扱うときは、特にこの考え方が重要です。たとえば、配列へ直接push()すると元の配列が変わってしまいます。

// 配列をStateとして管理する例です
const [items, setItems] = useState(["ノート"]);

// 避けたい例:現在の配列を直接変更しています
// items.push("ペン");

// 推奨例:スプレッド構文で新しい配列を作ります
setItems((currentItems) => [...currentItems, "ペン"]);
JSX

オブジェクトを更新するときは、スプレッド構文で元のプロパティを引き継ぎ、変更したい値を上書きします。

// ユーザー情報をStateとして管理します
const [user, setUser] = useState({
  name: "さくら",
  age: 25,
});

// ageを更新した新しいオブジェクトを作ります
setUser((currentUser) => ({
  ...currentUser,
  age: 26,
}));
JSX

Reactでは、オブジェクトや配列の中身だけを直接変更するのではなく、新しいオブジェクトや配列を作って渡します。Reactが状態の変化を正しく扱えるようにするための大切な習慣です。(🔗 react.dev)

10. useStateのよくある間違い

通常の変数を変更する

次のように普通の変数を更新しても、Reactは画面を更新するきっかけを受け取りません。

// 注意:普通の変数を書き換えても、Reactの画面更新にはつながりません
let count = 0;

// クリックでcountを変えても、ReactのStateではありません
count = count + 1;
JSX

画面に反映する値にはuseStateを使い、更新関数を呼びます。

Stateを直接変更する

配列やオブジェクトのStateを直接変更してはいけません。新しい配列やオブジェクトを作り、更新関数に渡します。

// 例:配列Stateに新しい項目を追加します
setItems((currentItems) => [
  ...currentItems,
  "新しい項目",
]);
JSX

更新関数の中で別の処理を行う

状態更新用の関数は、次の状態を計算するために使います。ログ出力や画面表示など、状態計算以外の副作用を入れないようにします。Reactは開発時に更新関数を複数回呼び出して問題がないか確認することがあります。(🔗 react.dev)

// 推奨:更新関数は次の状態だけを計算して返します
setCount((currentCount) => currentCount + 1);
JSX

入力欄の値を数値だと考える

event.target.valueは文字列です。計算に使うときは数値に変換し、空欄や不正な値を確認してから使います。

// 入力値を数値に変換します
const amount = Number(event.target.value);

// 整数かどうかを確認します
if (Number.isSafeInteger(amount)) {
  // 確認した値を使って処理します
}
JSX

11. 練習用テンプレート

次のテンプレートを完成させ、カウントの増加、減少、リセットを実装しましょう。

// useStateを読み込みます
import { useState } from "react";

// 練習用カウンターです
export default function PracticeCounter() {
  // TODO: countのStateを初期値0で作ります

  return (
    <main>
      <h1>練習カウンター</h1>

      {/* TODO: 現在のcountを表示します */}

      {/* TODO: クリックすると1減らすボタンを作ります */}

      {/* TODO: クリックすると0に戻すボタンを作ります */}

      {/* TODO: クリックすると1増やすボタンを作ります */}
    </main>
  );
}
JSX

完成したら、入力欄を追加し、入力した数値で増減する機能も試してみてください。入力値が空欄、小数、負の数のとき、どう扱うかを自分で決めると入力チェックの練習になります。

12. Day 16のチェックリスト

  • Stateが画面に表示され、操作で変化するデータだと説明できます。
  • useStateから現在値と更新関数を取り出せます。
  • 更新関数を呼ぶと、Reactが状態を反映して画面を再表示することを理解しています。
  • 前の状態を使う更新では、setState(current => ...)の形を使えます。
  • 入力欄の値をStateで管理し、数値として使う前に変換と確認ができます。
  • カウンターの増加、減少、リセット、任意の数値での増減を実装できます。
  • 配列やオブジェクトのStateを直接変更せず、新しいデータを作って更新できます。

useStateで重要なのは、画面に反映したい値をStateとして管理し、直接書き換えず更新関数を通じて変更することです。今回のカウンターでは数値のStateを更新し、入力値は検証してから計算に使いました。この基本は、フォーム、メニュー、商品一覧など、Reactのさまざまな画面で応用できます。

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