|
| 1 | +// assets/js/flashcards.js |
1 | 2 | let flashcards = []; |
2 | 3 | let currentIndex = 0; |
3 | 4 |
|
4 | 5 | async function loadFlashcards(jsonUrl) { |
5 | | - const res = await fetch(jsonUrl); |
6 | | - flashcards = await res.json(); |
7 | | - currentIndex = 0; |
8 | | - renderFlashcard(); |
| 6 | + try { |
| 7 | + const r = await fetch(jsonUrl, { cache: "no-store" }); |
| 8 | + if (!r.ok) throw new Error(`HTTP ${r.status} ${r.statusText}`); |
| 9 | + flashcards = await r.json(); |
| 10 | + if (!Array.isArray(flashcards) || flashcards.length === 0) { |
| 11 | + throw new Error("Cards JSON is empty or not an array"); |
| 12 | + } |
| 13 | + currentIndex = 0; |
| 14 | + initUI(); |
| 15 | + renderCard(); |
| 16 | + } catch (err) { |
| 17 | + console.error("Failed to load flashcards:", err); |
| 18 | + const container = document.getElementById("flashcard-container") || document.getElementById("flashcard"); |
| 19 | + if (container) container.innerHTML = `<p style="color:red">Error loading cards: ${err.message}</p>`; |
| 20 | + } |
9 | 21 | } |
10 | 22 |
|
11 | | -function renderFlashcard() { |
12 | | - const container = document.getElementById("flashcard-container"); |
13 | | - container.innerHTML = ""; |
14 | | - |
15 | | - const cardData = flashcards[currentIndex]; |
16 | | - |
17 | | - const card = document.createElement("div"); |
18 | | - card.className = "flashcard"; |
19 | | - card.innerHTML = ` |
20 | | - <div class="flashcard-inner"> |
21 | | - <div class="flashcard-front">${marked.parse(cardData.front)}</div> |
22 | | - <div class="flashcard-back">${marked.parse(cardData.back)}</div> |
23 | | - </div> |
24 | | - `; |
| 23 | +/* safe typeset helper - waits for MathJax to be ready */ |
| 24 | +function safeTypeset(element) { |
| 25 | + return new Promise((resolve) => { |
| 26 | + const tryTypeset = () => { |
| 27 | + if (window.MathJax && MathJax.startup && MathJax.startup.promise) { |
| 28 | + MathJax.startup.promise.then(() => { |
| 29 | + if (MathJax.typesetPromise) { |
| 30 | + MathJax.typesetPromise([element]).then(resolve).catch((e) => { |
| 31 | + console.warn("MathJax typeset failed:", e); |
| 32 | + resolve(); |
| 33 | + }); |
| 34 | + } else { |
| 35 | + // older MathJax fallback |
| 36 | + try { MathJax.Hub && MathJax.Hub.Queue(["Typeset", MathJax.Hub, element]); } catch (e) {} |
| 37 | + resolve(); |
| 38 | + } |
| 39 | + }).catch((e) => { |
| 40 | + console.warn("MathJax startup promise failed:", e); |
| 41 | + resolve(); |
| 42 | + }); |
| 43 | + } else { |
| 44 | + // MathJax not yet defined — retry a few times then give up |
| 45 | + setTimeout(() => { |
| 46 | + tryTypeset(); |
| 47 | + }, 150); |
| 48 | + } |
| 49 | + }; |
| 50 | + tryTypeset(); |
| 51 | + }); |
| 52 | +} |
25 | 53 |
|
26 | | - container.appendChild(card); |
| 54 | +function initUI() { |
| 55 | + const flashcard = document.getElementById("flashcard"); |
| 56 | + const front = flashcard.querySelector(".flashcard-front"); |
| 57 | + const back = flashcard.querySelector(".flashcard-back"); |
| 58 | + const prevBtn = document.getElementById("prevBtn"); |
| 59 | + const nextBtn = document.getElementById("nextBtn"); |
27 | 60 |
|
28 | | - // Flip on click |
29 | | - card.addEventListener("click", () => { |
30 | | - card.classList.toggle("is-flipped"); // match CSS |
31 | | - if (window.MathJax) { |
32 | | - MathJax.typesetPromise(); |
33 | | - } |
| 61 | + // Prevent nav clicks from bubbling to the card (so they don't flip) |
| 62 | + [prevBtn, nextBtn].forEach(btn => { |
| 63 | + btn.addEventListener("click", (ev) => ev.stopPropagation()); |
34 | 64 | }); |
35 | 65 |
|
36 | | - // Always reset to front before showing a new card |
37 | | - card.classList.remove("is-flipped"); |
38 | | - void card.offsetWidth; // force reflow (prevents ghost transforms) |
39 | | - |
40 | | - // Typeset math after rendering |
41 | | - if (window.MathJax) { |
42 | | - MathJax.typesetPromise(); |
43 | | - } |
44 | | -} |
| 66 | + // Flip on click (toggle class on outer .flashcard) |
| 67 | + flashcard.addEventListener("click", () => { |
| 68 | + flashcard.classList.toggle("is-flipped"); |
| 69 | + // typeset visible side after flip |
| 70 | + safeTypeset(flashcard).catch(()=>{}); |
| 71 | + }); |
45 | 72 |
|
46 | | -// Navigation |
47 | | -document.addEventListener("DOMContentLoaded", () => { |
48 | | - document.getElementById("prevBtn").addEventListener("click", () => { |
| 73 | + prevBtn.addEventListener("click", (ev) => { |
| 74 | + ev.preventDefault(); |
49 | 75 | if (currentIndex > 0) { |
50 | 76 | currentIndex--; |
51 | | - renderFlashcard(); |
| 77 | + renderCard(); |
52 | 78 | } |
53 | 79 | }); |
54 | | - document.getElementById("nextBtn").addEventListener("click", () => { |
| 80 | + |
| 81 | + nextBtn.addEventListener("click", (ev) => { |
| 82 | + ev.preventDefault(); |
55 | 83 | if (currentIndex < flashcards.length - 1) { |
56 | 84 | currentIndex++; |
57 | | - renderFlashcard(); |
| 85 | + renderCard(); |
| 86 | + } |
| 87 | + }); |
| 88 | + |
| 89 | + // optional keyboard navigation |
| 90 | + document.addEventListener("keydown", (ev) => { |
| 91 | + if (ev.key === "ArrowLeft") { |
| 92 | + if (currentIndex > 0) { currentIndex--; renderCard(); } |
| 93 | + } else if (ev.key === "ArrowRight") { |
| 94 | + if (currentIndex < flashcards.length - 1) { currentIndex++; renderCard(); } |
| 95 | + } else if (ev.key === " " || ev.key === "Spacebar") { |
| 96 | + // space toggles flip (avoid flipping when focused on button) |
| 97 | + const active = document.activeElement; |
| 98 | + if (active && (active.tagName === "BUTTON" || active.tagName === "INPUT" || active.tagName === "TEXTAREA")) return; |
| 99 | + ev.preventDefault(); |
| 100 | + document.getElementById("flashcard").classList.toggle("is-flipped"); |
| 101 | + safeTypeset(document.getElementById("flashcard")).catch(()=>{}); |
58 | 102 | } |
59 | 103 | }); |
| 104 | +} |
| 105 | + |
| 106 | +async function renderCard() { |
| 107 | + const flashcard = document.getElementById("flashcard"); |
| 108 | + const front = flashcard.querySelector(".flashcard-front"); |
| 109 | + const back = flashcard.querySelector(".flashcard-back"); |
| 110 | + const prevBtn = document.getElementById("prevBtn"); |
| 111 | + const nextBtn = document.getElementById("nextBtn"); |
| 112 | + |
| 113 | + // Defensive checks |
| 114 | + if (!flashcard || !front || !back) { |
| 115 | + console.error("Flashcard DOM nodes missing"); |
| 116 | + return; |
| 117 | + } |
| 118 | + if (!flashcards.length) { |
| 119 | + front.innerHTML = "<p>No cards available</p>"; |
| 120 | + back.innerHTML = ""; |
| 121 | + return; |
| 122 | + } |
| 123 | + |
| 124 | + // Reset flip and force reflow to avoid animation glitches |
| 125 | + flashcard.classList.remove("is-flipped"); |
| 126 | + void flashcard.offsetWidth; // force reflow |
| 127 | + |
| 128 | + // Render content (try/catch so a broken card won't break the UI) |
| 129 | + try { |
| 130 | + const item = flashcards[currentIndex] || { front: "", back: "" }; |
| 131 | + front.innerHTML = marked.parse(item.front || ""); |
| 132 | + back.innerHTML = marked.parse(item.back || ""); |
| 133 | + } catch (err) { |
| 134 | + console.error("Error rendering markdown:", err); |
| 135 | + front.textContent = flashcards[currentIndex].front || ""; |
| 136 | + back.textContent = flashcards[currentIndex].back || ""; |
| 137 | + } |
| 138 | + |
| 139 | + // update nav disabled state |
| 140 | + if (prevBtn) prevBtn.disabled = currentIndex === 0; |
| 141 | + if (nextBtn) nextBtn.disabled = currentIndex === (flashcards.length - 1); |
| 142 | + |
| 143 | + // typeset math on visible content first, then invisible side |
| 144 | + try { |
| 145 | + await safeTypeset(front); |
| 146 | + // we also typeset back in background so when flipped it appears quickly |
| 147 | + safeTypeset(back).catch(()=>{}); |
| 148 | + } catch (e) { |
| 149 | + console.warn("Typeset error (ignored):", e); |
| 150 | + } |
| 151 | +} |
| 152 | + |
| 153 | +/* run (from template) */ |
| 154 | +document.addEventListener("DOMContentLoaded", () => { |
| 155 | + // nothing here – loadCards(jsonUrl) should be invoked by the template inline script |
60 | 156 | }); |
0 commit comments