Add menu icon to toggle TOC on small viewports

Author: weavejester

bb.edn

@@ -12,7 +12,8 @@
                              "site/index.html" "build/index.html"
                              "site/style.css"  "build/style.css"
                              "docs/style.css"  "build/docs/style.css"
-                             "docs/reset.css"  "build/docs/reset.css"}]
+                             "docs/reset.css"  "build/docs/reset.css"
+                             "docs/ui.js"      "build/docs/ui.js"}]
            (fs/copy src dest {:replace-existing true}))}
   build
   {:depends [docstrings files]

docs/docinfo.html

@@ -1,5 +1,6 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&family=Bebas+Neue&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&family=Open+Sans:ital,wght@0,300..800;1,300..800&display=swap" rel="stylesheet">
-<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/7.0.1/css/solid.min.css" integrity="sha512-EHa6vH03/Ty92WahM0/tet1Qicl76zihDCkBnFhN3kFGQkC+mc86d7V+6y2ypiLbk3h0beZAGdUpzfMcb06cMg==" crossorigin="anonymous" referrerpolicy="no-referrer">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/7.0.1/css/all.min.css" integrity="sha512-2SwdPD6INVrV/lHTZbO2nodKhrnDdJK9/kg2XD1r9uGqPo1cUbujc+IYdlYdEErWNu69gVcYgdxlmVmzTWnetw==" crossorigin="anonymous" referrerpolicy="no-referrer" />
 <link href="style.css" rel="stylesheet">
+<script src="ui.js"></script>

docs/style.css

@@ -64,6 +64,10 @@ body {
   color: #93dd56;
 }
 
+#header .menu-icon {
+  display: none;
+}
+
 #content {
   margin: 0 auto;
   max-width: 55rem;
@@ -114,9 +118,9 @@ body {
   }
 
   #header {
-    width: 100%;
+    width: auto;
+    right: 0;
     height: 44px;
-    overflow: hidden;
     border-right: none;
     border-bottom: #404040 1px solid;
   }
@@ -127,12 +131,42 @@ body {
     font-size: 30px;
     margin: 0;
     padding-top: 2px;
+    width: 100px;
   }
 
   #header h1 a {
     padding-left: 44px;
   }
 
+  #header .menu-icon {
+    font-family: FontAwesome;
+    font-style: normal;
+    font-weight: normal;
+    font-size: 24px;
+    color: white;
+    display: block;
+    float: right;
+    margin: 5px 10px 0 0;
+  }
+
+  #header .menu-icon:before {
+    content: '\f0c9';
+  }
+
+  #header.is-open {
+    height: auto;
+  }
+
+  #header.is-open #toc {
+    display: block;
+    height: 100%;
+    overflow: scroll;
+  }
+
+  #header.is-open .menu-icon:before {
+    content: '\f00d';
+  }
+
   #content {
     margin-top: 44px;
   }
@@ -263,7 +297,6 @@ kbd {
 }
 
 .concise-index {
-  width: 36em;
   margin-bottom: 1rem;
 }
 
@@ -276,7 +309,7 @@ kbd {
 }
 
 .concise-index ul {
-  columns: 2;
+  column-width: 13rem;
   column-gap: 1rem;
   margin: 0;
   padding: 0;

docs/ui.js

@@ -0,0 +1,10 @@
+document.addEventListener('DOMContentLoaded', () => {
+    const header = document.querySelector('#header');
+    const icon   = document.createElement('i');
+    icon.className = 'menu-icon';
+    header.prepend(icon);
+
+    icon.addEventListener('click', () => {
+      header.classList.toggle('is-open');
+    });
+});