Day 12:JSXで会社紹介ページを作る
JSXは、JavaScriptの中にHTMLに似た書き方で画面の構造を記述できる構文です。Reactでは、コンポーネントが返す画面を表すためによく使われます。この日は、JavaScriptの値を表示する方法、className、JSXの基本ルール、Fragmentを学び、Next.jsで静的な会社紹介ページを作ります。(🔗 react.dev)
1. JSXとは
次のコードでは、JavaScriptの関数がJSXを返しています。
<em>// 会社の見出しを表示するコンポーネントです</em>
function CompanyHeading() {
<em>// HTMLに似た書き方で画面の内容を返します</em>
return <h1>会社紹介</h1>;
}JSXJSXはHTMLそのものではありません。見た目はHTMLに似ていますが、JavaScriptの中で使う構文なので、いくつかReact独自のルールがあります。たとえば、タグは閉じる、複数要素を返すときはひとつの親で囲む、CSSクラスはclassNameと書く、といったルールです。(🔗 react.dev)
2. JSXの中にJavaScriptを書く
JSXのタグの中で、JavaScriptの値を表示するには波かっこ{}を使います。
// 会社情報をJavaScriptのオブジェクトで用意します
const company = {
name: "サンプルテック",
message: "技術で、毎日の仕事を少し便利に。",
};
// 会社情報を表示するコンポーネントです
function CompanyMessage() {
// 波かっこの中でJavaScriptの値を参照します
return (
<section>
<h1>{company.name}</h1>
<p>{company.message}</p>
</section>
);
}JSX{company.name}の部分では、JavaScriptの変数や式を使っています。波かっこを使わずに<h1>company.name</h1>と書くと、変数の中身ではなくcompany.nameという文字が表示されます。
JSXの中で使えるもの
波かっこの中には、値を作るJavaScriptの式を書けます。たとえば、変数、計算、関数の呼び出しなどです。
// 営業開始年を用意します
const establishedYear = 2018;
// 現在の年を取得します
const currentYear = new Date().getFullYear();
// 会社の紹介文を表示するコンポーネントです
function CompanyHistory() {
// 計算結果をJSXに表示します
return <p>創業から約{currentYear - establishedYear}年です。</p>;
}JSXただし、波かっこの中に、if文やfor文のような文(statement)をそのまま書くことはできません。表示内容を条件で分ける方法は後で扱いますが、Day 12では「波かっこには値を作る式を書く」と覚えておきましょう。
JSXの属性にJavaScriptを使う
文字列をそのまま指定するときは引用符、JavaScriptの値を使うときは波かっこを使います。
// 会社ロゴのURLを変数に入れます
const logoPath = "/company-logo.png";
// 画像を表示するコンポーネントです
function CompanyLogo() {
// 文字列の代わりに変数の値をsrcへ渡します
return (
<img
src={logoPath}
alt="サンプルテックのロゴ"
className="company-logo"
/>
);
}JSXsrc={logoPath}は変数の値を渡します。一方、src="{logoPath}"と書くと、波かっこを含む文字列を渡すことになり、変数の値にはなりません。(🔗 react.dev)
3. classNameでCSSクラスを指定する
HTMLではCSSクラスをclassと書きますが、JSXではclassNameと書きます。
// company-titleというCSSクラスを指定します
function CompanyTitle() {
// classではなくclassNameを使います
return <h1 className="company-title">会社紹介</h1>;
}JSXclassNameには、通常の文字列もJavaScriptの値も指定できます。
// CSSクラス名を変数に入れます
const titleClass = "company-title";
// 変数に入れたクラス名を指定します
function CompanyTitle() {
// 波かっこでJavaScriptの値を渡します
return <h1 className={titleClass}>会社紹介</h1>;
}JSX4. JSXの基本ルール
複数の要素はひとつの親で囲む
コンポーネントから複数の要素を返すときは、ひとつの親要素でまとめます。
// sectionを親要素として、見出しと文章をまとめます
function CompanyIntroduction() {
// 複数の要素をsectionで囲んで返します
return (
<section>
<h2>私たちについて</h2>
<p>企業向けのWebサービスを開発しています。</p>
</section>
);
}JSX次のように、隣り合う要素をそのまま並べて返すことはできません。
// 注意:隣り合う複数の要素をそのまま返すことはできません
// return <h2>見出し</h2><p>文章</p>;JSXすべてのタグを閉じる
JSXでは、HTMLで省略できることがあるタグも、明示的に閉じます。単独で使うタグは/>で閉じます。
// imgタグとbrタグは、末尾にスラッシュを付けて閉じます
function OfficeImage() {
// altは画像の内容を説明する文字列です
return (
<div>
<img src="/office.png" alt="オフィスの様子" />
<br />
<span>働く環境</span>
</div>
);
}JSXJavaScript式を属性に渡す
属性にJavaScriptの値を渡す場合は、=の後に波かっこを書きます。
// 会社サイトのURLを用意します
const websiteUrl = "https://example.com";
// リンクを表示するコンポーネントです
function CompanyLink() {
// hrefへJavaScriptの値を渡します
return <a href={websiteUrl}>公式サイト</a>;
}JSXJSX内のコメント
JSXの外側では通常のJavaScriptコメントが使えます。JSXのタグの中にコメントを書くときは、{/* ... */}の形にします。
// コンポーネントの外側に書く通常のJavaScriptコメントです
function Example() {
return (
<section>
{/* JSX内のコメントはこの形で書きます */}
<h2>事業内容</h2>
</section>
);
}JSX5. Fragmentとは
親要素を追加せずに複数の要素をまとめたい場合は、Fragmentを使います。短い書き方は<>と</>です。Fragmentは画面上に余分なHTML要素を作らず、複数要素をひとまとまりとして返せます。(🔗 react.dev)
// Fragmentで見出しと段落をまとめます
function CompanySlogan() {
// 追加のdivを作らずに複数要素を返します
return (
<>
<h2>私たちの理念</h2>
<p>技術を活用し、よりよい働き方を支えます。</p>
</>
);
}JSXただし、画面上で意味のあるまとまりを作りたい場合は、<section>や<header>など適切なHTML要素を使うほうが伝わりやすいです。単に要素をグループ化するだけで、追加の要素が不要なときにFragmentを使います。
6. Next.jsのページを準備する
Day 11で作ったNext.jsプロジェクトを使います。App Routerの場合、ページファイルはapp/page.jsまたはsrc/app/page.jsです。どちらの構成かは、プロジェクトにあるフォルダーを確認してください。Next.jsでは、App Routerのpageファイルがルートに対応するページを定義します。(🔗 nextjs.org)
開発サーバーが止まっている場合は、プロジェクトのフォルダーで起動します。
# プロジェクトフォルダーで開発サーバーを起動します
npm run dev
7. 会社紹介ページのデータを作る
まず、表示する会社情報をオブジェクトにまとめます。実在企業の情報ではなく、学習用の架空データを使っています。
// ページで使う会社情報をまとめます
const company = {
name: "サンプルテック",
slogan: "技術で、毎日の仕事を少し便利に。",
description:
"サンプルテックは、企業の業務を支えるWebサービスを開発する架空の会社です。",
established: 2018,
location: "東京都",
contactEmail: "hello@example.com",
};
// 会社の事業内容を配列にまとめます
const services = [
"業務支援Webサービスの開発",
"Webサイト・業務画面の設計",
"導入後の運用サポート",
];JSX情報をオブジェクトや配列にまとめると、文章を変更したいときにデータの場所が分かりやすくなります。
8. 会社紹介ページをコンポーネントに分ける
会社紹介ページを、ヘッダー、会社概要、事業内容、連絡先の部品に分けます。app/page.jsまたはsrc/app/page.jsに、次のコードを書いてください。
// ページで使う会社情報をまとめます
const company = {
name: "サンプルテック",
slogan: "技術で、毎日の仕事を少し便利に。",
description:
"サンプルテックは、企業の業務を支えるWebサービスを開発する架空の会社です。",
established: 2018,
location: "東京都",
contactEmail: "hello@example.com",
};
// 会社の事業内容を配列にまとめます
const services = [
"業務支援Webサービスの開発",
"Webサイト・業務画面の設計",
"導入後の運用サポート",
];
// ページ上部の会社名とキャッチコピーを表示します
function CompanyHeader() {
// 会社情報をJSXに埋め込んで返します
return (
<header className="company-header">
<p className="company-label">COMPANY</p>
<h1>{company.name}</h1>
<p>{company.slogan}</p>
</header>
);
}
// 会社概要を表示します
function CompanyOverview() {
// 会社情報を見やすい一覧として返します
return (
<section className="company-section">
<h2>会社概要</h2>
<p>{company.description}</p>
<dl>
<dt>設立</dt>
<dd>{company.established}年</dd>
<dt>所在地</dt>
<dd>{company.location}</dd>
</dl>
</section>
);
}
// 事業内容を一覧表示します
function ServiceList() {
// 配列の各要素からli要素を作ります
return (
<section className="company-section">
<h2>事業内容</h2>
<ul>
{services.map((service) => (
// 各項目の文字列をkeyに指定します
<li key={service}>{service}</li>
))}
</ul>
</section>
);
}
// 問い合わせ先を表示します
function ContactSection() {
// メールアドレスをリンクとして表示します
return (
<section className="company-section">
<h2>お問い合わせ</h2>
<p>サービスについてのご質問はこちらへご連絡ください。</p>
<a href={`mailto:${company.contactEmail}`}>
{company.contactEmail}
</a>
</section>
);
}
// Next.jsの会社紹介ページです
export default function Page() {
// 各コンポーネントを組み合わせてページを作ります
return (
<main className="company-page">
<CompanyHeader />
{/* mainの中に、ページの内容をまとめます */}
<CompanyOverview />
<ServiceList />
<ContactSection />
<footer className="company-footer">
<p>
© {new Date().getFullYear()} {company.name}
</p>
</footer>
</main>
);
}JSXこの例では、会社名や所在地などをオブジェクトから表示し、事業内容は配列から一覧にしています。会社のデータを変えれば、ページの構造を大きく変えずに表示内容を変更できます。
9. map()とkeyで一覧を表示する
事業内容の一覧では、services.map()を使って各項目から<li>を作っています。配列から複数の要素を表示するとき、各要素にはkeyを指定します。keyは、Reactが一覧の各項目を区別するための目印です。
// サービス名の配列です
const services = ["Web開発", "設計支援", "運用サポート"];
// 配列からリストを作る例です
function ServiceList() {
return (
<ul>
{services.map((service) => (
// 今回は重複しないサービス名をkeyに使います
<li key={service}>{service}</li>
))}
</ul>
);
}JSX実際のアプリでデータにIDがある場合は、文字列や配列の位置より、そのIDをkeyに使うのが基本です。配列のインデックスをkeyにすると、追加や並べ替えの際に項目を正しく追跡しにくくなる場合があります。
10. classNameとCSSで見た目を整える
Next.jsでは、ページ専用のCSSをCSS Modulesで管理できます。page.jsと同じフォルダーにpage.module.cssを作成します。
/* ページ全体の幅、余白、文字の読みやすさを整えます */
.companyPage {
max-width: 800px;
margin: 0 auto;
padding: 32px 20px;
color: #243044;
font-family: sans-serif;
line-height: 1.7;
}
/* ページ上部を目立たせます */
.companyHeader {
padding: 32px;
background: #eef4ff;
border-radius: 12px;
}
/* 小さな見出しを整えます */
.companyLabel {
color: #4263a5;
font-size: 0.85rem;
font-weight: bold;
letter-spacing: 0.08em;
}
/* 各セクションの間隔を設定します */
.companySection {
margin-top: 24px;
padding: 20px;
border: 1px solid #d8deea;
border-radius: 10px;
}
/* 会社概要の項目名を強調します */
.companySection dt {
margin-top: 12px;
font-weight: bold;
}
/* フッターの文字を控えめにします */
.companyFooter {
margin-top: 32px;
color: #5b6472;
font-size: 0.9rem;
}
CSS Modulesを使うときは、page.jsで読み込み、classNameに指定します。次のようにページコードの先頭にimportを追加し、該当箇所を変更します。
// ページ専用のCSS Modulesを読み込みます
import styles from "./page.module.css";
// 会社紹介ページです
export default function Page() {
return (
// CSS Modulesのクラス名をclassNameに指定します
<main className={styles.companyPage}>
<header className={styles.companyHeader}>
<p className={styles.companyLabel}>COMPANY</p>
<h1>サンプルテック</h1>
<p>技術で、毎日の仕事を少し便利に。</p>
</header>
<section className={styles.companySection}>
<h2>会社概要</h2>
<p>企業の業務を支えるWebサービスを開発しています。</p>
</section>
<footer className={styles.companyFooter}>
<p>会社紹介ページ</p>
</footer>
</main>
);
}JSXCSS Modulesでは、JavaScriptから参照するクラス名はstyles.companyPageのように書きます。CSS側では.companyPageのように定義します。
11. Fragmentを会社ページで使う例
コンポーネントから複数要素を返したいものの、追加のdivやsectionが必要ない場合はFragmentを使えます。
// 会社名と所在地をまとめて返すコンポーネントです
function CompanyDetails() {
return (
// Fragmentは画面上に余分な要素を追加しません
<>
<h2>会社情報</h2>
<p>サンプルテック</p>
<p>東京都</p>
</>
);
}JSXページ内で意味のある区切りを作る場合は、sectionなどを使います。Fragmentは、HTML要素をむやみに増やさずに複数の要素をまとめたいときに使い分けます。
12. JSXでよくあるつまずき
- HTMLのつもりで
classと書く:JSXではclassNameを使います。 - タグを閉じ忘れる:
<p>には</p>、単独タグには/>を付けます。 - 複数の要素をそのまま返す:共通の親要素またはFragmentで囲みます。
- 波かっこを引用符で囲む:変数を使う属性は
src={imagePath}のように書きます。 - 配列から作った要素に
keyを付けない:各項目を識別できる値を指定します。 - JavaScriptの文を波かっこに直接書く:JSX内の波かっこには式を使います。複雑な処理は先に変数や関数に分けます。
エラーが出た場合は、閉じタグ、波かっこの対応、コンポーネント名、ファイルのimportパスを順に確認します。画面にエラーが表示されたら、ターミナルとブラウザーの開発者ツールも確認してください。
13. 練習用テンプレート
以下のテンプレートのTODOを埋め、架空の会社紹介ページを完成させてみましょう。
// 会社の情報をまとめます
const company = {
name: "TODO:会社名",
slogan: "TODO:キャッチコピー",
location: "TODO:所在地",
};
// 会社情報を表示するページです
export default function Page() {
// JSXを返します
return (
// TODO:ページ全体をmainで囲みます
<main className="company-page">
{/* TODO:会社名をh1に表示します */}
<h1>{company.name}</h1>
{/* TODO:キャッチコピーをpに表示します */}
<p>{company.slogan}</p>
{/* TODO:会社概要のsectionを作ります */}
<section className="company-section">
<h2>会社概要</h2>
{/* TODO:所在地を表示します */}
<p>{company.location}</p>
</section>
</main>
);
}JSX実在の会社情報を使う必要はありません。架空の会社を設定し、会社名、キャッチコピー、所在地を自分で考えてみてください。
14. Day 12のチェックリスト
- JSXがJavaScript内で画面の構造を記述する構文だと説明できます。
- 波かっこ
{}で、変数や式を表示できます。 - 文字列の属性とJavaScriptの値を渡す属性の書き分けができます。
- JSXでCSSクラスを指定するとき、
classNameを使えます。 - すべてのタグを閉じ、複数要素を親要素かFragmentで囲めます。
- Fragmentを使って、追加のHTML要素なしで複数要素をまとめられます。
- 配列の
map()から一覧を作り、各要素にkeyを指定できます。 - JSXのコメントを
{/* コメント */}の形で書けます。
JSXはHTMLに似ていますが、JavaScriptの中で使うため、タグの閉じ方や属性名などに独自のルールがあります。まずは「波かっこでJavaScriptの値を埋め込む」「複数要素は親要素かFragmentでまとめる」「CSSクラスはclassNameと書く」の3点を意識して、会社紹介ページを組み立ててみましょう。
