summaryrefslogtreecommitdiff
path: root/assets/static/js/image-viewer.js
diff options
context:
space:
mode:
authorDennis Fink2026-11-06 20:38:35 +0100
committerDennis Fink2026-11-06 20:38:35 +0100
commit8963ed31ce537a736ddba99baf68b31858b319b8 (patch)
tree5c617043b0e906bdb38ddb723457eba3911a9f5a /assets/static/js/image-viewer.js
parent904b29dfa998ca491590cee2241c9ef92e16355c (diff)
downloaddennisfink.me-8963ed31ce537a736ddba99baf68b31858b319b8.tar.gz
dennisfink.me-8963ed31ce537a736ddba99baf68b31858b319b8.zip
Add click-to-enlarge image viewer
This adds a native dialog for enlarging images throughout the site, including gallery images with previous and next navigation. The viewer supports keyboard navigation, image captions, and responsive layouts, while preserving the existing behaviour of linked images and interactive maps.
Diffstat (limited to '')
-rw-r--r--assets/static/js/image-viewer.js100
1 files changed, 100 insertions, 0 deletions
diff --git a/assets/static/js/image-viewer.js b/assets/static/js/image-viewer.js
new file mode 100644
index 0000000..28c44cb
--- /dev/null
+++ b/assets/static/js/image-viewer.js
@@ -0,0 +1,100 @@
+/* Enlarge content images in a native dialog; navigate within galleries. */
+(() => {
+ const dialog = document.querySelector("#image-viewer");
+ if (!dialog || typeof dialog.showModal !== "function") return;
+
+ const enlargedImage = dialog.querySelector("figure > img");
+ const caption = dialog.querySelector("figcaption");
+ const previousButton = dialog.querySelector('[data-action="previous"]');
+ const nextButton = dialog.querySelector('[data-action="next"]');
+ const closeButton = dialog.querySelector('[data-action="close"]');
+
+ // Linked images and interactive maps must keep their existing behaviour.
+ const images = [...document.querySelectorAll("main img")].filter(
+ (image) =>
+ image.getAttribute("src") &&
+ !image.closest("a, button, .trail, [data-no-enlarge]"),
+ );
+
+ let group = [];
+ let index = 0;
+
+ function displayCurrentImage() {
+ const image = group[index];
+ enlargedImage.src = image.dataset.fullsize || image.currentSrc || image.src;
+ enlargedImage.alt = image.alt;
+
+ const sourceCaption = image
+ .closest("figure:not(.trail)")
+ ?.querySelector(":scope > figcaption");
+ const captionContent = sourceCaption?.cloneNode(true);
+ captionContent
+ ?.querySelectorAll("details")
+ .forEach((detail) => detail.remove());
+ caption.textContent =
+ captionContent?.textContent.replace(/\s+/g, " ").trim() || "";
+ caption.hidden = !caption.textContent;
+
+ previousButton.hidden = nextButton.hidden = group.length < 2;
+ }
+
+ function openViewer(image) {
+ const gallery = image.closest(".gallery");
+ group = gallery
+ ? images.filter((candidate) => candidate.closest(".gallery") === gallery)
+ : [image];
+ index = group.indexOf(image);
+ displayCurrentImage();
+ dialog.showModal();
+ }
+
+ function navigate(direction) {
+ if (group.length < 2) return;
+ index = (index + direction + group.length) % group.length;
+ displayCurrentImage();
+ }
+
+ for (const image of images) {
+ image.dataset.enlargeable = "";
+ image.tabIndex = 0;
+ image.setAttribute("role", "button");
+ image.setAttribute("aria-haspopup", "dialog");
+ image.setAttribute(
+ "aria-label",
+ image.alt ? `Enlarge image: ${image.alt}` : "Enlarge image",
+ );
+
+ image.addEventListener("click", () => openViewer(image));
+ image.addEventListener("keydown", (event) => {
+ if (event.key === "Enter" || event.key === " ") {
+ event.preventDefault();
+ openViewer(image);
+ }
+ });
+ }
+
+ previousButton.addEventListener("click", () => navigate(-1));
+ nextButton.addEventListener("click", () => navigate(1));
+ closeButton.addEventListener("click", () => dialog.close());
+
+ dialog.addEventListener("keydown", (event) => {
+ if (event.key === "ArrowLeft" || event.key === "ArrowRight") {
+ event.preventDefault();
+ navigate(event.key === "ArrowLeft" ? -1 : 1);
+ }
+ });
+
+ // Click the backdrop to close, but not the spacing around the image.
+ dialog.addEventListener("click", (event) => {
+ if (event.target !== dialog) return;
+ const rect = dialog.getBoundingClientRect();
+ if (
+ event.clientX < rect.left ||
+ event.clientX > rect.right ||
+ event.clientY < rect.top ||
+ event.clientY > rect.bottom
+ ) {
+ dialog.close();
+ }
+ });
+})();