forwardRef

In React, managing ref with React.forwardRef works similarly but integrates seamlessly with modern React features. The key advantage of forwardRef is that it lets you directly pass refs to child components, making them easier to manage without adding unnecessary complexity.

Here’s an explanation of using ref in React <19 with React.forwardRef and just ref with React 19+.


React.forwardRef with React 18.

Why Forward Refs?

In React, a ref assigned to a component points to the instance of the component (for class components) or null (for functional components). To access a DOM element inside a functional component, we need to forward the ref to the DOM element.


Basic Example: Managing an Input's Ref

Child Component Using forwardRef

import React, { forwardRef } from "react";

const Input = forwardRef((props, ref) => {
  return <input {...props} ref={ref} />;
});

export default Input;
  • forwardRef ensures the parent can pass a ref to the internal input element.
  • The ref is passed as the second argument to the functional component.

Parent Component Using the Ref

import React, { useRef } from "react";
import Input from "./Input";

const Parent = () => {
  const inputRef = useRef();

  const focusInput = () => {
    inputRef.current.focus();
  };

  return (
    <div>
      <h1>Using forwardRef with React 18+</h1>
      <Input ref={inputRef} placeholder="Type something..." />
      <button onClick={focusInput}>Focus the Input</button>
    </div>
  );
};

export default Parent;

How It Works

  1. Input Component:
    • Wraps the DOM <input> in React.forwardRef.
    • Exposes the DOM input element to the parent component.
  2. Parent Component:
    • Creates a ref using useRef.
    • Passes the ref to the Input component.
    • Calls DOM methods (e.g., .focus()) on the ref.

Simplified Ref Handling in React 19

In modern React, you do not have to use forwardRef at all and just pass the ref as one of the props:

Example: Direct Ref on DOM Element

import React from "react";

const Input = ({ ref, ...props }) => {
  return <input {...props} ref={ref} />;
});

export default Input;

When forwardRef Is Needed

Use forwardRef only if:

  1. You wrap a DOM element in a custom component and need to expose the DOM element to the parent.
  2. The component should remain reusable with internal DOM access.

Key Takeaways

  • Use ref directly for DOM elements where possible.
  • Use forwardRef when building custom components that wrap DOM elements but still need to expose them.
  • React 19 simplifies the API but retains compatibility with forwardRef for advanced scenarios.

Let me know if you'd like further details or a more advanced example! 🚀

Slides


The purpose of forwardRef is that it lets you directly pass refs to child components, making them easier to manage without adding unnecessary complexity.


forwardRef ensures the parent can pass a ref to the internal input element. If we did not use the forwardRef, the component would not know which DOM element you meant to reference and pass to the parent. With forwardRef, the ref is passed as the second argument to the functional component.


Therefore, we first wrap our custom component with forwarRef


And then expose the DOM input element to the parent component through the ref parameter.


Then, in the Parent component we create a ref using useRef ...


... and then pass the ref to our Input component.


With the ref in place, we can use it to focus the input element in the click event handler in the parent component!


With React 19, things got simpler and you no longer need to use forwardRef, but pass the ref as on of the props.


Therefore, your custom component no longer needs to be wrapped with forwardRef and ref is just one of the props.


Consider these takeaways


Use ref directly for DOM elements where possible.


Use forwardRef when building custom components that wrap DOM elements but still need to expose them.


React 19 simplifies the API but retains compatibility with forwardRef for advanced scenarios.