LAB | DOM Memory Game
Introduction
We just learned how to use (Vanilla) JavaScript to manipulate DOM elements. Great! Let's practice a bit more and have fun while developing a game.
Do you remember that game called Memory that you used to play with the actual paper cards? To win, you needed to memorize the position of the paired card. Well, the logic of the game we will be building is the same.
- The game consists of an even number of cards (precisely, 24) with a specific image on one side and a generic blue background on the other side.
- Each image appears on two cards.
The game rules:
- When the game starts, all cards are turned face down.
- The player then flips over two cards, selecting them by clicking on them.
- If the selected two cards have the same image, they remain face up. Otherwise, the cards flip back over after a short time.
The goal of the game is to get all the cards flipped face-up in the least number of tries. That means that a lower number of attempts scores better.
Requirements
- Fork this repo.
- Clone this repo.
- Visit the "actions" tab in your fork, and enable workflows.
Submission
Upon completion, run the following commands:
$ git add .
$ git commit -m "Solved lab"
$ git push origin master
Create Pull Request so your TAs can check up your work.
Automated Tests
This lab includes an automated testing suite. For DOM-related labs, our automated tests should be seen as a secondary tool, that helps you to programmatically understand whether your solution is correct and allows the educational team to track your progress.
To run the automated tests, please, open your terminal, change directories into the root of the lab, and run npm install
to install the test runner. Now, you can run the npm run test:watch
command to run automated tests in watch mode. Open the resulting lab-solution.html
file with the "Live Server" VSCode extension to always see the most up-to-date test results.
Instructions
Iteration 1: Initial set up
First, you will do some routine work: we need to make sure that all files we need are connected to the file that is rendering cards in the browser.
The file that is rendering cards is actually index.html
, so we have to make sure that the styles and JS files are loading when we open the game in the browser:
- styles: don't forget to add the link to the CSS file in the
<head>
of your page, - the logic: take a look at the
js/index.js
andjs/memory.js
files. You already have one file for the logic and one file for the HTML/CSS interactions (DOM manipulation).
After connecting them properly, you should be able to see the board, the cards, and the score.
Iteration 2: Plan your game
In this iteration, you will work on the game logic. You can see this part, like defining the methods that will take care of the game logic. No visible result will be shown just yet, and we will make sure everything works properly just by printing everything in the console.
You should be working in the js/memory.js
file.
The game logic for this game is pretty simple:
- we need a
MemoryGame
class, - we need a method to shuffle cards,
- we need a method to compare cards, and
- we need a method to check if the game is finished.
Side note: We will make a single-player version of the game, which will simplify some of the logic.
Let's do this step by step.
MemoryGame
class
Iteration 2.1: The If you open js/memory.js
file, you will see that it is preset for you:
class MemoryGame {
constructor(cards) {
this.cards = cards;
// add the rest of the class properties here
}
shuffleCards() {
// ...
}
checkIfPair(card1, card2) {
// ...
}
checkIfFinished() {
// ...
}
}
- The
MemoryGame
class: we created aMemoryGame
class and, as we can see in its constructor, it will receive an array of cards as a parameter and set this array to athis.cards
property. - We also need a
this.pickedCards
array, where we will be storing the cards the user has clicked so we can compare them. - Finally, a
this.pairsClicked
andthis.pairsGuessed
properties where will be adding every time a user choose and guess a pair. Go ahead and add these to the constructor.
Iteration 2.2: The class methods
-
Create logic for the method
shuffleCards()
to shuffle the cards - every time you create a new game, the order of the cards should change.Hint: It would be a good idea to implement something like a Fisher-Yates Shuffle. If you struggle with this method, you can skip it for the moment and go back to it later.
-
When a user picks 2 cards, we will need to check if they are the same. Let's create logic for the method
checkIfPair()
, which will receive two parameters, the names of both cards selected by the user (example:'ironman'
and'batman'
). The method will add 1 to ourpairsClicked
property, and if the cards are the same also add 1 topairsGuessed
. It should returntrue
orfalse
depending on the result of comparing both cards.So, to summarize, we will have to update pairsClicked on every two open cards by a user - it doesn't matter if the cards are the same. If two cards that we are comparing are the same, then pairsGuessed gets updated with +1.
-
Finally, we need to make sure our game ends, and for that, we can add some logic to the
checkIfFinished()
method. Here we need to check if our propertypairsGuessed
has reached the numbers of pairs the game has.
The layout and the logic files
When the logic is down, you will move forward to js/index.js
and work on the interactions. What do we consider as interaction is what happens when the user clicks on the card:
-how do we get the movement/flipping sides effect,
- how we keep the cards showing images if they are found to be the same and -how do we make cards flip back to the blue background if the cards are not the same? All the time, keep in mind, we need to work only with two cards at the same time.
HTML/CSS Interactions
Think about the interactions your user and the game will have: basically, the user will click on elements of the page (cards) and receive some result - whether they guessed the pair or not.
- The first thing that is done for us - each card's information is dynamically filled in the tiles, and the board is pre-filled with cards for us. As we want this behavior to be triggered as soon as the page loads, we need to wrap it under a
load
event. This is also already done for us.
// js/index.js
window.addEventListener('load', (event) => {
// some code goes here
});
- The other important interaction is the click listener. On click on every single card, we can get some information about that specific card. This code snippet, which is also already provided for us, serves for that.
// js/index.js
// Bind the click event of each element to a function
document.querySelectorAll('.card').forEach((card) => {
card.addEventListener('click', () => {
// TODO: write some code here
console.log('Card clicked: ', card);
});
});
To flip a card, you can have multiple approaches. We will give you two possible ways (but you can find even more than that):
- Option 1: on click, add the class
turned
next to the classcard
to thediv
that represents each card - like in the following example:
<!-- Only display the back that is blue -->
<div class="card" data-card-name="ironman">
<div class="back" name="ironman.jpg"></div>
<div class="front" style="background: url(img/ironman.jpg) no-repeat"></div>
</div>
<!-- After flipping -->
<div class="card turned" data-card-name="ironman">
<div class="back" name="ironman.jpg"></div>
<div class="front" style="background: url(img/ironman.jpg) no-repeat"></div>
</div>
- Option 2: another alternative is to toggle the classes back and front when the user clicks on a card. For this functionality, the method
element.classList.toggle()
can be very helpful. This method receives a string as the first argument (the class to toggle). It can also receive a second optional argument with a boolean expression (in that case, the class is added when the expression is true, and removed when the expression is false):
/* one argument */
el.classList.toggle('foobar');
// if it doesn't have the class 'foobar' --> add the class 'foobar'
// if it already has the class 'foobar' --> remove the class 'foobar'
/* two arguments */
el.classList.toggle('abc', someBool);
// if someBool evaluates to true -> add the class 'abc'
// if someBool evaluates to false -> remove the class 'abc'
Now when you have cards flipping from back to front and vice versa, you have to make sure you call .checkIfPair(card1, card2)
method. If the two cards are the same, they should get class blocked, which is going to keep them flipped so we can see images.
Hint 1: The array of picked cards can't ever hold more than two cards.
Hint 2: Make sure you call checkIfFinished
method to check if the condition for the end of the game is true, and if so, you can just alert the end, or be more creative and add some text on the canvas - displaying You won!!!
Extra Resources
Happy coding! ๐