From dcfb172704f3afb68a30425029ec834be2883274 Mon Sep 17 00:00:00 2001 From: bt Date: Sat, 8 Jun 2024 13:22:19 -0400 Subject: More content porting, on-going markdown changes for lowdown support --- build/quick-dirty-theme-switcher/index.html | 106 ++++++++++++++++------------ 1 file changed, 62 insertions(+), 44 deletions(-) (limited to 'build/quick-dirty-theme-switcher') diff --git a/build/quick-dirty-theme-switcher/index.html b/build/quick-dirty-theme-switcher/index.html index f5ef834..818cecb 100644 --- a/build/quick-dirty-theme-switcher/index.html +++ b/build/quick-dirty-theme-switcher/index.html @@ -1,42 +1,52 @@ - + Quick and Dirty Theme Switcher - - + + +
-

Quick and Dirty Theme Switcher

+

Quick and Dirty Theme Switcher

+

2020-06-04

-

Update: This article is no longer relevant since my blog design has changed. I'm keeping this post up since it will still be useful for those wanting to implement a theme switcher on their own site.

-
-

I recently added a fairly straightforward color scheme (theme) switcher to my personal website. You can toggle this simple color switcher in the footer of the site to see it in action. In case anyone else had the desire to add such functionality to their own sites/projects, I figured I'd write up a quick post explaining how to do so. Let's get into it.

-

- Theme color scheme switcher -
My website color scheme switcher in action (direct link to image)
-

-

The HTML

-

First we need to include the “buttons” that will trigger the theme to switch based on which one is selected. (Note: you could always render these as options in a select element if you preferred that method)

-
<div class="color-select">
-    <button onclick="toggleDefaultTheme()"></button>
-    <button onclick="toggleSecondTheme()"></button>
-    <button onclick="toggleThirdTheme()"></button>
-</div>
+
+

Update: This article is no longer relevant since my blog design has changed. I’m keeping this post up since it will still be useful for those wanting to implement a theme switcher on their own site.

+ +
+ +

I recently added a fairly straightforward color scheme (theme) switcher to my personal website. You can toggle this simple color switcher in the footer of the site to see it in action. In case anyone else had the desire to add such functionality to their own sites/projects, I figured I’d write up a quick post explaining how to do so. Let’s get into it.

+ +

The HTML

+ +

First we need to include the “buttons” that will trigger the theme to switch based on which one is selected. (Note: you could always render these as options in a select element if you preferred that method)

+ +
<div class="color-select">
+    <button onclick="toggleDefaultTheme()"></button>
+    <button onclick="toggleSecondTheme()"></button>
+    <button onclick="toggleThirdTheme()"></button>
+</div>
 
-

That's it! Don't worry too much about the onclick parameter right now, we'll come back to that when adding our JavaScript. The only remaining item is adding a default theme class to our html element, like so:

-
<html class="theme-default">
+
+

That’s it! Don’t worry too much about the onclick parameter right now, we’ll come back to that when adding our JavaScript. The only remaining item is adding a default theme class to our html element, like so:

+ +
<html class="theme-default">
 
-

The CSS

+ +

The CSS

+

Next we need to style both the color-select buttons, along with the custom color schemes that will alter the entire website. We will start with the color schemes.

+

For these themes to swap seamlessly between each other, we will be setting our altering color sets as CSS variables:

+
.theme-default {
 --accent-color: #72f1b8;
 --font-color: #34294f;
@@ -57,7 +67,9 @@ body {
     color: var(--font-color);
 }
 
+

Finally, we style the user-facing color swatches:

+
.color-select button {
     -moz-appearance: none;
     appearance: none;
@@ -70,52 +82,58 @@ body {
     width: 20px;
 }
 
-/* Style each swatch to match the corresponding theme */
+/* Style each swatch to match the corresponding theme */
 .color-select button:nth-child(1) { background: #72f1b8; border-color: #34294f; }
 .color-select button:nth-child(2) { background: #FFBF00; border-color: #59316B; }
 .color-select button:nth-child(3) { background: #d9455f; border-color: #303960; }
 
-

The JavaScript

-

We need to have each color swatch button trigger it's corresponding theme and swap out the theme-default class that we have originally attached to the main html element. We also need to store what the user has selected into localStorage, so their choice persists when reloading or navigating to other pages.

-
// Set a given theme/color-scheme
+
+

The JavaScript

+ +

We need to have each color swatch button trigger it’s corresponding theme and swap out the theme-default class that we have originally attached to the main html element. We also need to store what the user has selected into localStorage, so their choice persists when reloading or navigating to other pages.

+ +
// Set a given theme/color-scheme
 function setTheme(themeName) {
-    localStorage.setItem('theme', themeName);
+    localStorage.setItem('theme', themeName);
     document.documentElement.className = themeName;
 }
 
-// Toggle between color themes
+// Toggle between color themes
 function toggleDefaultTheme() {
-    if (localStorage.getItem('theme') !== 'theme-default'){
-        setTheme('theme-default');
+    if (localStorage.getItem('theme') !== 'theme-default'){
+        setTheme('theme-default');
     }
 }
 function toggleSecondTheme() {
-    if (localStorage.getItem('theme') !== 'theme-second'){
-        setTheme('theme-second');
+    if (localStorage.getItem('theme') !== 'theme-second'){
+        setTheme('theme-second');
     }
 }
 function toggleThirdTheme() {
-    if (localStorage.getItem('theme') !== 'theme-third'){
-        setTheme('theme-third');
+    if (localStorage.getItem('theme') !== 'theme-third'){
+        setTheme('theme-third');
     }
 }
 
-// Immediately set the theme on initial load
+// Immediately set the theme on initial load
 (function () {
-    if (localStorage.getItem('theme') === 'theme-default') {
-        setTheme('theme-default');
+    if (localStorage.getItem('theme') === 'theme-default') {
+        setTheme('theme-default');
     }
-    if (localStorage.getItem('theme') === 'theme-second') {
-        setTheme('theme-second');
+    if (localStorage.getItem('theme') === 'theme-second') {
+        setTheme('theme-second');
     }
-    if (localStorage.getItem('theme') === 'theme-third') {
-        setTheme('theme-third');
+    if (localStorage.getItem('theme') === 'theme-third') {
+        setTheme('theme-third');
     }
 })();
 
-

And that's it! Now it just depends on how custom you want each individual theme style to be. The possibilities are endless!

-

Extra Improvements

-

You could improve this concept even further hiding the color-select item if the user has JavaScript disabled. For my needs, I felt it was a fine trade-off to keep the non-functioning color swatch pickers if JavaScript was disabled. However, your project/site might need better fallbacks.

+ +

And that’s it! Now it just depends on how custom you want each individual theme style to be. The possibilities are endless!

+ +

Extra Improvements

+ +

You could improve this concept even further hiding the color-select item if the user has JavaScript disabled. For my needs, I felt it was a fine trade-off to keep the non-functioning color swatch pickers if JavaScript was disabled. However, your project/site might need better fallbacks.