// Populate the sidebar
//
// This is a script, and not included directly in the page, to control the total size of the book.
// The TOC contains an entry for each page, so if each page includes a copy of the TOC,
// the total size of the page becomes O(n**2).
class MDBookSidebarScrollbox extends HTMLElement {
constructor() {
super();
}
connectedCallback() {
// Modify TOC to support external links
var toc = '{{#toc}}{{/toc}}';
// Handle both old mdbook (
) and new mdbook 0.5 (
) formats
// External links open in new tab with external link icon
toc = toc.replace(/<(div|span)>([^$<>]*)\$\$external:([^$<>]*)\$\$<\/(div|span)>/g, '$2 ↗')
this.innerHTML = toc
// Set the current, active page, and reveal it if it's hidden
let current_page = document.location.href.toString();
if (current_page.endsWith("/")) {
current_page += "index.html";
}
var links = Array.prototype.slice.call(this.querySelectorAll("a"));
var l = links.length;
for (var i = 0; i < l; ++i) {
var link = links[i];
var href = link.getAttribute("href");
if (href && !href.startsWith("#") && !/^(?:[a-z+]+:)?\/\//.test(href)) {
link.href = path_to_root + href;
}
// The "index" page is supposed to alias the first chapter in the book.
if (link.href === current_page || (i === 0 && path_to_root === "" && current_page.endsWith("/index.html"))) {
link.classList.add("active");
var parent = link.parentElement;
if (parent && parent.classList.contains("chapter-item")) {
parent.classList.add("expanded");
}
while (parent) {
if (parent.tagName === "LI" && parent.classList.contains("chapter-item")) {
parent.classList.add("expanded");
}
parent = parent.parentElement;
}
}
}
updateChapterNavigation(links);
// Track and set sidebar scroll position
this.addEventListener('click', function(e) {
if (e.target.tagName === 'A') {
sessionStorage.setItem('sidebar-scroll', this.scrollTop);
}
}, { passive: true });
var sidebarScrollTop = sessionStorage.getItem('sidebar-scroll');
sessionStorage.removeItem('sidebar-scroll');
if (sidebarScrollTop) {
// preserve sidebar scroll position when navigating via links within sidebar
this.scrollTop = sidebarScrollTop;
} else {
// scroll sidebar to current active section when navigating via "next/previous chapter" buttons
var activeSection = document.querySelector('#sidebar .active');
if (activeSection) {
activeSection.scrollIntoView({ block: 'center' });
}
}
// Toggle buttons (delegate to avoid navigation)
var sidebarRoot = document.getElementById('sidebar');
if (sidebarRoot) {
sidebarRoot.addEventListener('click', function (ev) {
var toggle = ev.target.closest('a.chapter-fold-toggle');
if (!toggle) { return; }
ev.preventDefault();
ev.stopPropagation();
var parentLi = toggle.closest('li.chapter-item');
if (parentLi) {
parentLi.classList.toggle('expanded');
}
}, true);
sidebarRoot.addEventListener('pointerdown', function (ev) {
var toggle = ev.target.closest('a.chapter-fold-toggle');
if (!toggle) { return; }
ev.preventDefault();
ev.stopPropagation();
}, true);
}
}
}
window.customElements.define("mdbook-sidebar-scrollbox", MDBookSidebarScrollbox);
function normalizeChapterUrl(url) {
try {
var normalized = new URL(url, document.location.href);
normalized.hash = "";
normalized.search = "";
if (normalized.pathname.endsWith("/")) {
normalized.pathname += "index.html";
}
return normalized.href;
} catch (_) {
return "";
}
}
function setChapterNavigationLink(selector, chapter) {
var link = document.querySelector(selector);
if (!link) {
return;
}
if (!chapter) {
link.hidden = true;
link.removeAttribute("href");
return;
}
link.href = chapter.href;
link.hidden = false;
var label = link.querySelector(".chapter-nav-label") || link.querySelector("span");
if (label) {
label.textContent = chapter.title;
}
}
function updateChapterNavigation(links) {
var current = normalizeChapterUrl(document.location.href);
var seen = Object.create(null);
var chapters = [];
links.forEach(function (link) {
var rawHref = link.getAttribute("href");
if (!rawHref || rawHref.startsWith("#") || link.classList.contains("external-link")) {
return;
}
var url;
try {
url = new URL(link.href, document.location.href);
} catch (_) {
return;
}
if (url.origin !== document.location.origin && url.protocol !== "file:") {
return;
}
var normalized = normalizeChapterUrl(url.href);
if (!normalized || seen[normalized]) {
return;
}
seen[normalized] = true;
chapters.push({
href: link.href,
key: normalized,
title: link.textContent.trim()
});
});
var index = chapters.findIndex(function (chapter) {
return chapter.key === current;
});
var previous = index > 0 ? chapters[index - 1] : null;
var next = index >= 0 && index < chapters.length - 1 ? chapters[index + 1] : null;
setChapterNavigationLink(".mobile-nav-chapters.previous", previous);
setChapterNavigationLink(".nav-chapters.previous", previous);
setChapterNavigationLink(".mobile-nav-chapters.next", next);
setChapterNavigationLink(".nav-chapters.next", next);
}