feat: support responsive TOC

This commit is contained in:
Erzbir
2025-08-03 18:42:03 +08:00
parent db9a246e7b
commit b796ea9e46
3 changed files with 229 additions and 49 deletions
+113 -30
View File
@@ -1,21 +1,48 @@
import tocbot from "tocbot";
async function generateToc() {
const toc = document.querySelector(".toc");
let toc_icon = "☰"
let toc_close_icon = "✕"
function toggleToc() {
const toc = document.getElementById("toc");
if (!toc) return;
const toc_toggle = document.getElementById("toc-toggle");
if (!toc_toggle) return;
const isVisible = toc.classList.contains('toc-visible');
if (isVisible) {
toc.classList.remove('toc-visible');
toc.classList.remove('toc-overflow-right');
toc_toggle.innerHTML = toc_icon;
toc_toggle.setAttribute('aria-label', 'Show Table of Contents');
} else {
toc.classList.add('toc-visible');
toc_toggle.innerHTML = toc_close_icon;
toc_toggle.setAttribute('aria-label', 'Hide Table of Contents');
}
void locateToc();
}
async function generateToc() {
const toc = document.getElementById("toc");
if (!toc) return;
const content = document.getElementById("content");
const titles = content.querySelectorAll("h1, h2, h3, h4");
if (!titles || titles.length === 0) {
toc.style.display = "none";
toc.remove();
return;
} else {
toc.style.display = "block";
}
if (typeof tocbot !== 'undefined') {
tocbot.destroy();
tocbot.init({
tocSelector: ".toc",
tocSelector: ".toc-content",
contentSelector: "#content",
headingSelector: "h1, h2, h3, h4",
extraListClasses: "toc-list",
@@ -25,21 +52,94 @@ async function generateToc() {
scrollSmooth: true,
});
}
setupTocVisibility();
setupToggleButton();
void locateToc();
}
async function locateToc() {
const toc = document.querySelector(".toc")
function setupTocVisibility() {
const toc = document.querySelector(".toc");
if (!toc) return;
const content = document.getElementById("content");
const contentRight = content.getBoundingClientRect().right;
if (toc && contentRight) {
toc.style.left = `${contentRight}px`;
toc.style.display = "block";
if (window.innerWidth <= 1400) {
toc.classList.remove('toc-visible');
} else {
toc.classList.add('toc-visible');
}
}
function setupToggleButton() {
const toc = document.getElementById("toc");
const toc_toggle = document.getElementById("toc-toggle");
const isVisible = toc.classList.contains('toc-visible');
toc_toggle.innerHTML = isVisible ? toc_close_icon : toc_icon;
toc_toggle.setAttribute('aria-label', isVisible ? 'Hide Table of Contents' : 'Show Table of Contents');
toc_toggle.addEventListener('click', toggleToc);
}
async function locateToc() {
const toc = document.getElementById("toc");
if (!toc) return;
const toc_toggle = document.getElementById("toc-toggle");
const content = document.getElementById("content");
const contentRect = content.getBoundingClientRect();
const contentRight = contentRect.right;
if (contentRight) {
let leftPosition = contentRight + 12;
const screenWidth = window.innerWidth;
const buttonWidth = toc_toggle.offsetWidth;
const tocWidth = toc.classList.contains('toc-visible') ? toc.offsetWidth : buttonWidth;
const maxLeft = screenWidth - tocWidth - 30;
leftPosition = Math.min(leftPosition, maxLeft);
leftPosition = Math.max(leftPosition, 30);
toc.style.left = `${leftPosition}px`;
if (toc.classList.contains('toc-visible')) {
const rightEdge = leftPosition + tocWidth;
if (rightEdge > window.innerWidth) {
toc.classList.add('toc-overflow-right');
} else {
toc.classList.remove('toc-overflow-right');
}
}
}
}
function handleResize() {
const toc = document.getElementById("toc");
if (!toc) return;
setupTocVisibility();
setupToggleButton();
void locateToc();
}
function debounce(func, wait) {
let timeout;
return function executedFunction(...args) {
const later = () => {
clearTimeout(timeout);
func(...args);
};
clearTimeout(timeout);
timeout = setTimeout(later, wait);
};
}
function destroyToc() {
const toc = document.querySelector(".toc")
const toc = document.getElementById("toc")
if (!toc) return;
toc.style.display = "none";
toc.remove();
@@ -50,25 +150,8 @@ function destroyToc() {
async function init_toc() {
void generateToc();
void locateToc();
window.addEventListener('resize', debounce(handleResize, 250));
let resizeTimer;
let isVisible = true;
document.addEventListener('visibilitychange', () => {
isVisible = !document.hidden;
});
window.addEventListener('resize', () => {
if (!isVisible) return;
clearTimeout(resizeTimer);
resizeTimer = setTimeout(() => {
requestAnimationFrame(() => {
locateToc();
});
}, 200);
});
}
function register_toc() {