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

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

Day 14:Propsでデータを受け渡す

Props(プロップス)は、親コンポーネントから子コンポーネントへ情報を渡す仕組みです。共通の見た目を持つカードを1つ作り、タイトルや説明などをPropsで渡せば、同じコンポーネントを異なる内容で何度も使えます。

この日は、Next.jsで再利用可能なCardコンポーネントを作ります。親コンポーネントからデータを渡し、子コンポーネントで表示する流れを練習しましょう。

1. Propsとは

たとえば、学習テーマのカードを複数表示したいとします。カードごとに別々のコンポーネントを作るのではなく、共通のCardを作り、表示内容だけを変えて使います。

  • 親コンポーネント:カードに渡すデータを用意します。
  • 子コンポーネント:受け取ったデータを画面に表示します。

Propsは、コンポーネントを呼び出すときに属性のような形で渡します。

// titleとdescriptionをCardコンポーネントに渡します
<Card
  title="Props"
  description="親から子へ情報を渡す仕組みです。"
/>
JSX

子コンポーネントは、受け取ったPropsを使って表示します。

2. Next.jsで作るファイル構成

Day 13で作ったNext.jsプロジェクトを使います。App Routerを使っている場合は、app/page.jsまたはsrc/app/page.jsがページのファイルです。

今回は次のようにファイルを分けます。

my-app/
├── app/
│   └── page.js
└── components/
    └── Card.js

srcフォルダーを使っている場合は、src/app/page.jsとsrc/components/Card.jsに置きます。どちらの構成でも、ページとcomponentsが同じ階層の中にある関係は同じです。

3. 最初の子コンポーネントを作る

まず、components/Card.jsを作ります。Propsを引数で受け取り、カードに表示します。

// titleとdescriptionをPropsとして受け取るCardコンポーネントです
export default function Card(props) {
  // props.titleとprops.descriptionを画面に表示します
  return (
    <article className="card">
      <h2>{props.title}</h2>
      <p>{props.description}</p>
    </article>
  );
}
JSX

Cardを呼び出す側が渡したtitleとdescriptionは、子コンポーネントのpropsオブジェクトに入ります。そのため、props.titleやprops.descriptionとして取り出せます。

4. 親コンポーネントからPropsを渡す

次に、app/page.jsを編集します。Cardを読み込み、必要なPropsを渡します。

// 別ファイルにあるCardコンポーネントを読み込みます
import Card from "../components/Card.js";

// ページ全体を表示するコンポーネントです
export default function Page() {
  // ページ内にCardを配置します
  return (
    <main>
      <h1>Reactの学習カード</h1>

      {/* titleとdescriptionをPropsとしてCardへ渡します */}
      <Card
        title="Props"
        description="親コンポーネントから子コンポーネントへ情報を渡します。"
      />
    </main>
  );
}
JSX

<Card title="Props" description="..." />のtitleとdescriptionがPropsです。Cardが子コンポーネント、Pageが親コンポーネントにあたります。

5. Propsを分割代入で受け取る

props.titleのように毎回書く代わりに、関数の引数で必要な値を取り出せます。この書き方を分割代入といいます。

// propsからtitleとdescriptionを直接取り出します
export default function Card({ title, description }) {
  // 取り出した値を表示します
  return (
    <article className="card">
      <h2>{title}</h2>
      <p>{description}</p>
    </article>
  );
}
JSX

function Card({ title, description })は、propsオブジェクトからtitleとdescriptionを取り出して使う書き方です。短く読みやすいため、Reactのコンポーネントでよく使われます。

6. Propsを変えてCardを再利用する

同じCardを複数回使い、それぞれ異なる内容を渡してみましょう。

// Cardコンポーネントを読み込みます
import Card from "../components/Card.js";

// 学習カードの一覧ページです
export default function Page() {
  // 複数のCardに異なるPropsを渡します
  return (
    <main>
      <h1>Reactの学習カード</h1>

      <Card
        title="Props"
        description="親から子へデータを渡す仕組みです。"
      />

      <Card
        title="再利用"
        description="同じコンポーネントを異なる内容で使えます。"
      />

      <Card
        title="コンポーネント"
        description="画面を役割ごとの部品に分けます。"
      />
    </main>
  );
}
JSX

3つのカードは同じCardコンポーネントから作られています。カードの構造は共通で、違うのは渡しているPropsだけです。共通部分を1か所にまとめておくと、カードの見た目を変更したいときもCard.jsを修正すれば済みます。

7. 配列とmap()でカードを作る

カードが増えてくると、ひとつずつ手作業で書くのは大変です。データを配列にまとめて、map()でCardを作る方法を使いましょう。

// Cardコンポーネントを読み込みます
import Card from "../components/Card.js";

// カードに表示するデータを配列で用意します
const topics = [
  {
    id: 1,
    title: "Props",
    description: "親から子へデータを渡す仕組みです。",
  },
  {
    id: 2,
    title: "再利用",
    description: "同じコンポーネントを異なる内容で使えます。",
  },
  {
    id: 3,
    title: "分割代入",
    description: "オブジェクトから必要な値を取り出せます。",
  },
];

// 学習カード一覧のページです
export default function Page() {
  return (
    <main>
      <h1>Reactの学習カード</h1>

      <div className="card-list">
        {topics.map((topic) => (
          // topicの情報をPropsとしてCardに渡します
          <Card
            key={topic.id}
            title={topic.title}
            description={topic.description}
          />
        ))}
      </div>
    </main>
  );
}
JSX

map()は、配列の要素ごとに処理を行い、その結果から新しい配列を作ります。ここでは、topicsの各データをCardに変換しています。

keyは、Reactが一覧の各項目を識別するために指定します。データにidがある場合は、今回のようにkey={topic.id}とするのが基本です。配列の順番を表すインデックスを使うより、データ固有のIDを使うほうが、項目の追加や並べ替えに対応しやすくなります。(🔗 react.dev)

8. CardのPropsを増やす

タイトル、説明に加えてカテゴリーも表示したい場合は、Propsを追加できます。

components/Card.jsを次のように変更します。

// title、description、categoryを受け取るCardコンポーネントです
export default function Card({ title, description, category }) {
  return (
    <article className="card">
      {/* カテゴリーを表示します */}
      <p className="card__category">{category}</p>

      {/* タイトルと説明を表示します */}
      <h2>{title}</h2>
      <p>{description}</p>
    </article>
  );
}
JSX

カードのデータにもcategoryを追加し、Propsとして渡します。

// Cardコンポーネントを読み込みます
import Card from "../components/Card.js";

// カードに表示するデータです
const topics = [
  {
    id: 1,
    title: "Props",
    description: "親から子へデータを渡す仕組みです。",
    category: "React基礎",
  },
  {
    id: 2,
    title: "再利用",
    description: "ひとつの部品を複数の場所で使います。",
    category: "設計",
  },
];

// 学習カード一覧を表示するページです
export default function Page() {
  return (
    <main>
      <h1>Reactの学習カード</h1>

      {topics.map((topic) => (
        // topicの各プロパティをCardへ渡します
        <Card
          key={topic.id}
          title={topic.title}
          description={topic.description}
          category={topic.category}
        />
      ))}
    </main>
  );
}
JSX

Propsを増やすと、コンポーネントをさまざまな情報に対応させられます。ただし、無関係な情報を何でも渡すのではなく、そのコンポーネントが表示するのに必要なデータだけを渡すと、役割が明確になります。

9. 省略値を設定する

Propsが渡されない場合の値を、分割代入のデフォルト値で設定できます。

// categoryが渡されない場合は、"未分類"と表示します
export default function Card({
  title,
  description,
  category = "未分類",
}) {
  return (
    <article className="card">
      <p>{category}</p>
      <h2>{title}</h2>
      <p>{description}</p>
    </article>
  );
}
JSX

デフォルト値は、Propsが省略された場合や値がundefinedの場合に使われます。呼び出す側がcategory={null}を渡した場合は、デフォルト値ではなくnullが渡る点に注意してください。

10. 子コンポーネントに内容を入れるchildren

コンポーネントの開始タグと終了タグの間に内容を書くと、子コンポーネントはその内容をchildrenというPropsで受け取れます。

// childrenとして渡された内容を枠の中に表示します
export default function Card({ title, children }) {
  return (
    <article className="card">
      <h2>{title}</h2>

      {/* 親から渡された内容をここに表示します */}
      <div className="card__content">{children}</div>
    </article>
  );
}
JSX

親コンポーネントでは、カード内に表示したい内容をタグの間に書きます。

// Cardの開始タグと終了タグの間に文章を渡します
<Card title="学習の進め方">
  <p>まず基本を理解し、短いコードで試してみましょう。</p>
</Card>
JSX

この例では、<p>がchildrenとしてCardに渡されます。カードの外側の枠を共通にしつつ、中身の構造を呼び出し側で変えたい場合に便利です。

11. Propsは変更しない

Propsは、親コンポーネントから子コンポーネントへ渡されるデータです。子コンポーネントの中でPropsを直接書き換えるのではなく、受け取った値を表示や計算に使います。ReactのPropsは、コンポーネント間でデータを渡すための入力と考えましょう。(🔗 react.dev)

// countを受け取って表示するコンポーネントです
function CountLabel({ count }) {
  // 受け取ったcountを表示します
  return <p>件数:{count}</p>;
}
JSX

Propsを変更するような処理は書きません。

// 注意:Propsを直接変更する考え方は避けます
// function CountLabel({ count }) {
//   count = count + 1;
//   return <p>{count}</p>;
// }
JSX

子コンポーネントから親のデータを変更したい場合は、後の学習で扱う状態管理やイベント用の関数を使います。Day 14では、まず「親から子へデータを渡して表示する」ことに集中しましょう。

12. PropsとHTML属性の違い

Propsは、コンポーネントに渡す情報を表す仕組みです。titleやdescriptionのような自分で決めた名前を使えます。

// titleとdescriptionはCard用のPropsです
<Card
  title="React"
  description="ユーザーインターフェースを作るライブラリです。"
/>
JSX

一方、classNameやidなどはHTML要素に対応する属性としても使われます。自作コンポーネントに渡すときは、子コンポーネントがそのPropsを受け取り、必要なHTML要素へ設定します。

13. ファイル分割の考え方

今回の例では、ページのデータとカードの見た目を分けています。

  • app/page.js:カードのデータを用意し、一覧を作ります。
  • components/Card.js:カード1件分の見た目を担当します。

役割を分けることで、表示デザインを変えるときはCard.js、表示データを変えるときはpage.jsを中心に修正できます。小さな練習では同じファイルに書いても構いませんが、コンポーネントを別の場所でも使いたくなったときは、独立したファイルに分けると整理しやすくなります。

14. よくあるつまずき

  • Propsを渡していない:呼び出し側にtitle={...}などの指定があるか確認します。
  • 名前が一致していない:titleを渡しているのに、子でnameを受け取っていないか確認します。
  • 文字列とJavaScriptの値を混同する:固定の文字列はtitle="Props"、変数の値はtitle={topic.title}と書きます。
  • コンポーネント名が小文字から始まる:自作コンポーネント名は大文字で始めます。
  • 一覧のkeyを忘れる:map()で作る要素に、安定したIDを指定します。
  • 子コンポーネントでPropsを書き換える:Propsは表示や計算に使い、直接変更しないようにします。

15. 練習用テンプレート

次のテンプレートを完成させ、プロフィールカードを複数表示してみましょう。

// title、name、roleを表示するプロフィールカードです
export default function ProfileCard({ title, name, role }) {
  return (
    <article className="profile-card">
      {/* TODO: titleを小さな見出しとして表示します */}

      {/* TODO: nameをh2に表示します */}

      {/* TODO: roleをpに表示します */}
    </article>
  );
}
JSX

呼び出し側の例です。必要に応じて配列にし、map()で複数のカードを作ってください。

// ProfileCardコンポーネントを読み込みます
import ProfileCard from "../components/ProfileCard.js";

// プロフィール情報を用意します
const people = [
  { id: 1, name: "さくら", role: "デザイナー" },
  { id: 2, name: "たろう", role: "エンジニア" },
];

// プロフィール一覧を表示するページです
export default function Page() {
  return (
    <main>
      <h1>チーム紹介</h1>

      {people.map((person) => (
        // 各メンバーの情報をPropsとして渡します
        <ProfileCard
          key={person.id}
          title="チームメンバー"
          name={person.name}
          role={person.role}
        />
      ))}
    </main>
  );
}
JSX

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

  • Propsが親から子へ情報を渡す仕組みだと説明できます。
  • コンポーネントを呼び出すときにPropsを指定できます。
  • 子コンポーネントでPropsを受け取り、JSXに表示できます。
  • 分割代入を使って、必要なPropsを引数から取り出せます。
  • 同じCardコンポーネントに異なる情報を渡して再利用できます。
  • 配列とmap()でカード一覧を作り、keyを指定できます。
  • childrenを使い、コンポーネントの内側に内容を渡せます。
  • Propsを子コンポーネントで直接変更しないことを理解しています。

Propsを使うと、コンポーネントの見た目と表示するデータを分けられます。共通のCardを一度作り、タイトルや説明などを親から渡せば、同じ部品を複数の内容に使えます。まずは「親がデータを用意する」「子がPropsとして受け取る」「子は受け取った値を表示する」という流れを身につけましょう。

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