カテゴリ: 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でAxiosインターセプターの使い方を完全ガイド!初心者でもわかるリクエストとレスポンスの処理方法
New3
React
JSXの書き方!初心者でもわかるReactタグと属性の基本ルール解説
New4
React
ReactとDockerを使った開発環境構築の基本を徹底解説!初心者でもわかるReactとDockerの連携方法
人気記事
No.1
Java&Spring記事人気No1
React
ReactでonChangeイベントを使ってフォーム入力値を管理する方法を初心者向けに解説
No.2
Java&Spring記事人気No2
React
Reactのイベントハンドリングのアンチパターンまとめ!初心者でもわかる注意点
No.3
Java&Spring記事人気No3
React
ReactとTypeScriptの環境構築をやさしく解説!Viteとtsconfigの設定も丁寧に紹介
No.4
Java&Spring記事人気No4
React
Reactのカスタムフックの作り方を完全ガイド!再利用可能なロジックを切り出す仕組み
No.5
Java&Spring記事人気No5
React
ReactでFetch APIのローディング状態を管理する方法|初心者にもわかる解説
No.6
Java&Spring記事人気No6
React
ReactのuseStateとuseEffectでよくあるエラーと解決方法ガイド!初心者でもわかるReactフック
No.7
Java&Spring記事人気No7
React
create-react-appでReactプロジェクトを作成する手順を初心者向けに完全解説!
No.8
Java&Spring記事人気No8
React
Reactでファイルアップロードを実装する方法を解説!Fetch APIで画像やPDFを送る仕組みを初心者向けに紹介