Course contentsShow
← React
Lesson 2347 of 2,39651. TypeScript with React BasicsFree lesson

Cloning Children with ReactElement

Learn why React.cloneElement requires ReactElement and how to constrain children types for cloning scenarios.

Cloning Children with ReactElement

You'll learn why React.cloneElement requires a more specific type than ReactNode and how to constrain children for cloning scenarios.

When you need to clone a child element to add or modify props, you can't just accept any ReactNode—you need a ReactElement specifically. This is because React.cloneElement only works with actual JSX elements, not strings, numbers, fragments, or null values.

Why ReactElement, Not ReactNode?

ReactNode is too broad for cloning. It includes primitives like "hello" or 42, which can't be cloned. React.cloneElement expects a proper element with props it can manipulate.

interface ClonableWrapperProps {
  children: React.ReactElement; // Not ReactNode!
}

function ClonableWrapper({ children }: ClonableWrapperProps) {
  // Add a className to whatever child is passed
  return React.cloneElement(children, {
    className: 'wrapper-child'
  });
}

The Type Constraint Pattern

When your component needs to clone children, explicitly type children as ReactElement. This provides compile-time safety:

// This works
<ClonableWrapper>
  <div>Content</div>
</ClonableWrapper>

// TypeScript error: string is not ReactElement
<ClonableWrapper>
  Just text
</ClonableWrapper>

Think of it like needing a physical object to attach a sticker to—you can't attach a sticker to the idea of an object or to empty space. ReactElement ensures you have something concrete to modify.

When to Use This Pattern

Use ReactElement typing when your component will:

  • Clone children with React.cloneElement
  • Inject props into children
  • Wrap a single element (not multiple)

Key Takeaway: When cloning children with React.cloneElement, type them as ReactElement instead of ReactNode to ensure you receive an actual JSX element that can be cloned and modified.