215 lines
7.2 KiB
HTML
215 lines
7.2 KiB
HTML
<!-- figures/flow-player.html -- the web version's interactive diagrams.
|
|
Injected at the end of <body> by include-in-header's sibling
|
|
include-after-body in _quarto.yml, so it is a no-op on a page that holds
|
|
no img.flow-figure.
|
|
|
|
A chapter writes an ordinary Quarto figure and adds the class:
|
|
|
|
{#fig-x .flow-figure}
|
|
|
|
That keeps the PDF and the no-JavaScript case working: the built svg is
|
|
already the whole picture. Here the image is fetched, inlined, and given
|
|
a play bar that walks a message through the mailboxes, one hop per
|
|
[data-flow] edge of the svg, highlighting the [data-flow-node] each hop
|
|
ends at. Colours are diagram.css's, so the two stay in step. -->
|
|
|
|
<style>
|
|
.flow-wrap { margin: 0; }
|
|
.flow-wrap svg { width: 100%; height: auto; display: block; }
|
|
|
|
.flow-token { fill: #8a5a08; stroke: #fbfcfd; stroke-width: 1.2; }
|
|
.flow-wrap .flow-on .box,
|
|
.flow-wrap .flow-on .box-plain,
|
|
.flow-wrap .flow-on .box-accent { stroke-width: 3; }
|
|
.flow-wrap .flow-done { stroke: #8a5a08; }
|
|
|
|
.flow-bar {
|
|
display: flex; align-items: center; gap: .5rem; flex-wrap: wrap;
|
|
max-width: 100%; margin: .45rem 0 0;
|
|
}
|
|
.flow-bar button {
|
|
font: inherit; font-size: .82rem; padding: .18rem .7rem; cursor: pointer;
|
|
border: 1px solid #dae0e8; border-radius: 999px;
|
|
background: #fbfcfd; color: #5a6879;
|
|
}
|
|
.flow-bar button:hover { border-color: #20666f; color: #20666f; }
|
|
.flow-bar button[disabled] { opacity: .45; cursor: default; }
|
|
.flow-status { font-size: .8rem; color: #5a6879; }
|
|
.flow-status b { color: #20666f; font-weight: 600; }
|
|
|
|
@media (prefers-color-scheme: dark) {
|
|
.flow-token { fill: #c99a3a; stroke: #161b22; }
|
|
.flow-bar button { background: #161b22; border-color: #30363d; color: #8b98a8; }
|
|
.flow-bar button:hover { border-color: #4c9aa5; color: #7fc4cf; }
|
|
.flow-status { color: #8b98a8; }
|
|
.flow-status b { color: #7fc4cf; }
|
|
}
|
|
</style>
|
|
|
|
<script>
|
|
(() => {
|
|
const images = document.querySelectorAll("img.flow-figure");
|
|
if (!images.length) return;
|
|
|
|
const LANG = (document.documentElement.lang || "en").slice(0, 2);
|
|
const WORDS = {
|
|
en: { play: "Play", pause: "Pause", step: "One hop", reset: "Reset",
|
|
idle: "the message has not been sent yet", done: "arrived" },
|
|
fr: { play: "Lancer", pause: "Pause", step: "Un saut", reset: "Réinitialiser",
|
|
idle: "le message n'est pas encore parti", done: "arrivé" },
|
|
de: { play: "Abspielen", pause: "Pause", step: "Ein Sprung", reset: "Zurücksetzen",
|
|
idle: "die Nachricht ist noch nicht unterwegs", done: "angekommen" },
|
|
};
|
|
const W = WORDS[LANG] || WORDS.en;
|
|
const STILL = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
|
|
const HOP = 620; // ms per hop
|
|
|
|
const label = (node) => {
|
|
const text = node && node.querySelector("text");
|
|
return text ? text.textContent.trim() : "";
|
|
};
|
|
|
|
async function upgrade(img) {
|
|
let svg;
|
|
try {
|
|
const response = await fetch(img.currentSrc || img.src);
|
|
if (!response.ok) return; // leave the plain image in place
|
|
const doc = new DOMParser().parseFromString(await response.text(), "image/svg+xml");
|
|
svg = doc.documentElement;
|
|
if (!svg || svg.nodeName !== "svg" || doc.querySelector("parsererror")) return;
|
|
} catch { return; } // file:// or offline: plain image
|
|
|
|
const edges = [...svg.querySelectorAll("[data-flow]")]
|
|
.sort((a, b) => Number(a.dataset.flow) - Number(b.dataset.flow));
|
|
if (!edges.length) return;
|
|
|
|
svg.removeAttribute("width");
|
|
svg.removeAttribute("height");
|
|
|
|
const wrap = document.createElement("div");
|
|
wrap.className = "flow-wrap";
|
|
wrap.appendChild(svg);
|
|
|
|
const bar = document.createElement("div");
|
|
bar.className = "flow-bar";
|
|
const make = (name) => {
|
|
const button = document.createElement("button");
|
|
button.type = "button";
|
|
button.textContent = W[name];
|
|
bar.appendChild(button);
|
|
return button;
|
|
};
|
|
const playButton = make("play");
|
|
const stepButton = make("step");
|
|
const resetButton = make("reset");
|
|
const status = document.createElement("span");
|
|
status.className = "flow-status";
|
|
bar.appendChild(status);
|
|
wrap.appendChild(bar);
|
|
|
|
img.hidden = true;
|
|
img.after(wrap);
|
|
|
|
const token = document.createElementNS("http://www.w3.org/2000/svg", "circle");
|
|
token.setAttribute("r", "6");
|
|
token.setAttribute("class", "flow-token");
|
|
token.style.display = "none";
|
|
svg.appendChild(token);
|
|
|
|
let at = 0; // hops already made
|
|
let playing = false;
|
|
let frame = null;
|
|
|
|
const nodeOf = (edge) =>
|
|
edge.dataset.flowTo
|
|
? svg.querySelector(`[data-flow-node="${edge.dataset.flowTo}"]`)
|
|
: null;
|
|
|
|
const say = () => {
|
|
if (at === 0) { status.textContent = W.idle; return; }
|
|
const here = label(nodeOf(edges[at - 1]));
|
|
status.innerHTML = `${at} / ${edges.length} — <b></b>`;
|
|
status.querySelector("b").textContent =
|
|
at === edges.length ? `${here} (${W.done})` : here;
|
|
};
|
|
|
|
const clear = () => {
|
|
svg.querySelectorAll(".flow-on").forEach((n) => n.classList.remove("flow-on"));
|
|
edges.forEach((e) => e.classList.remove("flow-done"));
|
|
};
|
|
|
|
const place = (edge, fraction) => {
|
|
const length = edge.getTotalLength();
|
|
const point = edge.getPointAtLength(length * fraction);
|
|
token.setAttribute("cx", point.x);
|
|
token.setAttribute("cy", point.y);
|
|
token.style.display = "";
|
|
};
|
|
|
|
function hop(then) {
|
|
const edge = edges[at];
|
|
if (!edge) { then && then(false); return; }
|
|
clear();
|
|
const arrive = () => {
|
|
edge.classList.add("flow-done");
|
|
const node = nodeOf(edge);
|
|
if (node) node.classList.add("flow-on");
|
|
at += 1;
|
|
say();
|
|
buttons();
|
|
then && then(at < edges.length);
|
|
};
|
|
if (STILL) { place(edge, 1); arrive(); return; }
|
|
const start = performance.now();
|
|
const tick = (now) => {
|
|
const done = Math.min((now - start) / HOP, 1);
|
|
place(edge, done);
|
|
if (done < 1) { frame = requestAnimationFrame(tick); } else { frame = null; arrive(); }
|
|
};
|
|
frame = requestAnimationFrame(tick);
|
|
}
|
|
|
|
function buttons() {
|
|
const end = at >= edges.length;
|
|
playButton.textContent = playing ? W.pause : W.play;
|
|
playButton.disabled = end && !playing;
|
|
stepButton.disabled = end || playing;
|
|
resetButton.disabled = at === 0 && !playing;
|
|
}
|
|
|
|
function stop() {
|
|
playing = false;
|
|
if (frame) { cancelAnimationFrame(frame); frame = null; }
|
|
buttons();
|
|
}
|
|
|
|
function run() {
|
|
if (at >= edges.length) at = 0;
|
|
playing = true;
|
|
buttons();
|
|
const next = (more) => {
|
|
if (!playing) return;
|
|
if (more) { hop(next); } else { stop(); }
|
|
};
|
|
hop(next);
|
|
}
|
|
|
|
playButton.addEventListener("click", () => (playing ? stop() : run()));
|
|
stepButton.addEventListener("click", () => { stop(); hop(); });
|
|
resetButton.addEventListener("click", () => {
|
|
stop();
|
|
at = 0;
|
|
clear();
|
|
token.style.display = "none";
|
|
say();
|
|
buttons();
|
|
});
|
|
|
|
say();
|
|
buttons();
|
|
}
|
|
|
|
images.forEach(upgrade);
|
|
})();
|
|
</script>
|