How to declare initial state
To use the useState hook you will need to import it from React.
You can view the code sandbox for a more interactive way to follow and mess around with the code (recommended to fork and try out yourself): code sandbox.
Edit: I've also added how to edit/update the state using an input and a couple buttons. Found at the bottom of this post.
import React, {useState} from "react";
To keep track of the state, we need to call the useState hook with an initial value. Since useState returns an array we are able to destructure the current state value and a function that lets you update the state.
Here's what that looks like.
// variable name is up to you (state) // then name your function, the variable name but with "set" as a prefix (setState) const [state, setState] = useState([])
Creating the component
Let's start building a basic component. Here we will create the initial state to a basic component.
// import React and the useState hook import { useState } from "react"; import "./styles.css"; // component function function SimpleArrayOfObjectsComponent() { // set the initial state (an array with 1 object to start (this can be an empty object to start)) const [users, setUsers] = useState([ { id: 1, name: "Joe", type: "admin" } ]); export default SimpleArrayOfObjectsComponent;
Let's add a basic button to change the state and a spot in the DOM to see the state change.
// JSX we want to return return ( // parent div to hold the ul and li's <div className="App"> <ul> {/* map over the users array */} {users.map((user) => ( // display a <div> element with the user.name and user.type // parent element needs to have a unique key <div key={user.id}> <p>{user.name}</p> <p>{user.type}</p> </div> ))} </ul> <button onClick={handleAddNewUser}>Add user</button> </div> );
This is what we should have so far:
Creating component functionality
You will see we declared a function called "handleAddNewUser". That function doesn't exist yet. Lets create that.
// delcare the function function handleAddNewUser() { // it's important to not mutate state directly, so here we are creating a copy of the current state using the spread syntax const updateUsers = [ // copy the current users state ...users, // now you can add a new object to add to the array { // using the length of the array for a unique id id: users.length + 1, // adding a new user name name: "Steve", // with a type of member type: "member" } ]; // update the state to the updatedUsers setUsers(updateUsers); }
Click the "Add user" button and you will see a new list item added to the state:
Add edit functionality
Adding more state
// boolean state to know if we are editing (this will let us display const [isEditing, setIsEditing] = useState(false); // object state to set so we know which todo item we are editing const [currentUser, setCurrentUser] = useState({});
Edit functions to handle updating the state
// function to get the value of the edit input and set the new state function handleEditInputChange(e) { // set the new state value to what's currently in the edit input box setCurrentUser({ ...currentUser, name: e.target.value }); } // function to handle when the "Edit user name" button is clicked function handleEditClick(user) { // set isEditing to true setIsEditing(true); // update the state to the updatedUsers setCurrentUser({ ...user }); } function handleUpdateUser(id, updatedUser) { // here we are mapping over the users array - the idea is check if the user.id matches the id we pass into the function // if the id's match, use the second parameter to pass in the updated user object // otherwise just use old user const updatedObject = users.map((user) => user.id === id ? updatedUser : user ); // set editing to false because this function will be used inside an onSubmit function - which means the data was submited and we are no longer editing setIsEditing(false); // update the users state with the updated user setUsers(updatedObject); } function handleEditFormSubmit(e) { e.preventDefault(); // call the handleUpdateTodo function - passing the currentUser.id and the currentUser object as arguments handleUpdateUser(currentUser.id, currentUser); }
JSX update to have an input and form when isEditing is true
// JSX we want to return return ( // parent div to hold the ul and li's <div className="App"> {/* start - if the "edit user name" is clicked */} {currentUser.id && isEditing && ( <form onSubmit={handleEditFormSubmit}> <input name="editTodo" type="text" placeholder="Edit todo" value={currentUser.name} onChange={handleEditInputChange} /> <button type="submit">Update</button> <button onClick={() => setIsEditing(false)}>Cancel</button> </form> )} {/* end - edit form */} <button onClick={handleAddNewUser}>Add new user</button> <ul> {/* map over the users array */} {users.map((user) => ( // display a <div> element with the user.name and user.type // parent element needs to have a unique key <div key={user.id}> <p>{user.name}</p> <p>{user.type}</p> {!isEditing && ( <button onClick={() => handleEditClick(user)}> Edit user name </button> )} </div> ))} </ul> </div> ); }
This quick tutorial shows you how to setup basic state values using an array of objects and how you can return a new array state value.
Edit: I've also added how to edit/update the state using an input and a couple buttons.
Thanks for reading!
Top comments (2)
can you also add how to update? for example, steve decided to change his name to steven. how do you change the state? i think it will make this post more resourceful.
@mshowkat Thank you for the feedback! I agree this would make it more resourceful. I am adding it to the post today. There's a lot more you need to add to edit.