A simple interactive dice app built with HTML, CSS, and JavaScript (using jQuery). This version is structured for use in VS Code with separate files for markup, styles, and behavior.
- 📁 Project Files
- 🧱 TODO 1: Create the Die Element
- 🧲 TODO 2: Import jQuery
- 🎯 TODO 3: Create a Dot with jQuery
- 🖱️ TODO 4: Make a Click Handler Function
- 🔁 TODO 5: Register a Click Event with jQuery
- 🎲 TODO 6: Generate a Random Number
- ⚪ TODO 7: Create a Dot Helper Function
- 🎯 TODO 8: Add Dots Based on the Random Number
- 🧹 TODO 9: Clear the Die Before Each Roll
- 🎯 TODO 10: Add the Final Dice Face (Six Dots)
- 🌟 Bonus Challenge
This mini-project uses three files:
index.html– Contains the structure of the dice appstyle.css– Defines the visual styling of the die and its componentsdice.js– Handles all dice functionality using jQuery
🎯 Goal: Set up the main structure of the page, including the die element and stylesheet connection.
-
In
index.html, inside the<body>, add a single die element:<div id="die"></div>
-
In the
<head>, link to your external CSS file:<link rel="stylesheet" href="style.css" />
-
Then, in
style.css, define the basic styles for the die:#die { height: 100px; width: 100px; background-color: lightgray; /* Feel free to customize */ position: relative; }
🎯 Goal: Set up jQuery to handle interactions with the die.
-
Still in the
<head>ofindex.html, include jQuery using a CDN:<script src="https://code.jquery.com/jquery-3.5.1.js"></script>
-
Just before the closing
</body>tag, link to your JavaScript file:<script src="dice.js"></script>
🎯 Goal: Use jQuery to create a dot inside the die element.
- In
dice.js, use the following code to create a single dot positioned in the center of the die:
$("<div>")
.css("height", 15)
.css("width", 15)
.css("background-color", "black")
.css("position", "absolute")
.css("top", 50)
.css("left", 50)
.appendTo("#die");- When you open
index.htmlin your browser, you should see:- A gray square representing the die (unless you changed the background color)
- A black dot in the center of the die
- If you don’t see the dot:
- Make sure jQuery is properly loaded
- Confirm that your
dice.jsfile is linked correctly - Confirm that your
style.cssfile is linked correctly - Check your file and folder names for typos
🎯 Goal: Create a function that logs a message when it runs, so you can test that it's connected correctly later.
-
In
dice.js, create a function calledrollDie(dieId), that will only log the word “clicked” to the console. -
Below
rollDie, create a function calledhandleClick, that will callrollDie("#die"). -
Just below the function, call
handleClick()directly to test it.
- Open your browser’s DevTools Console (
Right click → Inspect → Console) - You should see the word “clicked” printed once
- If nothing appears:
- Make sure
dice.jsis linked correctly inindex.html - Check for typos in your function name or
console.logstatement
- Make sure
🎯 Goal: Use jQuery to run your function whenever the die is clicked.
Replace your direct function call with this:
$("#die").on("click", handleClick);This tells the browser: “When the element with the ID die is clicked, run the handleClick function.”
- Open your page in the browser
- Click on the die square
- Each time you click, you should see “clicked” appear in the Console
- If it doesn’t work:
- Make sure your
#dieelement exists inindex.html - Double-check the ID and the function name
- Ensure jQuery is loaded before your script in
index.html
- Make sure your
🎯 Goal: Generate a new random number between 1 and 6 each time the die is clicked.
Now that your click handler is set up, it’s time to give it some functionality!
-
Inside the
rollDie()function, generate a random number:var randomNum = Math.ceil(Math.random() * 6); console.log(randomNum);
-
Remove the
console.log("clicked")line.
- Open the Console and click the die
- You should see a random number between 1 and 6 each time you click
- If it’s not working:
- Make sure you are now printing the random number inside your
rollDiefunction instead of"clicked" - Double-check the
Math.random()line for typos
- Make sure you are now printing the random number inside your
🎯 Goal: Enable the creation of dots on a die at a specific position.
Now let’s make the die show the right face by calling a helper function called makeDot.
-
First, define a new function above
rollDiecalledmakeDot. This function will handle creating and positioning a dot anywhere on the die. For this function, copy your code from TODO 3, but modify it to accept three parameters:top,left, andelementID.💡 Hint: Think about which values change every time you place a dot. Your function will need:
- One parameter for the top position
- One parameter for the left position
- One parameter for the element to append to
Use these parameters when setting the CSS properties and when calling
.appendTo().
-
Below the
makeDotfunction, call it three times with the following parameters:makeDot(50, 50, "#die"); // middle middle makeDot(25, 25, "#die"); // top left makeDot(75, 75, "#die"); // bottom right
-
You should see three dots appear on the die in the correct positions.
-
Delete the function calls after testing.
-
Copy and paste the following code inside your
rollDiefunction, after generating the random number:if (randomNum === 1) { makeDot(50, 50, dieID); // middle middle } else if (randomNum === 2) { makeDot(25, 25, dieID); // top left makeDot(75, 75, dieID); // bottom right } else if (randomNum === 3) { makeDot(25, 25, dieID); // top left makeDot(75, 75, dieID); // bottom right makeDot(50, 50, dieID); // middle middle } else if (randomNum === 4) { makeDot(75, 75, dieID); // bottom right makeDot(25, 25, dieID); // top left makeDot(25, 75, dieID); // bottom left makeDot(75, 25, dieID); // top right } else if (randomNum === 5) { makeDot(50, 50, dieID); // middle middle makeDot(75, 75, dieID); // bottom right makeDot(25, 25, dieID); // top left makeDot(25, 75, dieID); // bottom left makeDot(75, 25, dieID); // top right }
- Click the die multiple times to test different outcomes
- The dot patterns should update as you click, but will not erase the previous dots yet
- If it’s not working:
- Double-check your
makeDotfunction definition - Make sure that you are using the parameters correctly in the
makeDotfunction
- Double-check your
🎯 Goal: Prevent new dots from piling up by clearing the die before each roll.
Each time the die is clicked, it should start fresh. To do that, just clear the contents of the die element at the beginning of the rollDie function.
-
At the very top of your
rollDiefunction, add:$(dieID).empty();
This removes all existing dots inside the die before drawing new ones.
- Click the die a few times
- You should only ever see the number of dots for the current roll—no leftover dots from before
- If dots seem to be multiplying:
- Make sure
.empty()is at the top of yourrollDiefunction - Confirm the selector is correct:
#die
- Make sure
🎯 Goal: Complete the random roll logic by handling the final case: when the number is 6.
You’ve got the dot patterns for numbers 1 through 5—now it’s time to finish it off by adding one more else if block for when randomNum === 6.
💡 Hint: Think about how six dots are arranged on a real die. You’ll want to use three pairs of dots, evenly spaced vertically. You can also reference the image below if needed.
Make sure to use your makeDot function and append the new dots to #die.
- Click the die until you see six dots
- Make sure they’re evenly spaced and visually consistent with the other faces
- If something’s off:
- Double-check your coordinates
- Make sure you’re appending to the correct element
- Look for typos in your conditional structure
🎯 Goal: Add a second die that can roll independently from the first.
Once you’ve got one die working, try adding a second! You’ll need to update your HTML and CSS to include another div for the second die, and you’ll need to call your rollDie function twice—once for each die.
💡 Hint: Your
rollDieandmakeDotfunctions already take an element ID as a parameter. This makes them reusable! Try callingrollDie("#die2")when the second die is clicked, just like you did with the first.
Get creative! You could even:
- Display the total of both dice
- Color each die differently
- Style them to look more like real dice