https://github.com/evelez7 created 
https://github.com/llvm/llvm-project/pull/181587

Also fixes a typo that caused some overflow issues even when there was no 
content to cause an overflow.

>From e64e2bc8f1c4fdf77a403f2a13cf2676f792536e Mon Sep 17 00:00:00 2001
From: Erick Velez <[email protected]>
Date: Fri, 13 Feb 2026 19:14:54 -0800
Subject: [PATCH] [clang-doc] Add button a toggle for light/dark theme

ALso fixes a typo that caused some overflow issues even when there was
no content to cause an overflow.
---
 .../clang-doc/assets/clang-doc-mustache.css   | 10 +++-
 .../clang-doc/assets/head-template.mustache   |  5 +-
 .../clang-doc/assets/navbar-template.mustache | 51 +++++++++++++++++++
 3 files changed, 63 insertions(+), 3 deletions(-)

diff --git a/clang-tools-extra/clang-doc/assets/clang-doc-mustache.css 
b/clang-tools-extra/clang-doc/assets/clang-doc-mustache.css
index 19fba2f9eae76..69d1dad6d4b67 100644
--- a/clang-tools-extra/clang-doc/assets/clang-doc-mustache.css
+++ b/clang-tools-extra/clang-doc/assets/clang-doc-mustache.css
@@ -1,7 +1,7 @@
 /* css for clang-doc mustache backend */
 @import 
"https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap";;
 
-*,*::before *::after {
+*,*::before, *::after {
     box-sizing:border-box
 }
 * {
@@ -88,6 +88,7 @@ html, body {
     margin: 0;
     padding: 0;
     width: 100%;
+    overflow-x: scroll;
 }
 
 .container {
@@ -179,6 +180,13 @@ header {
     justify-self:center
 }
 
+#theme-toggle {
+    grid-column: 3;
+    justify-self: end;
+    color: var(--text1);
+    border: none;
+}
+
 @media(max-width:768px) {
     .navbar__menu {
         flex-direction:column;
diff --git a/clang-tools-extra/clang-doc/assets/head-template.mustache 
b/clang-tools-extra/clang-doc/assets/head-template.mustache
index 2ee4823fb77c1..67fcfc565f2da 100644
--- a/clang-tools-extra/clang-doc/assets/head-template.mustache
+++ b/clang-tools-extra/clang-doc/assets/head-template.mustache
@@ -8,8 +8,9 @@
         <script src="{{.}}"></script>
     {{/Scripts}}
     {{! Highlight.js dependency for syntax highlighting }}
-    <link rel="stylesheet" 
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/default.min.css";
 media="(prefers-color-scheme: light)">
-    <link rel="stylesheet" 
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/dark.min.css";
 media="(prefers-color-scheme: dark)">
+    <link id="hljs-light-theme" rel="stylesheet" 
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/default.min.css";
 />
+    <link id="hljs-dark-theme" rel="stylesheet" 
href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/dark.min.css";
 />
+    <link rel="stylesheet" 
href="https://fonts.googleapis.com/css2?family=Material+Symbols+Rounded:opsz,wght,FILL,GRAD@24,400,0,0&icon_names=routine";
 />
     <script 
src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js";></script>
     <script 
src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/cpp.min.js";></script>
 </head>
diff --git a/clang-tools-extra/clang-doc/assets/navbar-template.mustache 
b/clang-tools-extra/clang-doc/assets/navbar-template.mustache
index 666a4c3e93739..810fccf919942 100644
--- a/clang-tools-extra/clang-doc/assets/navbar-template.mustache
+++ b/clang-tools-extra/clang-doc/assets/navbar-template.mustache
@@ -12,6 +12,7 @@
                 </li>
             </ul>
         </div>
+        <button id="theme-toggle"><span 
class="material-symbols-rounded">routine</span></button>
     </div>
     {{#HasContexts}}
     <div class="navbar-breadcrumb-container">
@@ -21,3 +22,53 @@
     </div>
     {{/HasContexts}}
 </nav>
+<script>
+    const root = document.documentElement;
+    const toggle = document.getElementById("theme-toggle");
+    const hlLight = document.getElementById("hljs-light-theme");
+    const hlDark = document.getElementById("hljs-dark-theme");
+
+    function changeHighlightJS(theme) {
+      if (theme === "dark") {
+        hlDark.disabled = false;
+        hlLight.disabled = true;
+      } else {
+        hlDark.disabled = true;
+        hlLight.disabled = false;
+      }
+    }
+
+    // Listen to system theme changes.
+    // If the user manually toggles the theme, the theme wont change according
+    // to system changes.
+    const themeQuery = window.matchMedia("(prefers-color-scheme: dark)");
+    themeQuery.addEventListener("change", (event) => {
+      if (savedTheme === null) {
+        return;
+      } else if (event.matches) {
+        changeHighlightJS("dark");
+      } else {
+        changeHighlightJS("light");
+      }
+    });
+
+    toggle.onclick = () => {
+      const currentTheme = root.getAttribute("color-scheme");
+      const next = currentTheme === "dark" ? "light" : "dark";
+      changeHighlightJS(next);
+      root.setAttribute("color-scheme", next);
+      localStorage.setItem("theme", next);
+    };
+
+    document.addEventListener("DOMContentLoaded", () => {
+      const savedTheme = localStorage.getItem("theme");
+      const currentTheme = root.getAttribute("color-scheme");
+      if (savedTheme !== null) {
+        root.setAttribute("color-scheme", savedTheme);
+        changeHighlightJS(savedTheme);
+      } else {
+        root.setAttribute("color-scheme", currentTheme);
+        changeHighlightJS(currentTheme);
+      }
+    });
+</script>

_______________________________________________
cfe-commits mailing list
[email protected]
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to