ReactのコンポーネントとProps(プロップス)とは?作り方とデータの渡し方を初心者向けに解説

ReactのコンポーネントとPropsの基本解説記事のアイキャッチ

ReactでWebアプリやサイトを構築するとき、避けて通れないのが「コンポーネント」と「Props(プロップス)」という概念です。

私も放課後にReactを勉強し始めた頃、コンポーネントをどこまで細かく分ければいいのか悩んだり、親から子へと渡されるPropsを見て「このデータはどこから降ってきたんだろう……」と仕組みが掴めず困ってました。

HTMLで書くように1つのファイルに全部詰め込む書き方に慣れていたので、パーツごとに分ける感覚がピンとこなかったんですよね。

しかし、コンポーネント化とPropsのデータの渡し方さえ理解してしまえば、ボタンやカードなどの同じデザインを何度も使い回せるようになり、開発がぐっと楽しく効率的になります。この記事では、コンポーネントの作成手順からPropsの受け取り方まで分かりやすく解説します。

コンポーネントとは?画面をパーツごとに分ける仕組み

Reactにおける「コンポーネント」とは、画面を構成するボタン、ヘッダー、カードなどの部品(パーツ)のことです。

Reactの特徴でも紹介した通り、画面全体を大きな1つのコードとして書くのではなく、小さなパーツを組み合わせてページを作るのがReactの基本思想です。

コンポーネントの基本は、「JSX(JavaScriptを混ぜたHTML風の見た目)を返すJavaScriptの関数」です。

// シンプルな Button コンポーネントの例
function PrimaryButton() {
  return (
    <button className="btn-primary">
      送信する
    </button>
  );
}

コンポーネント名を決める際は、PrimaryButton のように先頭を大文字(パスカルケース)にするルールがあります。小文字から始めると、JSXの基本で解説した標準のHTMLタグ(<button> や <div> など)と区別がつかなくなってしまうためです。

コンポーネントを定義するときは、アロー関数 を使って書くことも多いです。

// アロー関数を使って書く場合
const PrimaryButton = () => {
  return <button className="btn-primary">送信する</button>;
};

Props(プロップス)とは?親から子へデータを渡す仕組み

コンポーネントを作ることでボタンなどのパーツを再利用できるようになりますが、全てのボタンに「送信する」と固定の文字が書いてあったら使いづらいですよね。

場所によって「登録する」「変更する」「削除する」と表示テキストや見た目を変化させたい場面が出てきます。

そこで登場するのが Props(Propertiesの略) です。Propsを使うと、「親コンポーネントから子コンポーネントへデータや設定を引き渡す」 ことができます。

HTMLの属性と同じ感覚でデータを渡す

親コンポーネントから子コンポーネントを呼び出す際、HTMLの属性を指定するようにデータを渡します。

// 親コンポーネント(App)
function App() {
  return (
    <div>
      {/* label という名前で文字列を渡す */}
      <PrimaryButton label="登録する" />
      <PrimaryButton label="変更する" />
      <PrimaryButton label="削除する" />
    </div>
  );
}

子コンポーネント側で Props を受け取る

渡されたデータは、子コンポーネントの関数の「第一引数」にオブジェクトの形でまとまって入ってきます。

// 子コンポーネント(PrimaryButton)
function PrimaryButton(props) {
  // props には { label: "登録する" } のようなオブジェクトが入っている
  return (
    <button className="btn-primary">
      {props.label}
    </button>
  );
}

これで、同じ見た目のボタンコンポーネントを使い回しながら、中身のテキストだけを自由に変えられるようになりました。

分割代入を使って Props をスッキリ受け取る

先ほどの例では props.label と書いて受け取っていましたが、実務やモダンなReact開発では 分割代入(Destructuring) を使って書くのが一般的です。

// 関数の引数の部分で直接 { label } と受け取る
function PrimaryButton({ label }) {
  return (
    <button className="btn-primary">
      {label}
    </button>
  );
}

引数のところで { label } と書くことで、props. を毎回打ち込む必要がなくなります。また、そのコンポーネントが「どんなデータを受け取って表示に使っているか」が引数を見ただけで分かるメリットもあります。

複数のPropsを渡す場合も、同様にカンマ区切りで受け取れます。

// 親側
<UserCard name="りあぴ" role="生徒会長" age={17} />

// 子側(引数でまとめて分割代入)
function UserCard({ name, role, age }) {
  return (
    <div className="card">
      <h3>{name}({age}歳)</h3>
      <p>役職: {role}</p>
    </div>
  );
}

デフォルト値(初期値)をセットしておく

もし親側からデータが渡されなかった(undefined になった)場合に備えて、デフォルト値を設定しておくことも可能です。

// role が渡されないときは '一般会員' が表示される
function UserCard({ name, role = '一般会員' }) {
  return (
    <div className="card">
      <h3>{name}</h3>
      <p>役職: {role}</p>
    </div>
  );
}

初心者が引っかかりやすい注意点:Propsは「読み取り専用」

Propsを扱う上で、1つ覚えておきたい基本ルールがあります。それは「受け取った子コンポーネント側でPropsの値を直接書き換えてはいけない」ということです。

// NGな例:子コンポーネントの中でPropsを書き換えようとする
function UserCard({ name }) {
  // 書き換えても親には伝わらず、画面の表示も変わらない
  name = '新しい名前';

  return <div>{name}</div>;
}

Reactのデータフローは「親から子へ」という一方向です。子コンポーネントの中でPropsの値を直接変更してしまうと、親側のデータと整合性が取れなくなり、画面の更新ルールが崩れてしまいます。

画面の操作やボタンクリックなどによって値を変更・保持したい場合は、Propsではなく useState などの「State(状態)」という機能を使います。

まとめ

  • コンポーネント: 画面の部品(パーツ)を関数として定義したもの。先頭は大文字で始める
  • Props(プロップス): 親コンポーネントから子コンポーネントへデータを引き渡す仕組み
  • 分割代入の活用: 関数の引数で { name, age } と受け取ることでコードが読みやすくなる
  • 読み取り専用: 受け取ったPropsの値を子側で直接書き換えてはいけない

コンポーネント分割とPropsの基本が分かると、Reactで画面を組み立てる楽しさが一気に広がります。まずはよく使うボタンやカードなどの小さなパーツからコンポーネント化を試してみるのがオススメです。

コメント

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