本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2023年5月20日(土)更新: 2026年11月9日(月)約8分で読めます

Reactコンポーネントでchildrenに対してpropsを渡す

Reactで子コンポーネントにpropsを渡す2つの方法を紹介します。レガシーなcloneElement APIと、推奨されるrender propパターンの違いを解説します。

はじめに

childrenとして任意のコンポーネントを受け取る親コンポーネントから、子コンポーネントにpropsを渡したいことがあります。

tsx
import { FC, PropsWithChildren } from 'react';

const ParentComponent: FC<PropsWithChildren> = ({
  children,
}) => (
  <div>
    {/* childrenにonClick等のpropsを親から付与したい */}
    {children}
  </div>
);

この記事では、これを実現する2つの方法を紹介します。

cloneElement

最初に紹介する方法はcloneElementです。cloneElementは対象のReactElementを複製する際に、第2引数でpropsを上書きできます。 子コンポーネントにonClickを付与する例は以下のようになります。

tsx
import { cloneElement, FC, isValidElement, PropsWithChildren } from 'react';

const ParentComponent: FC<PropsWithChildren> = ({ children }) => {
  const cloneChildren = cloneElement(
    isValidElement(children) ? children : <button>{children}</button>,
    {
      onClick: () => alert('親から付与されたclickイベントです。'),
    }
  );

  return <div>{cloneChildren}</div>;
};

cloneElementの第1引数はReactElementを渡したいので、ReactNodeからisValidElementを用いてReactElementを抽出しました。 childrenがReactElementではなかった場合はbutton要素で囲んだものを渡すようにしています。

第2引数には上書きしたいpropsをオブジェクトで渡します。上書きされるのは第2引数に渡したキーだけで、childrenが元々持っていたほかのpropsは残ります。ただし、childrenがonClickを持っていた場合、そのonClickは親のonClickに置き換わって呼ばれなくなります。 子のonClickも呼びたい場合は、isValidElementの型引数でpropsの型を決め、親のonClickの中から子のonClickを呼びます。

tsx
const onClick = () => alert('親から付与されたclickイベントです。');
const cloneChildren = isValidElement<{ onClick?: () => void }>(children)
  ? cloneElement(children, {
      onClick: () => {
        // 子のonClickも呼ぶ
        children.props.onClick?.();
        onClick();
      },
    })
  : <button onClick={onClick}>{children}</button>;

@types/react 19のisValidElementは、型引数を省くとpropsの型がunknownになります。...children.propsのように広げると、Spread types may only be created from object types.という型エラーになります。

Slotで隠蔽する

cloneElementはレガシーAPIですが、Radix Primitivesが提供するSlotコンポーネントを使うことで、アプリケーションコードから直接呼び出すことを避けられます。

Slotは内部でcloneElementを使用していますが、より宣言的なAPIを提供します。

tsx
import { Slot } from '@radix-ui/react-slot';
import { FC, PropsWithChildren } from 'react';

const ParentComponent: FC<PropsWithChildren> = ({ children }) => {
  return (
    <Slot onClick={() => alert('親から付与されたclickイベントです。')}>
      {children}
    </Slot>
  );
};

Slotは子要素に自身のpropsをマージして渡します。これにより、cloneElementを直接使用するよりも可読性が高いコードを書けます。

render propパターン

続いてはrender propパターンと呼ばれるpropsを利用した実装です。 親コンポーネントはrenderItemという関数をpropsとして受け取り、渡したいpropsを引数にしてその関数を呼び出します。

tsx
import { FC, ReactElement } from 'react';

type Props = {
  renderItem: (props: { onClick: () => void }) => ReactElement;
};

const ParentComponent: FC<Props> = ({ renderItem }) => {
  return (
    <div>
      {renderItem({
        onClick: () => alert('親から付与されたclickイベントです。'),
      })}
    </div>
  );
};

renderItemはpropsを引数に取り、ReactElementを返す関数です。利用側は受け取ったpropsを要素に適用して返します。

tsx
<ParentComponent
  renderItem={(props) => (
    <button {...props}>
      親コンポーネントから渡ってきたonClickを付与したbutton要素
    </button>
  )}
/>

この方法では指定したいpropsを子コンポーネント側に明示的に渡せることや子コンポーネントの実装を自身でハンドリングできるところに利点があります。

おわりに

この記事では、childrenにpropsを渡す方法としてcloneElementとrender propパターンを紹介しました。

cloneElementはレガシーAPIのため、新しく実装するなら、型安全で明示的なrender propパターンをおすすめします。childrenを受け取る形を保ちたいときは、cloneElementを直接使用せずに@radix-ui/react-slotのSlotで隠蔽してください。