Day 13:コンポーネントを作る・分ける・再利用する
Reactでは、画面を小さな部品に分け、それらを組み合わせてページを作ります。この部品がコンポーネントです。今回は、Header、Sidebar、Main、Card、Footerを作り、Next.jsのページに組み立てます。
コンポーネントを分けると、画面のどの部分をどのファイルで管理しているか分かりやすくなります。また、同じ見た目の部品を何度も使い回せるようになります。(🔗 react.dev)
1. まずページを部品に分ける
作りたいページを、まず役割ごとに分けて考えます。今回は学習用のダッシュボードを作ることにします。
Header:ページ上部のタイトルや案内を表示します。Sidebar:ページ内のナビゲーションを表示します。Main:ページの主要な内容を表示します。Card:主要な内容をカード形式で表示します。複数回使います。Footer:ページ下部の情報を表示します。
コンポーネント名は大文字から始めます。Reactでは、Headerのように大文字で始まる名前を自作コンポーネントとして扱います。
2. コンポーネントのファイル構成を作る
Next.jsのApp Routerを使っている場合、ページはapp/page.jsまたはsrc/app/page.jsに置きます。今回はコンポーネントを別ファイルに分け、次の構成にします。
my-app/
├── app/
│ ├── page.js
│ └── page.module.css
└── components/
├── Header.js
├── Sidebar.js
├── Main.js
├── Card.js
└── Footer.js
プロジェクト作成時にsrcフォルダーを使っている場合は、次のような構成にします。
my-app/
├── src/
│ ├── app/
│ │ ├── page.js
│ │ └── page.module.css
│ └── components/
│ ├── Header.js
│ ├── Sidebar.js
│ ├── Main.js
│ ├── Card.js
│ └── Footer.js
componentsというフォルダー名は、画面の部品をまとめるためによく使われます。必須の名前ではありませんが、役割の分かる名前にしておくと、ファイルを探しやすくなります。
3. コンポーネントの基本形
コンポーネントは、画面の一部分を返すJavaScript関数です。
// Greetingというコンポーネントを定義します
export default function Greeting() {
// JSXで表示内容を返します
return <p>Reactのコンポーネントです。</p>;
}JSXこのコンポーネントは、別のファイルからimportして使えます。
// Greetingコンポーネントを読み込みます
import Greeting from "../components/Greeting.js";
// ページ内でコンポーネントを使います
export default function Page() {
// Greetingをタグのように配置します
return <Greeting />;
}JSXコンポーネントを作るときは、次の3点を意識します。
- その部品が何を表示するのかを決めます。
- 部品名を大文字から始めます。
- 別ファイルから使う場合は、
exportし、使う側でimportします。
4. Headerを作る
components/Header.jsを作成し、ページ上部の見出しを担当させます。
// ページ上部を表示するHeaderコンポーネントです
export default function Header() {
// header要素を使ってページの見出しを返します
return (
<header className="header">
<p className="header__eyebrow">LEARNING DASHBOARD</p>
<h1 className="header__title">学習ダッシュボード</h1>
<p className="header__description">
Reactのコンポーネントを組み合わせたページです。
</p>
</header>
);
}JSX<header>は、ページやセクションの見出し部分を表すHTML要素です。画面の役割に合ったHTML要素を選ぶと、コードの意味が伝わりやすくなります。
5. Sidebarを作る
components/Sidebar.jsを作成し、ページ内のリンクを表示します。
// ページ内ナビゲーションを表示するSidebarコンポーネントです
export default function Sidebar() {
// ナビゲーションを返します
return (
<aside className="sidebar">
<h2 className="sidebar__title">メニュー</h2>
<nav aria-label="ページ内メニュー">
<ul className="sidebar__list">
<li>
<a href="#overview">概要</a>
</li>
<li>
<a href="#topics">学習トピック</a>
</li>
<li>
<a href="#next-step">次のステップ</a>
</li>
</ul>
</nav>
</aside>
);
}JSX<aside>は、ページの主要な内容に関連する補足情報を表す要素です。<nav>はナビゲーションを表します。aria-labelをつけると、支援技術を利用する人にもナビゲーションの目的が分かりやすくなります。
6. Cardを作り、propsで内容を渡す
カードは、タイトルや説明文を表示する部品です。複数のカードで同じ見た目を使うため、内容をコンポーネント内に固定せず、propsで受け取るようにします。
components/Card.jsを作成します。
// titleとdescriptionを受け取って表示するCardコンポーネントです
export default function Card({ title, description }) {
// propsから受け取った情報をカードとして表示します
return (
<article className="card">
<h3 className="card__title">{title}</h3>
<p className="card__description">{description}</p>
</article>
);
}JSXCard({ title, description })では、コンポーネントに渡された情報を分割代入で取り出しています。propsは、親コンポーネントから子コンポーネントへ渡す情報です。
たとえば、次のように使います。
// タイトルと説明をCardに渡して表示します
<Card
title="コンポーネント"
description="画面を役割ごとの部品に分けます。"
/>JSXCardは受け取る内容が変わっても、同じ構造で表示できます。これがコンポーネントを再利用する基本です。
7. Mainを作り、カードを並べる
components/Main.jsを作成し、ページの主要な内容を担当させます。カードのデータは配列にまとめ、map()で繰り返し表示します。
// 再利用するCardコンポーネントを読み込みます
import Card from "./Card.js";
// 表示する学習トピックです
const topics = [
{
id: 1,
title: "コンポーネント",
description: "画面を役割ごとの部品に分けます。",
},
{
id: 2,
title: "再利用",
description: "同じ部品に異なる情報を渡して使います。",
},
{
id: 3,
title: "ファイル構成",
description: "役割に応じてコンポーネントを整理します。",
},
];
// ページの主要な内容を表示するMainコンポーネントです
export default function Main() {
// main要素と学習トピック一覧を返します
return (
<main className="main">
<section id="overview" className="main__section">
<h2>概要</h2>
<p>
コンポーネントを組み合わせて、役割の分かりやすいページを作ります。
</p>
</section>
<section id="topics" className="main__section">
<h2>学習トピック</h2>
<div className="card-grid">
{topics.map((topic) => (
// 配列からCardを作り、各項目を識別するkeyを指定します
<Card
key={topic.id}
title={topic.title}
description={topic.description}
/>
))}
</div>
</section>
<section id="next-step" className="main__section">
<h2>次のステップ</h2>
<p>
コンポーネントの基本を確認したら、propsや状態の学習へ進みます。
</p>
</section>
</main>
);
}JSXtopics.map()は、配列の各要素をCardに変換しています。各カードにkeyを指定するのは、Reactが一覧の項目を識別するためです。データにidがある場合は、配列の位置ではなく、そのidを使うのが基本です。(🔗 react.dev)
8. Footerを作る
components/Footer.jsを作成し、ページ下部に表示する内容をまとめます。
// ページ下部を表示するFooterコンポーネントです
export default function Footer() {
// footer要素を返します
return (
<footer className="footer">
<p>React基礎講座・Day 13</p>
</footer>
);
}JSX9. ページにすべての部品を組み立てる
最後に、app/page.jsまたはsrc/app/page.jsを編集します。各コンポーネントをimportし、必要な順番で配置します。
// 各ファイルからコンポーネントを読み込みます
import Header from "../components/Header.js";
import Sidebar from "../components/Sidebar.js";
import Main from "../components/Main.js";
import Footer from "../components/Footer.js";
// このファイルがページ全体を組み立てます
export default function Page() {
// ページの部品を組み合わせて返します
return (
<div className="page">
<Header />
<div className="page__body">
<Sidebar />
<Main />
</div>
<Footer />
</div>
);
}JSX上のパスは、appフォルダーとcomponentsフォルダーが同じ階層にある場合です。src/app/page.jsを使い、src/componentsに部品を置いた場合も同じ相対関係なので、このパスで読み込めます。
ページの構造は、次のようになります。
Page
├── Header
├── Sidebar
├── Main
│ └── Card(複数)
└── Footer
Pageが全体を組み立て、Mainが複数のCardを使っています。部品の親子関係を意識すると、どのコンポーネントがどの情報を担当するか分かりやすくなります。
10. CSSでレイアウトを整える
最低限の見た目を整えるには、プロジェクトのapp/globals.cssまたはsrc/app/globals.cssにCSSを追加します。既存のスタイルがある場合は、内容を確認してから必要なルールを追加してください。
/* ブラウザーごとの余白の違いを小さくします */
* {
box-sizing: border-box;
}
/* ページ全体の文字と背景を設定します */
body {
margin: 0;
color: #243044;
background: #f5f7fb;
font-family: sans-serif;
}
/* ページの幅と中央配置を設定します */
.page {
max-width: 1100px;
margin: 0 auto;
padding: 24px;
}
/* ヘッダーの見た目を設定します */
.header {
padding: 24px;
background: #ffffff;
border-radius: 12px;
}
/* ヘッダー上の小さなラベルを整えます */
.header__eyebrow {
color: #526aa3;
font-size: 0.8rem;
font-weight: bold;
}
/* サイドバーとメイン領域を横並びにします */
.page__body {
display: grid;
grid-template-columns: 220px 1fr;
gap: 24px;
margin-top: 24px;
}
/* サイドバーの背景と余白を設定します */
.sidebar {
padding: 20px;
background: #ffffff;
border-radius: 12px;
}
/* サイドバーのリストから余分な余白を調整します */
.sidebar__list {
display: grid;
gap: 12px;
padding-left: 20px;
}
/* メイン領域の各セクションを整えます */
.main__section {
margin-bottom: 24px;
padding: 20px;
background: #ffffff;
border-radius: 12px;
}
/* カードを画面幅に合わせて並べます */
.card-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
gap: 16px;
}
/* カードの枠と余白を設定します */
.card {
padding: 16px;
border: 1px solid #dce2ec;
border-radius: 10px;
}
/* フッターの余白と文字色を設定します */
.footer {
margin-top: 24px;
padding: 16px;
color: #5f6878;
text-align: center;
}
/* 画面が狭いときはサイドバーを上に置きます */
@media (max-width: 700px) {
.page__body {
grid-template-columns: 1fr;
}
}
この例では、Header.jsなどにclassName="header"を指定しています。CSS Modulesを使う構成に変更する場合は、クラスをstyles.headerのように指定する方法もあります。
11. ファイルを分ける基準
コンポーネントは、細かくすればするほどよいわけではありません。分割するときは、その部品に独立した役割があるか、再利用できそうか、ひとつのファイルが読みづらくなっていないかを考えます。
- ページ上部、ナビゲーション、カードのように役割が明確なら分けます。
- 同じ見た目や構造を何度も使うなら、再利用できるコンポーネントにします。
- 数行の単純な表示だけなら、無理に別ファイルへ分けなくても構いません。
- 親コンポーネントにはページの組み立て、子コンポーネントには各部分の表示を担当させます。
今回のCardは複数回使うため、独立したコンポーネントにしました。一方、ページ全体をまとめるPageは、部品を並べる役割を持っています。
12. よくあるつまずき
- コンポーネント名が小文字から始まる:自作コンポーネントは大文字から始めます。
- importのパスが違う:ファイルの場所と相対パスを確認します。
- default exportとnamed exportを混同する:今回の各ファイルはdefault exportなので、波かっこなしでimportします。
- 一覧の
keyを忘れる:配列から作る各要素に、安定した識別値を指定します。 - すべてを1つのファイルに詰め込む:役割ごとに分け、ページの組み立てと部品の表示を整理します。
- 逆に細かく分けすぎる:再利用性や見通しが向上するかを考えて分割します。
13. 練習用テンプレート
次のテンプレートを使い、Cardコンポーネントを完成させてみましょう。
// タイトルと説明を受け取るCardコンポーネントです
export default function Card({ title, description }) {
// カードとして表示するJSXを返します
return (
// TODO: article要素にclassName="card"を付けます
<article>
{/* TODO: titleをh3の中に表示します */}
{/* TODO: descriptionをpの中に表示します */}
</article>
);
}JSX完成したら、Mainから同じCardを複数回使い、異なるtitleとdescriptionを渡してみてください。見た目を変えずに内容だけ変えられれば、再利用の基本ができています。
14. Day 13のチェックリスト
- Reactコンポーネントを関数として作れます。
- コンポーネント名を大文字から始められます。
- 画面を役割ごとに分け、別ファイルからimportできます。
- propsで親コンポーネントから子コンポーネントへ情報を渡せます。
- 同じコンポーネントに異なる情報を渡して再利用できます。
- 配列の
map()でカード一覧を作り、keyを指定できます。 Header、Sidebar、Main、Card、Footerを組み合わせたページを作れます。
コンポーネント作りでは、ページをどの部品に分けるか、各部品が何を担当するかを先に考えると進めやすくなります。今回はPageで全体を組み立て、Mainから再利用可能なCardを表示しました。この構造を基礎に、次はpropsや状態を使って、データに応じて変化する画面へ進めます。
