Creating a Dark Theme Slider For Your Website with HTML, CSS, JavaScript, and Local Storage
The JavaScript Today blog was without a dark theme for awhile. We promised ourselves we would focus on creating content before developing new features on the site. Well, we hit our goal of 100 articles awhile back, so we’ve been doing some development work on the site, including introducing a dark theme toggler.
In this article, we’re going to show you how to create one for your own website as well. We’ll use Vanilla JavaScript, HTML, some CSS, and LocalStorage.
P.S. We’d love your feedback. Let us know what you think in the comment section below. Have a suggestion? Please do share! :D
Creating the toggle element
Before we write any JavaScript, we need some element on the DOM (Document Object Model) to actually target. In our case, that’s going to be a <input> element with a type attribute set to checkbox, and a class and id with the same.
We’re also going to make use of the Fontawesome CDN, in order to use the sun and moon icons within our toggler. We included it within the <head></head> tags down below.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Dark Theme Toggle</title>
<link
rel="stylesheet"
href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css"
integrity="sha512-DTOQO9RWCH3ppGqcWaEA1BIZOC6xxalwEsw9c2QQeAIftl+Vegovlnee1c9QX4TctnWMn13TZye+giMm8e2LwA=="
crossorigin="anonymous"
referrerpolicy="no-referrer"
/>
</head>
<body>
<div class="dark-mode-toggle">
<input type="checkbox" class="checkbox" id="checkbox" />
<label for="checkbox" class="checkbox-label">
<i class="fas fa-moon"></i>
<i class="fas fa-sun"></i>
<span class="ball"></span>
</label>
</div>
</body>
</html>
Now we have the structure of the toggler. It should look something like this:
So, we know our icons have been properly imported, and the HTML is being rendered as it should be (for now). Of course this simple checkbox could work, although obviously that would be a hideous thing to have on a modern website.
That’s where CSS comes in. Now, we’re not going to explain every line of CSS, as that would be tedious. Rather, we’re going to simply observe the changes being applied to the HTML. Let’s add the CSS!
💡 If your CSS skills are lacking, consider: CSS in Depth by Keith J. Grant. It covers the box model, grid layout, flexbox, and much more.
Once again, within the <head></head> tags, add the following code:
<head>
<style>
.checkbox {
opacity: 0;
position: absolute;
}
.checkbox-label {
background-color: #333;
width: 50px;
height: 26px;
border-radius: 50px;
position: relative;
padding: 5px;
cursor: pointer;
display: flex;
justify-content: space-between;
align-items: center;
}
.fa-moon {
color: #f6f1d5;
}
.fa-sun {
color: #f39c12;
}
.checkbox-label .ball {
background-color: #fff;
width: 30px;
height: 30px;
position: absolute;
left: 2px;
top: 2px;
border-radius: 50%;
transition: transform 0.2s linear;
}
.checkbox:checked + .checkbox-label .ball {
transform: translateX(24px);
}
.dark-theme {
background-color: #555;
}
</style>
</head>
After applying the CSS, our toggler should now look like this:
A huge improvement over the previous image, we now have a little toggler with the sun and moon icons. However, the toggler doesn’t actually do anything useful yet, it just switches from side-to-side. Well, we want to dim the lights, eh? We’re going to need to finalize everything using JavaScript. Let’s get started working on the functionality.
First, we’ll need to add <script></script> tags, directly above the closing </body> tag, and add the following code:
<script>
const userPrefersDark = false;
function setThemePreference(prefersDark) {
if (prefersDark) {
document.body.classList.add("dark-theme");
} else {
document.body.classList.remove("dark-theme");
}
}
setThemePreference(userPrefersDark);
const checkbox = document.getElementById("checkbox");
checkbox.checked = userPrefersDark;
checkbox.addEventListener("change", (event) => {
const isDarkMode = event.target.checked;
setThemePreference(isDarkMode);
});
</script>
Okay, great! It works. Kind of. If we refresh the page, the dark theme is no longer active, it remains in its original state. That wouldn’t be very kind to your users. We have one more, final step: adding persistance with local storage.
Don’t fret, it’s extremely simple!
We’ll simply need to change the following lines of code to include the use of local storage. Let’s do that:
// const userPrefersDark = false;
const userPrefersDark = localStorage.getItem("theme") === "dark";
// Other code
checkbox.addEventListener("change", (event) => {
const isDarkMode = event.target.checked;
setThemePreference(isDarkMode);
// Add the line below
localStorage.setItem("theme", isDarkMode ? "dark" : "light");
});
Full code on GitHub
Conclusion
Congratulations! You’ve now got a pretty neat theme toggler button. Although, admittedly, it could use some styling work. You’ll also need to figure out how to include it in your own projects, but that shouldn’t be too difficult. If you have questions, or need some help, always reach out in the comments below.
Happy coding!
Related Posts
Finding Free and Discounted Programming Books
As an avid reader, I’m always looking for places to find my next book. If they’re free, even better. Although it’s not always so easy finding them, there are plenty available online.
Read more
Getting Started with Google Cloud
In this article, we’re going to be taking a first look at Google Cloud, a leading player in the world of cloud computing, offers services and tools designed to drive innovation and ease operations.
Read more
The Great JavaScript Debate: To Semicolon or Not?
Since I’ve started learning this language, JavaScript has undergone some heavy changes. Most notably, it seems to be the norm to not use semicolons anymore.
Read more