カテゴリ: React 更新日: 2026/01/11

ReactのPropsにデフォルト値を設定する方法を完全ガイド!初心者でもわかる型安全なProps管理

Propsにデフォルト値を設定する方法
Propsにデフォルト値を設定する方法

先生と生徒の会話形式で理解しよう

生徒

「ReactでPropsを渡さなかったときに、自動で値を入れる方法ってありますか?」

先生

「はい、それがデフォルト値を設定する方法です。Propsに値が渡されなかった場合に、あらかじめ決めた値を自動で使うことができます。」

生徒

「なるほど!例えばどういうときに使うんですか?」

先生

「たとえばボタンの色や文章が渡されなかった場合でも、見た目や動作が崩れないようにするために使います。実際のコードを見てみましょう!」

1. デフォルト値とは何か?

1. デフォルト値とは何か?
1. デフォルト値とは何か?

デフォルト値とは「もし何も渡されなかったときに使う標準の値」のことです。日常生活に例えると、自動販売機で飲み物を買うときに「カップがない場合は自動で紙コップが出てくる」という仕組みに似ています。ReactでもPropsに値が指定されなかったときに備えて、デフォルト値を設定しておくと便利です。

2. Propsにデフォルト値を設定する基本方法

2. Propsにデフォルト値を設定する基本方法
2. Propsにデフォルト値を設定する基本方法

React(TypeScript)では、Propsにデフォルト値を設定する方法はいくつかあります。最もシンプルなのは、コンポーネントの引数でデフォルト値を指定する書き方です。


type ButtonProps = {
  label?: string; // オプショナル
};

function Button({ label = "クリック" }: ButtonProps) {
  return <button>{label}</button>;
}

function App() {
  return (
    <div>
      <Button label="送信" />
      <Button />
    </div>
  );
}
(1つ目のボタンには「送信」と表示され、2つ目のボタンには「クリック」と表示されます)

3. デフォルト値を使うメリット

3. デフォルト値を使うメリット
3. デフォルト値を使うメリット

デフォルト値を設定することで、次のようなメリットがあります。

  • コードがシンプルになる:呼び出す側で毎回Propsを指定しなくてもよい。
  • 表示が崩れない:値が渡されなかったときでも、見た目が整う。
  • 初心者でも使いやすい:最低限のPropsだけで動作するので学習しやすい。

4. 複数のPropsにデフォルト値を設定する例

4. 複数のPropsにデフォルト値を設定する例
4. 複数のPropsにデフォルト値を設定する例

複数のPropsにデフォルト値を設定することもできます。たとえばボタンの色や大きさに標準の設定を与える場合です。


type ButtonProps = {
  label?: string;
  color?: string;
  size?: "small" | "medium" | "large";
};

function Button({ label = "ボタン", color = "blue", size = "medium" }: ButtonProps) {
  return (
    <button style={{ backgroundColor: color, fontSize: size === "large" ? "24px" : size === "small" ? "12px" : "16px" }}>
      {label}
    </button>
  );
}

function App() {
  return (
    <div>
      <Button label="保存" color="green" size="large" />
      <Button />
    </div>
  );
}
(1つ目のボタンは緑色で大きめに表示され、2つ目のボタンは青色の標準サイズで「ボタン」と表示されます)

5. デフォルト値と必須Propsの使い分け

5. デフォルト値と必須Propsの使い分け
5. デフォルト値と必須Propsの使い分け

すべてのPropsにデフォルト値を付ける必要はありません。たとえば「ユーザー名」のように必ず必要な情報は必須にすべきです。一方で「色」や「説明文」のように省略できるものにはデフォルト値を設定しておくと便利です。このように必須とオプショナルを上手に組み合わせることで、Reactのコンポーネントは使いやすくなります。

6. まとめてPropsを扱うときの注意点

6. まとめてPropsを扱うときの注意点
6. まとめてPropsを扱うときの注意点

Propsにデフォルト値を設定するときは、記述場所や書き方に注意しましょう。特にオブジェクトや配列のPropsにデフォルト値を付ける場合は、コンポーネントの外で定義した定数を使うと良いです。これにより毎回新しいインスタンスを作らず、パフォーマンスを保ちながら安全に利用できます。

カテゴリの一覧へ
新着記事
New1
React
Reactのフォーム入力を再利用しよう!初心者でもわかるフィールドコンポーネント化の考え方
New2
React
Reactでできること一覧!初心者でもわかるWebアプリ・スマホアプリ・PWAの活用方法
New3
React
React.jsが人気な理由!VueやAngularとの違いを初心者向けに徹底比較
New4
Next.js
Next.js×StorybookでUI開発環境を整える方法!初心者でもわかるNext.jsの環境構築
人気記事
No.1
Java&Spring記事人気No1
React
Reactでキーボードイベントを活用する方法!onKeyDown, onKeyUp, onKeyPressを初心者向けに解説
No.2
Java&Spring記事人気No2
React
ReactのPresentational Componentを完全ガイド!初心者でもわかるStateを持たないコンポーネントの特徴
No.3
Java&Spring記事人気No3
React
Reactでフォーカスイベントを制御する方法!onFocusとonBlurを初心者向けに解説
No.4
Java&Spring記事人気No4
React
ViteでReact開発環境を構築する手順を完全ガイド!初心者でもできるReactの環境構築
No.5
Java&Spring記事人気No5
React
Reactとは?初心者でもわかるReact.jsの基本概念と特徴をやさしく解説
No.6
Java&Spring記事人気No6
Next.js
Next.js Server Componentsのメリット・デメリットを完全解説!初心者でもわかるNext.jsの基本
No.7
Java&Spring記事人気No7
React
Reactのカードコンポーネントを汎用的に設計する方法!初心者でもわかる再利用の考え方
No.8
Java&Spring記事人気No8
React
ReactとTypeScriptの環境構築をやさしく解説!Viteとtsconfigの設定も丁寧に紹介