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>
);
}JSXCardを呼び出す側が渡した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>
);
}JSXfunction 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>
);
}JSX3つのカードは同じ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>
);
}JSXmap()は、配列の要素ごとに処理を行い、その結果から新しい配列を作ります。ここでは、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>
);
}JSXPropsを増やすと、コンポーネントをさまざまな情報に対応させられます。ただし、無関係な情報を何でも渡すのではなく、そのコンポーネントが表示するのに必要なデータだけを渡すと、役割が明確になります。
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>;
}JSXPropsを変更するような処理は書きません。
// 注意: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>
);
}JSX16. Day 14のチェックリスト
- Propsが親から子へ情報を渡す仕組みだと説明できます。
- コンポーネントを呼び出すときにPropsを指定できます。
- 子コンポーネントでPropsを受け取り、JSXに表示できます。
- 分割代入を使って、必要なPropsを引数から取り出せます。
- 同じCardコンポーネントに異なる情報を渡して再利用できます。
- 配列と
map()でカード一覧を作り、keyを指定できます。 childrenを使い、コンポーネントの内側に内容を渡せます。- Propsを子コンポーネントで直接変更しないことを理解しています。
Propsを使うと、コンポーネントの見た目と表示するデータを分けられます。共通のCardを一度作り、タイトルや説明などを親から渡せば、同じ部品を複数の内容に使えます。まずは「親がデータを用意する」「子がPropsとして受け取る」「子は受け取った値を表示する」という流れを身につけましょう。
