feat: add dark theme

docs_theme/nav.html

@@ -10,7 +10,7 @@
       <button
         type="button"
         id="search_modal_show"
-        class="btn btn-sm btn-secondary d-flex gap-1"
+        class="btn btn-sm btn-secondary d-flex align-items-center gap-1"
         href="#mkdocs_search_modal"
         data-bs-toggle="modal"
         data-bs-target="#mkdocs_search_modal"
@@ -34,7 +34,7 @@
       <a 
         {% if page.previous_page %}href="{{ page.previous_page.url|url }}"{% endif %}
         {% if not page.previous_page %}disabled{% endif %}
-        class="btn btn-sm btn-secondary d-flex gap-1"
+        class="btn btn-sm btn-secondary d-flex align-items-center gap-1"
       >
       <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-arrow-left" viewBox="0 0 16 16">
         <path fill-rule="evenodd" d="M15 8a.5.5 0 0 0-.5-.5H2.707l3.147-3.146a.5.5 0 1 0-.708-.708l-4 4a.5.5 0 0 0 0 .708l4 4a.5.5 0 0 0 .708-.708L2.707 8.5H14.5A.5.5 0 0 0 15 8"/>
@@ -47,7 +47,7 @@
       <a
         {% if page.next_page %}href="{{ page.next_page.url|url }}"{% endif %}
         {% if not page.next_page %}disabled{% endif %}
-        class="btn btn-sm btn-secondary d-flex gap-1"
+        class="btn btn-sm btn-secondary d-flex align-items-center gap-1"
       >
       <span class="d-none d-md-block">Next</span>
 
@@ -58,12 +58,77 @@
 
       <!-- prettier-ignore -->
       <a
-        class="btn btn-primary btn-sm"
+        class="btn btn-primary btn-sm d-flex align-items-center"
         href="https://github.com/encode/django-rest-framework/tree/master"
         >
         <span>Github</span>
         </a
       >
+
+      <div class="dropdown">
+        <button
+          class="btn btn-secondary dropdown-toggle d-flex align-items-center"
+          type="button"
+          data-bs-toggle="dropdown"
+          aria-expanded="false"
+          id="bd-theme"
+        >
+          <div class="theme-icon-active"></div>
+        </button>
+        <ul class="dropdown-menu" aria-labelledby="bd-theme-text">
+          <li>
+            <button class="dropdown-item" href="#" data-bs-theme-value="dark">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                width="16"
+                height="16"
+                fill="currentColor"
+                class="bi bi-moon-fill"
+                viewBox="0 0 16 16"
+              >
+                <path
+                  d="M6 .278a.77.77 0 0 1 .08.858 7.2 7.2 0 0 0-.878 3.46c0 4.021 3.278 7.277 7.318 7.277q.792-.001 1.533-.16a.79.79 0 0 1 .81.316.73.73 0 0 1-.031.893A8.35 8.35 0 0 1 8.344 16C3.734 16 0 12.286 0 7.71 0 4.266 2.114 1.312 5.124.06A.75.75 0 0 1 6 .278"
+                />
+              </svg>
+              <span>Dark</span>
+            </button>
+          </li>
+          <li>
+            <button class="dropdown-item" href="#" data-bs-theme-value="light">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                width="16"
+                height="16"
+                fill="currentColor"
+                class="bi bi-brightness-high-fill"
+                viewBox="0 0 16 16"
+              >
+                <path
+                  d="M12 8a4 4 0 1 1-8 0 4 4 0 0 1 8 0M8 0a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 0m0 13a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 13m8-5a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2a.5.5 0 0 1 .5.5M3 8a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2A.5.5 0 0 1 3 8m10.657-5.657a.5.5 0 0 1 0 .707l-1.414 1.415a.5.5 0 1 1-.707-.708l1.414-1.414a.5.5 0 0 1 .707 0m-9.193 9.193a.5.5 0 0 1 0 .707L3.05 13.657a.5.5 0 0 1-.707-.707l1.414-1.414a.5.5 0 0 1 .707 0m9.193 2.121a.5.5 0 0 1-.707 0l-1.414-1.414a.5.5 0 0 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .707M4.464 4.465a.5.5 0 0 1-.707 0L2.343 3.05a.5.5 0 1 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .708"
+                />
+              </svg>
+              <span> Light </span>
+            </button>
+          </li>
+          <li>
+            <button class="dropdown-item" href="#" data-bs-theme-value="auto">
+              <svg
+                xmlns="http://www.w3.org/2000/svg"
+                width="16"
+                height="16"
+                fill="currentColor"
+                class="bi bi-circle-half"
+                viewBox="0 0 16 16"
+              >
+                <path
+                  d="M8 15A7 7 0 1 0 8 1zm0 1A8 8 0 1 1 8 0a8 8 0 0 1 0 16"
+                />
+              </svg>
+              <span>Auto</span>
+            </button>
+          </li>
+        </ul>
+      </div>
     </div>
 
     <button

docs_theme/src/js/main.js

@@ -21,3 +21,84 @@ function setupPrettify() {
 }
 
 setupPrettify();
+
+const getStoredTheme = () => localStorage.getItem("theme");
+const setStoredTheme = (theme) => localStorage.setItem("theme", theme);
+
+const getPreferredTheme = () => {
+  const storedTheme = getStoredTheme();
+  if (storedTheme) {
+    return storedTheme;
+  }
+
+  return window.matchMedia("(prefers-color-scheme: dark)").matches
+    ? "dark"
+    : "light";
+};
+
+const setTheme = (theme) => {
+  if (theme === "auto") {
+    document.documentElement.setAttribute(
+      "data-bs-theme",
+      window.matchMedia("(prefers-color-scheme: dark)").matches
+        ? "dark"
+        : "light"
+    );
+  } else {
+    document.documentElement.setAttribute("data-bs-theme", theme);
+  }
+};
+
+setTheme(getPreferredTheme());
+
+const showActiveTheme = (theme, focus = false) => {
+  const themeSwitcher = document.querySelector("#bd-theme");
+
+  if (!themeSwitcher) {
+    return;
+  }
+
+  const activeThemeIcon = document.querySelector(".theme-icon-active");
+  const btnToActive = document.querySelector(
+    `[data-bs-theme-value="${theme}"]`
+  );
+  const svgOfActiveBtn = btnToActive.querySelector("svg").cloneNode(true);
+
+  document.querySelectorAll("[data-bs-theme-value]").forEach((element) => {
+    element.classList.remove("active");
+    element.setAttribute("aria-pressed", "false");
+  });
+
+  btnToActive.classList.add("active");
+  btnToActive.setAttribute("aria-pressed", "true");
+  activeThemeIcon.innerHTML = null;
+  activeThemeIcon.appendChild(svgOfActiveBtn);
+  const themeSwitcherLabel = `Toggle Theme (${btnToActive.dataset.bsThemeValue})`;
+  themeSwitcher.setAttribute("aria-label", themeSwitcherLabel);
+
+  if (focus) {
+    themeSwitcher.focus();
+  }
+};
+
+window
+  .matchMedia("(prefers-color-scheme: dark)")
+  .addEventListener("change", () => {
+    const storedTheme = getStoredTheme();
+    if (storedTheme !== "light" && storedTheme !== "dark") {
+      setTheme(getPreferredTheme());
+    }
+  });
+
+window.addEventListener("DOMContentLoaded", () => {
+  showActiveTheme(getPreferredTheme());
+
+  document.querySelectorAll("[data-bs-theme-value]").forEach((toggle) => {
+    toggle.addEventListener("click", () => {
+      const theme = toggle.getAttribute("data-bs-theme-value");
+      setStoredTheme(theme);
+      setTheme(theme);
+      showActiveTheme(theme, true);
+    });
+  });
+});