Next.jsで学ぶReact講座 90日コース | React基礎 - Day 15:イベント処理

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

Day 15:Reactのイベント処理

イベント処理とは、ボタンのクリックや入力欄の変更、フォームの送信など、利用者の操作に応じてプログラムを動かすことです。ReactではonClickやonChangeなどのイベントハンドラーを使います。

Next.jsのApp Routerでは、ページやレイアウトは既定でServer Componentです。クリック操作やuseStateを使う部分はClient Componentにし、ファイルの先頭に'use client'を記述します。(🔗 nextjs.org)

この日は、カウンター、ボタンの表示切り替え、メニューの開閉を作りながら、onClick、onChange、onSubmitとイベントオブジェクトを学びます。

1. イベントハンドラーとは

イベントハンドラーは、操作が起きたときに実行する関数です。Reactでは、イベント名をキャメルケースで書き、関数を渡します。

// ボタンがクリックされたときに実行する関数です
function handleClick() {
  // クリックされたことをコンソールに表示します
  console.log("ボタンがクリックされました");
}

// ボタンにイベントハンドラーを登録する例です
function ExampleButton() {
  return (
    // 関数を呼び出さず、ハンドラーとして渡します
    <button onClick={handleClick}>クリック</button>
  );
}
JSX

onClick={handleClick}のように、関数そのものを渡します。onClick={handleClick()}と書くと、クリックする前に関数を呼び出してしまうので注意してください。

2. イベント処理には状態が必要

操作に応じて画面を変えるには、変化する値をReactの状態(state)として管理します。状態を更新すると、Reactがその値を使って画面を再表示します。状態を使うにはuseStateを利用します。(🔗 react.dev)

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

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

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

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

useState(0)の0は、最初に表示する値です。countには現在の状態が入り、setCount(...)を呼び出すと状態が更新されます。

3. onClickでカウンターを作る

カウントを増やす・減らす・0に戻すボタンを作ってみましょう。

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

// 増減できるカウンターです
export default function Counter() {
  // カウントの初期値を0にします
  const [count, setCount] = useState(0);

  // カウントを1増やす関数です
  function handleIncrement() {
    // 現在の値をもとに、新しい値を設定します
    setCount((currentCount) => currentCount + 1);
  }

  // カウントを1減らす関数です
  function handleDecrement() {
    // 現在の値をもとに、新しい値を設定します
    setCount((currentCount) => currentCount - 1);
  }

  // カウントを初期値に戻す関数です
  function handleReset() {
    // 状態を0に戻します
    setCount(0);
  }

  // 現在のカウントと操作ボタンを表示します
  return (
    <section>
      <h2>カウンター</h2>
      <p>現在の値:{count}</p>

      {/* 各ボタンに関数をイベントハンドラーとして渡します */}
      <button onClick={handleDecrement}>1減らす</button>
      <button onClick={handleReset}>リセット</button>
      <button onClick={handleIncrement}>1増やす</button>
    </section>
  );
}
JSX

setCount((currentCount) => currentCount + 1)は、更新時点の最新の状態を受け取って次の値を計算する書き方です。現在の値をもとに更新する場合は、この形を使うと意図が明確になります。

4. 引数を使うイベントハンドラー

イベントハンドラーに追加の値を渡す場合は、アロー関数で包みます。

// 指定した値だけカウントを増やすコンポーネントです
function StepCounter() {
  // カウントを状態として管理します
  const [count, setCount] = useState(0);

  // 指定した数を現在のカウントに足します
  function addCount(amount) {
    setCount((currentCount) => currentCount + amount);
  }

  return (
    <section>
      <p>現在の値:{count}</p>

      {/* クリック時にaddCount(5)を実行します */}
      <button onClick={() => addCount(5)}>5増やす</button>
    </section>
  );
}
JSX

onClick={addCount(5)}とすると、画面を表示する時点で関数を呼び出してしまいます。クリックしたときに実行するには、onClick={() => addCount(5)}のように関数を渡します。

5. onChangeで入力欄の値を受け取る

onChangeは、入力欄の値が変化したときに使います。イベントオブジェクトのevent.target.valueから入力内容を取得できます。

// 入力内容を表示するコンポーネントです
function NameInput() {
  // 入力欄の値を状態として管理します
  const [name, setName] = useState("");

  // 入力が変わったときに実行する関数です
  function handleChange(event) {
    // 入力欄の現在の値を状態に保存します
    setName(event.target.value);
  }

  return (
    <section>
      <label htmlFor="name">名前</label>

      {/* 入力内容を状態と同期させます */}
      <input
        id="name"
        value={name}
        onChange={handleChange}
      />

      {/* 現在の入力内容を表示します */}
      <p>こんにちは、{name || "お名前"}さん</p>
    </section>
  );
}
JSX

value={name}で入力欄の表示を状態に結びつけ、onChangeで入力内容を状態に反映しています。この形の入力欄は制御された入力欄と呼ばれます。

Reactでは、入力中の値に応じて表示を変えたいとき、この方法が便利です。入力値を文字列として受け取るため、数値として使う場合は必要に応じてNumber()などで変換します。

6. イベントオブジェクトとは

イベントハンドラーには、発生したイベントについての情報が渡されます。慣習的にeventやeという名前で受け取り、これをイベントオブジェクトと呼びます。

// イベントオブジェクトの情報を確認するボタンです
function EventExample() {
  // クリック時にイベント情報を受け取ります
  function handleClick(event) {
    // クリックされた要素をコンソールに表示します
    console.log(event.currentTarget);
  }

  return (
    // クリック時にイベントオブジェクトが関数へ渡されます
    <button onClick={handleClick}>イベント情報を確認</button>
  );
}
JSX

よく使うプロパティやメソッドには、次のものがあります。

  • event.target:イベントが発生した要素です。
  • event.currentTarget:イベントハンドラーを登録した要素です。
  • event.preventDefault():ブラウザーの標準動作を止めます。

入力欄の値を読む場合はevent.target.valueをよく使います。クリックが親要素へ伝わるイベントなどでは、targetとcurrentTargetが異なることがあります。

7. onSubmitでフォーム送信を扱う

onSubmitは、フォームが送信されたときに使います。ブラウザーの通常のフォーム送信ではページが再読み込みされることがあるため、React内で処理したい場合はevent.preventDefault()で既定の動作を止めます。

// フォーム送信を扱うコンポーネントです
function SearchForm() {
  // 入力欄の文字を状態として管理します
  const [query, setQuery] = useState("");

  // フォームが送信されたときに実行します
  function handleSubmit(event) {
    // ブラウザーによるページ再読み込みを防ぎます
    event.preventDefault();

    // 入力された検索文字をコンソールに表示します
    console.log(`検索文字:${query}`);
  }

  return (
    // submitイベントを処理する関数を登録します
    <form onSubmit={handleSubmit}>
      <label htmlFor="query">検索</label>

      {/* 入力値を状態と同期させます */}
      <input
        id="query"
        value={query}
        onChange={(event) => setQuery(event.target.value)}
      />

      {/* type="submit"でフォームを送信します */}
      <button type="submit">検索する</button>
    </form>
  );
}
JSX

フォームでは、ボタンをクリックするだけでなく、入力欄でEnterキーを押して送信することもあります。onSubmitを使うと、どちらの操作も同じ処理で扱えます。

8. ボタンの表示を切り替える

状態がtrueかfalseかによって、ボタンの文字を切り替えます。

// ボタンを押すと表示が切り替わるコンポーネントです
function ToggleButton() {
  // 最初はオフの状態にします
  const [isOn, setIsOn] = useState(false);

  // ボタンが押されたら、現在と反対の状態にします
  function handleToggle() {
    setIsOn((currentValue) => !currentValue);
  }

  return (
    <section>
      <h2>ボタン切り替え</h2>

      {/* 状態に合わせて表示する文字を変えます */}
      <p>現在の状態:{isOn ? "オン" : "オフ"}</p>

      {/* 押すたびにオンとオフを切り替えます */}
      <button
        type="button"
        onClick={handleToggle}
        aria-pressed={isOn}
      >
        {isOn ? "オフにする" : "オンにする"}
      </button>
    </section>
  );
}
JSX

!currentValueは、trueならfalse、falseならtrueに反転します。aria-pressedはボタンの状態を支援技術に伝えるための属性です。

9. メニューを開閉する

メニューが開いているかどうかを状態で管理します。状態に応じて、メニューの表示とボタンの説明を切り替えます。

// ボタンで開閉できるメニューです
function Menu() {
  // メニューは最初閉じた状態です
  const [isOpen, setIsOpen] = useState(false);

  // メニューの開閉状態を反転します
  function handleToggleMenu() {
    setIsOpen((currentValue) => !currentValue);
  }

  return (
    <section>
      <h2>メニュー</h2>

      {/* aria-expandedで開閉状態を伝えます */}
      <button
        type="button"
        onClick={handleToggleMenu}
        aria-expanded={isOpen}
        aria-controls="menu-content"
      >
        {isOpen ? "メニューを閉じる" : "メニューを開く"}
      </button>

      {/* 開いているときだけメニューを表示します */}
      {isOpen && (
        <nav id="menu-content" aria-label="サンプルメニュー">
          <ul>
            <li><a href="#profile">プロフィール</a></li>
            <li><a href="#settings">設定</a></li>
          </ul>
        </nav>
      )}
    </section>
  );
}
JSX

isOpen && (...)は、isOpenがtrueのときだけ右側の内容を表示する書き方です。メニューの開閉をReactの状態に合わせて記述しています。

10. Next.jsで3つの実践機能をまとめる

イベントハンドラーとuseStateを使うファイルをClient Componentにします。'use client'は、ファイルの先頭に、importより前に書きます。インタラクティブな部品だけをClient Componentにすることで、ページ全体を必要以上にクライアント側へ送らずに済みます。(🔗 nextjs.org)

たとえばapp/event-practice/page.jsを作り、次のコードを入れます。

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

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

// イベント練習ページです
export default function EventPracticePage() {
  // カウンターの状態を管理します
  const [count, setCount] = useState(0);

  // ボタン切り替えの状態を管理します
  const [isOn, setIsOn] = useState(false);

  // メニューの開閉状態を管理します
  const [isMenuOpen, setIsMenuOpen] = useState(false);

  // 入力欄の値を管理します
  const [message, setMessage] = useState("");

  // フォーム送信時の処理です
  function handleSubmit(event) {
    // ブラウザーのページ再読み込みを防ぎます
    event.preventDefault();

    // 入力内容が空でないか確認して案内を表示します
    if (message.trim() === "") {
      alert("メッセージを入力してください。");
      return;
    }

    // 入力された内容を表示します
    alert(`送信内容:${message}`);

    // 送信後に入力欄を空にします
    setMessage("");
  }

  // 各練習機能を画面に表示します
  return (
    <main>
      <h1>イベント処理の練習</h1>

      {/* カウンター */}
      <section>
        <h2>カウンター</h2>
        <p>現在の値:{count}</p>

        <button
          type="button"
          onClick={() => setCount((currentCount) => currentCount - 1)}
        >
          1減らす
        </button>

        <button
          type="button"
          onClick={() => setCount(0)}
        >
          リセット
        </button>

        <button
          type="button"
          onClick={() => setCount((currentCount) => currentCount + 1)}
        >
          1増やす
        </button>
      </section>

      {/* オン・オフ切り替え */}
      <section>
        <h2>ボタン切り替え</h2>
        <p>状態:{isOn ? "オン" : "オフ"}</p>

        <button
          type="button"
          onClick={() => setIsOn((currentValue) => !currentValue)}
          aria-pressed={isOn}
        >
          {isOn ? "オフにする" : "オンにする"}
        </button>
      </section>

      {/* メニューの開閉 */}
      <section>
        <h2>メニュー開閉</h2>

        <button
          type="button"
          onClick={() => setIsMenuOpen((currentValue) => !currentValue)}
          aria-expanded={isMenuOpen}
          aria-controls="practice-menu"
        >
          {isMenuOpen ? "メニューを閉じる" : "メニューを開く"}
        </button>

        {isMenuOpen && (
          <nav id="practice-menu" aria-label="練習メニュー">
            <ul>
              <li><a href="#counter">カウンター</a></li>
              <li><a href="#toggle">ボタン切り替え</a></li>
            </ul>
          </nav>
        )}
      </section>

      {/* onChangeとonSubmitの練習 */}
      <section>
        <h2>フォーム送信</h2>

        <form onSubmit={handleSubmit}>
          <label htmlFor="message">メッセージ</label>

          <input
            id="message"
            value={message}
            onChange={(event) => setMessage(event.target.value)}
          />

          <button type="submit">送信</button>
        </form>
      </section>
    </main>
  );
}
JSX

このページを表示するには、Next.jsの開発サーバーを起動し、ブラウザーで/event-practiceを開きます。ページのURLは、app/event-practice/page.jsというフォルダー構成から決まります。

この例では、alert()で送信内容を簡単に確認しています。実際のアプリでは、画面内に送信完了メッセージを表示する方法が使いやすくなります。

11. use clientをどこに書くか

'use client'は、そのファイルをクライアント側で動かす境界を宣言します。useStateやイベントハンドラーを使うファイルで必要です。Client Componentから読み込まれるファイルもクライアント側の依存関係に含まれるため、すべてのファイルに付ける必要はありません。(🔗 nextjs.org)

  • イベント処理や状態管理を使うコンポーネントには必要です。
  • 静的な表示だけのページには、通常は不要です。
  • ファイル内のコンポーネント関数の中に書くのではなく、ファイルの先頭に書きます。
  • まず対話的な部品にだけ付け、必要以上に範囲を広げないようにします。

12. よくあるつまずき

  • イベント名を小文字で書く:ReactではonClick、onChange、onSubmitのように書きます。
  • ハンドラーをすぐ実行してしまう:onClick={handleClick}のように関数を渡します。引数を渡す場合はonClick={() => handleClick(value)}とします。
  • 状態ではなく通常の変数を変更する:画面に反映したい値はuseStateで管理します。
  • フォーム送信でページが再読み込みされる:React内で扱う場合は、event.preventDefault()を使います。
  • useStateを使うのに'use client'がない:Client Componentのファイル先頭に指定します。
  • 入力値を数値だと思い込む:event.target.valueは通常文字列です。数値として計算するなら変換とチェックを行います。

13. Day 15のチェックリスト

  • onClickでボタンのクリックを処理できます。
  • onChangeで入力欄の変更を処理できます。
  • onSubmitでフォーム送信を処理できます。
  • イベントオブジェクトから入力値や要素を取得できます。
  • event.preventDefault()でブラウザーの標準動作を止められます。
  • useStateでカウンターや開閉状態を管理できます。
  • Next.jsでイベントや状態を使うファイルに'use client'を指定できます。

イベント処理では、「どの操作を受け取るか」「どの関数を呼ぶか」「変化する値をどの状態に保存するか」を順に考えます。今回のカウンター、切り替えボタン、メニュー開閉は、いずれも操作に応じて状態を更新し、その状態から画面を表示しています。この流れを身につけると、Reactで入力フォームやインタラクティブな画面を作る土台になります。

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