This tutorial assumes knowledge of React state and lifecycle concepts. Before We Start the Tutorial We will be building a small game in this tutorial. This is a practical way of getting accustomed to building react functional components using hooks. We will be walking through each section of this tutorial along with the code snippets so that you can follow along as you build your game. This tutorial is divided into the following sections: will equip you with the starter code Setup for the Tutorial will delve into the basics of hooks with some history Overview will use the most common hook in React development Building the Game will extend the game to add a time limit Adding a Time Limit will discuss extensions and conclude Wrapping Up You can follow along till you build a basic version of the game to get an understanding of the hooks along with some hands-on. What Are We Building? In this tutorial, we’ll build an interactive hangman game using React hooks. Hangman is a classic game in which the player has to guess a word one letter at a time. You can to get comfortable with the game. play There are several rules that can be applied to the game to add more complexities, but we will be focussing on completing just the first iteration of the game. You are encouraged to experiment and extend this solution for more complex use cases suggested in the extensions section. Prerequisites We’ll assume you have used React before and are familiar with creating components, state management, and lifecycle methods. We are also using features from ES6 — arrow functions, const, let statements. You can check to understand what ES6 compiles to. Babel REPL Note, we are using hooks in this tutorial, since hooks have been introduced in React version 16.8, you would need to have 16.8 as the min. React version for this tutorial. Setup for the Tutorial Let’s get started. We want to first create a react app. We can either create it from scratch or use create-react-app to reduce boilerplate code. In this tutorial, we’ll be using . create-react-app npx create-react-app react-hangman
cd react-hangman
npm start The above snippet will create a React app with a simple App component. For this tutorial, we won’t be focussing on styling and testing the component, so let’s go ahead and delete the and files. Now we can simply edit the to include component. The is what we're going to focus on building in this tutorial. App.css App.test.js App.js Hangman Hangman.jsx React ; Hangman ; App = <Hangman /> App; //App.js import from 'react' import from './Hangman' const => () export default View the full code at this point Overview Now that you’re all set, let’s first get an overview of React hooks. What are React Hooks? Prior to 16.8, class components in React were used to manage state and had logic distributed across lifecycle methods. Functional components were used to extract out some common UI. With React hooks, you can now hook into your functional components state and logic that would earlier be spread across lifecycle methods. Related logic can now be in one place, instead of being split. Logic can also be shared across components by building custom hooks. Building the Game As part of the first iteration, we want a secret word to be displayed, let’s say we mask all the letters with __ and we need all alphabets A-Z to be listed so that the player can select a letter and if that letter is part of the secret word it will reveal itself. Let’s say the secret word is “HANGMAN”. Then the following expression should mask the secret word as: _ _ _ _ _ _ _ .split( ).fill( ).join( ) "HANGMAN" "" "_" " " Let’s start with a basic layout: React ; { word = ; alphabets = [ , , , , , , , , , , , , , , , , , , , , , , , , , ]; <p>{word.split("").fill("_").join(" ")}</p> <button key={index}>{alphabet}</button> } //Hangman.jsx import from 'react' export default ( ) function Hangman const "HANGMAN" const "A" "B" "C" "D" "E" "F" "G" "H" "I" "J" "K" "L" "M" "N" "O" "P" "Q" "R" "S" "T" "U" "V" "W" "X" "Y" "Z" return < > div {alphabets
            .map((alphabet, index) => )} </ > div At this state, if you click on the buttons no actions occur. Our next step would be to click on an alphabet and guess if the letter is a part of the word. If the letter is indeed a part of the word it would show up and if it isn’t it would not reveal itself. For this, we need to persist all the letters that are correctly guessed so that they are displayed as part of the secret word. Now we have a use case for persisting data across a component re-render. This calls for the need for the state. Let’s have a look at how we can infuse the state using the State hook in React. The State Hook We can use the state hook to inject state into functional components in React. This state will be preserved across re-renders of the component. The is a hook that we can use. The returns a pair having the current value for the state and a function that lets you set the state. In class components, we used to do something similar with . You can use multiple in a component for different values that need to be preserved. useState useState this.setState useState We need to persist for the Hangman component. Let’s use the hook. We modified the word to display __ for all letters not guessed yet. correctGuesses useState React, {useState} ; { word = ; alphabets = [ , , , , , , , , , , , , , , , , , , , , , , , , , ]; [correctGuesses, setCorrectGuesses] = useState([]) maskedWord = word.split( ).map( correctGuesses.includes(letter) ? letter : ).join( ); <p>{maskedWord}</p> <button key={index} onClick={() => {
                if (word.includes(alphabet)) {
                    setCorrectGuesses([...correctGuesses, alphabet])
                }
            }}>{alphabet}</button> <p>You won!</p> } import from 'react' export default ( ) function Hangman const "HANGMAN" const "A" "B" "C" "D" "E" "F" "G" "H" "I" "J" "K" "L" "M" "N" "O" "P" "Q" "R" "S" "T" "U" "V" "W" "X" "Y" "Z" const const '' => letter "_" " " return < > div {alphabets
            .map((alphabet, index) => )}
            {!maskedWord.includes("_") && } </ > div Adding a Time Limit Now that we have a fair working solution, let’s add some rules to this game. We’ll have a max time limit of 2 minutes for the word to be guessed, if the word is not guessed within 2 minutes, we’ll display “Game Over”. We will need to inject a timeout in this case. The timeout will affect the results of this game. Let’s look at the effect hook to understand how we can add the logic of this timeout inside our component. The Effect Hook The effect hook is another one of the most commonly used hooks in React. It takes in a function(effect) that runs when any one of its dependant variables is changed. The effect (short for side effect) hook, is used to manage any side effects on the component — manipulating DOM elements, fetching data, subscriptions, etc. In our case, we will use the to set a timeout. The runs by default for every component render unless we mention [] as its parameter, in which case it runs only during the first render of the component. useEffect useEffect React, { useEffect, useState } ; { word = .toUpperCase(); alphabets = [ , , , , , , , , , , , , , , , , , , , , , , , , , ]; [correctGuesses, setCorrectGuesses] = useState([]) [timeUp, setTimeUp] = useState( );

    useEffect( { timeout = setTimeout( {
            setTimeUp( );
        }, duration); clearTimeout(timeout);
    }, []) maskedWord = word.split( ).map( correctGuesses.includes(letter) ? letter : ).join( ); ( <p>{maskedWord}</p> <button key={index} onClick={() => {
                if (word.includes(alphabet)) {
                    setCorrectGuesses([...correctGuesses, alphabet])
                }
            }}>{alphabet}</button> <p>You lost!</p> <p>You won!</p> );
} import from 'react' export default ( ) function Hangman {duration = } 120000 const "Hangman" const "A" "B" "C" "D" "E" "F" "G" "H" "I" "J" "K" "L" "M" "N" "O" "P" "Q" "R" "S" "T" "U" "V" "W" "X" "Y" "Z" const const false => () const => () true return => () const '' => letter "_" " " return < > div {alphabets.map((alphabet, index) => )}
            {timeUp ? : 
            !maskedWord.includes("_") && } </ > div Notice how we are preserving the state of timeUp using . In the second parameter of we mention [], so the timeout is set only during the first render of Hangman. In the end, when the component unmounts since the game gets over, we clear up the effect, in . This can be used to unsubscribe, clear up resources used in the effect. useState useEffect return () => clearTimeout(timeout) Wrapping Up Congratulations! You have a hangman game that : Let’s you play hangman Has a time cap for you to guess We hope you’ve got a hang(pun intended) of the basic hooks. The tutorial was an attempt to get you started on react hooks. We would further encourage you to explore more hooks, eg. , , create your own custom hooks. etc. Check out a detailed explanation on hooks . useContext useHistory here There are a lot of rules that can be applied and the game can be further extended. It will be a good exercise for you to try your hand at these functional components using hooks. Max number of guesses allowed can be 6Display time left on the guesses on a list of words based on themes timerLimiting vowelsFetch You can find the complete source code for the game in repository. this Also published on Medium's meenakshi-dhanani

Tutorial: Building A Hangman Game With React Hooks

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Specifications over Spreadsheets

5 Best Fitness Games for Your New Years Resolution

5 Best Racing Games on the PS4

Barely Surviving as a Game Developer (While Steam Still Gets their Cut)

Browser-Based Games are Making a Comeback...Again

Why Build Games for Smart Assistants?

Specifications over Spreadsheets

5 Best Fitness Games for Your New Years Resolution

5 Best Racing Games on the PS4

Barely Surviving as a Game Developer (While Steam Still Gets their Cut)

Browser-Based Games are Making a Comeback...Again

Why Build Games for Smart Assistants?

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps