How to create refs in ReactJS?
Creating refs in ReactJS is very simple. Refs are generally used for the following purposes:
- Managing focus, text selection, or media playback.
- Triggering imperative animations.
- Integrating with third-party DOM libraries.
Note: You should avoid using refs for anything that can be done declaratively.
The following examples are based on only Functional-Components but you are free to use Class-Components as well.
Method 1: Using React.createRef(). It was introduced in React 16.3.
- Create a ref variable using React.createRef()
- Use the element’s ref attribute to attach the ref variable
Filename: App.js
Javascript
// Importing everything as React import * as React from "react" ;   const App = () => {   // Creating textInputRef variable   const textInputRef = React.createRef();     // This method will be used to focus textInput   const textInputFocusHandler = () => {     // Focusing input element     textInputRef.current.focus();   };     return (     <div>               { /** Attaching ref variable using element's ref attribute */ }       <input ref={textInputRef} type= "text"               placeholder= "Enter something" />         { /** Attaching textInputFocusHandler method to button click */ }       <button onClick={textInputFocusHandler}>              Click me to focus input       </button>     </div>   ); };   export default App; |
Method 2: Using useRef() hook.
- Create a ref variable using React.useRef()
- Use the element’s ref attribute to attach the ref variable
- The benefit of using useRef() over createRef() is that it’s handy for keeping any mutable value around similar to how you’d use instance fields in classes.
- useRef() also takes an initial value.
Filename: App.js
Javascript
// Importing everything as React import * as React from "react" ;   const App = () => {   // Creating textInputRef variable with initialValue "null"   const textInputRef = React.useRef( null );     // This method will be used to focus textInput   const textInputFocusHandler = () => {     // Focusing input element     textInputRef.current.focus();   };     return (     <div>               { /** Attaching ref variable using element's ref attribute */ }       <input ref={textInputRef} type= "text"               placeholder= "Enter something" />         { /** Attaching textInputFocusHandler method to button click */ }       <button onClick={textInputFocusHandler}>               Click me to focus input       </button>     </div>   ); };   export default App; |
Method 3: Using callback ref. This method was used prior to React 16.3. So if you are using React < 16.3 use this method.
Creating ref using this method is a bit different than the other two methods. Instead of passing a ref attribute created using createRef() or useRef() we pass a function. The function receives the React element or HTML DOM element as an argument, which can be used.
Filename: App.js
Javascript
// Importing everything as React import * as React from "react" ;   const App = () => {   // Creating and initializing textInputRef variable as null   let textInputRef = null ;     // Callback function that will set ref for input field   // Note: It can be used to set ref for any element   const setTextInputRef = (element) => {       textInputRef = element;   };     // This method will be used to focus textInput   const textInputFocusHandler = () => {       // If textInputRef is not null     // otherwise it will throw an error     if (textInputRef) {             // Focusing input element       textInputRef.focus();     }   };     return (     <div style={{ padding: 16 }}>       { /** Using setTextInputRef function so that        *  textInputRef can be set as ref for this input field        * */ }       <input         style={{ display: "block" }}         ref={setTextInputRef}         type= "text"         placeholder= "Enter something"       />         { /** Attaching textInputFocusHandler            method to button click */ }       <button onClick={textInputFocusHandler}>           Click me to focus input       </button>     </div>   ); };   export default App; |
Step to Run Application: Run the application using the following command from the root directory of the project:
npm start
Output: