Plusプラン限定レッスン

フォームの取り扱い方

React でのフォームの取り扱いは、通常の HTML にくらべると少し違います。

React と HTML でのフォームの違い

HTML と同じようにフォームを作ると、見た目上入力できても内部でデータを保持することができず、React アプリケーションの中で値を使えません。

HTML では <input>、<textarea>、そして <select>のようなフォーム要素は通常、自身で状態を保持しており、ユーザーの入力に基づいて更新します。

<!-- これはHTMLのフォームです。Reactでは正常に動作しません -->
<form>
  <label>
    おなまえ:
    <input type="text" name="name" />
  </label>
  <input type="submit" value="Submit" />
</form>

React では、変更されうる状態はコンポーネントの state プロパティに保持され、state を更新する関数でのみ更新されます。フォームの変更される関数はonChange属性に定義することで、ユーザーがフォームへ入力したデータにアクセスできます。

import React from "react";

export const InputComponent = () => {
  // stateを定義
  const [value, setValue] = React.useState("");
  // inputの中身が変更されたら、setValue関数でstateの中身を更新する。
  const handleChange = e => {
    setValue(e.target.value);
  };
  // JSXを返却。value属性にstateを紐付けることで値が連動する。
  // onChange属性に値が変更された時の関数を紐づけることで、stateの更新が可能になる。
  return <input type="text" value={value} onChange={handleChange} />;
};

input タグを React で取り扱う

HTML の場合、<input>要素は自身で状態を保持しており、ユーザーの入力に基づいてvalue属性の値が更新されます。

<!-- これはHTMLのinputタグです。
以下は、「Taro」と表示されたフォームが表示されます -->
<input type="text" name="name" value="Taro" />

React の場合はstateで状態を管理するため、value属性にセットする値とstateを連動させます。値が変更される際は、onChange属性にセットした関数で更新します。

import React from "react";

export const TextInputComponent = () => {
  // ステートを定義
  const [value, setValue] = React.useState("Taro");
  // inputの中身が変更されたら、setValue関数でstateの中身を更新する。
  const handleChange = e => {
    setValue(e.target.value);
  };

  return <input type="text" value={value} onChange={handleChange} />;
};

textarea タグを React で取り扱う

HTML の場合、<textarea>要素はテキストを要素内部に定義しています。

<textarea>
 これはHTMLのテキストエリアです。
</textarea>

React では、<textarea>にvalue属性を持たせて、値として state をセットして使います。値が変更される際は、<input>タグと同じようにonChange属性にセットした関数で更新します。

import React from "react";

export const TextareaComponent = () => {
  // ステートを定義
  const [value, setValue] = React.useState("");
  // inputの中身が変更されたら、setValue関数でstateの中身を更新する。
  const handleChange = e => {
    setValue(e.target.value);
  };

  return <textarea value={value} onChange={handleChange} />;
};

select タグを Reactで取り扱う

HTML では、<select>タグ は<option>タグを使ってドロップダウンリストを作成します。選択している項目にはselected属性をつけることで対応します。

<!-- これはHTMLのselectタグです。 -->
<select>
  <option value="grapefruit">グレープフルーツ</option>
  <option value="lime">ライム</option>
  <!-- この要素が選択されています。 -->
  <option selected value="coconut">ココナッツ</option>
  <option value="mango">マンゴー</option>
</select>

Reactでは、selected属性を<option>タグにつける代わりに、親要素である<select>タグに対してvalue属性を設定します。

import React from "react";

export const SelectComponent = () => {
  // ステートを定義。はじめに「coconut」が選択された状態
  const [value, setValue] = React.useState({ value: "coconut" });
  // selectの中身が変更されたら、setValue関数でstateの中身を更新する。
  const handleChange = e => {
    setValue({ value: e.target.value });
  };

  return (
    <select value={value} onChange={handleChange}>
      <option value="grapefruit">グレープフルーツ</option>
      <option value="lime">ライム</option>
      <option value="coconut">ココナッツ</option>
      <option value="mango">マンゴー</option>
    </select>
  )
};

一箇所で更新すればよいだけなので、たとえばドロップダウンリストを親のpropsから受け継いてコンポーネントに展開するなど、より便利な使い方ができます。

import React from "react";

export const SelectFruitsComponent = () => {
  // ドロップダウンリストの定義
  const dropdownList = [
    {
      name: "グレープフルーツ",
      value: "grapefruit",
    },
    {
      name: "ライム",
      value: "lime",
    },
    {
      name: "ココナッツ",
      value: "coconut",
    },
    {
      name: "マンゴー",
      value: "mango",
    },
  ];
  // ステートを定義。はじめに「coconut」が選択された状態
  const [value, setValue] = React.useState({ value: "coconut" });

  // selectの中身が変更されたら、setValue関数でstateの中身を更新する。
  const handleChange = (event) => {
    setValue({ value: event.target.value });
  };

  // 決定ボタンを押したら実行される関数
  const handleSubmit = (event) => {
    console.log(`あなたの選択したフルーツは ${value} です。`);
    // このコードでは実際にはデータ送信しないため、本来の挙動を無効化
    event.preventDefault();
  };
  return (
    <div>
      <p>選択してください</p>
      {/* 決定ボタンを押したら実行される関数を onSubmit 属性に定義 */}
      <form onSubmit={handleSubmit}>
        <label>
          {/* 中身が変更されたら実行される関数を onChange 属性に定義 */}
          <select onChange={handleChange}>
            {/* 定義したドロップダウンリストをマッピング */}
            {dropdownList.map((item) => (
              <option key={item.value} value={item.value}>
                {item.name}
              </option>
            ))}
          </select>
        </label>
        <input type="submit" value="決定" />
      </form>
    </div>
  );
};

この続きはPlusプラン限定です