• v3.35.0 f35da6ceb6

    L_cke_text released this 2026-10-06 19:36:02 +00:00 | 10 commits to main since this release

    Geändert (Struktur, T-07)

    • Das Themen-Netz besteht aus ES-Modulen statt aus einer Datei. Aus assets/graph.js (1544 Zeilen, eine IIFE mit geteiltem Zustand) wurden 48 kleine native Module unter assets/graph/ (Modell, Zustand, flaches Netz, 3D, Oberfläche, Dienste), zusammengesetzt im Kompositionsstamm main.js. Ziel waren SOLID und lesbare Namen: eine Aufgabe je Modul, Abhängigkeiten nur nach unten und per Parameter hereingereicht, ein gemeinsamer Store mit Ereignissen statt der alten Drehscheibe applyFilter(), Ansichten als { enter(), exit() } (eine neue Ansicht braucht nur einen Eintrag), keine versteckten _-Felder an den Knoten (Zeichen-Zwischenspeicher in dom-writers.js/painter.js, ARIA-Position im Tastaturbaum, 3D-Körper in eigener Liste), keine Wahrheitswerte als Argument (showLoader/hideLoader, pin/unpin, scheduleFitToVisibleNodes/scheduleFitToOverview), benannte Konstanten. Aussehen, Bedienung, IDs, CSS-Klassen, ARIA-Baum, Speicherschlüssel (qa_prefs, qz_view, qz_hint_seen), Ereignisse und Tracking-Namen sind unverändert.
    • Auslieferung ohne Bundler: inc/graph-modules.php registriert jede Datei als WordPress-Script-Modul (@quizzie/graph/<pfad>), liest die Abhängigkeiten aus den import-Zeilen und lässt WordPress eine Import-Map mit der Theme-Version schreiben (Cache-Bruch bei jedem Update). Die Fensterwerte QUIZZIE_GRAPH, QUIZZIE_CFG und QA_TRACKING setzt ein klassisches Skript-Handle ohne Datei. assets/graph/package.json (nicht im Paket) lässt Node dieselben Kennungen auflösen. Hinweis für Betreiber: Optimierungs-Plugins, die JavaScript bündeln oder minimieren, müssen Script-Module ausnehmen.
    • Drei kleine Korrekturen, die beim Umbau offenkundig wurden: (1) „Zurücksetzen“ entfernt jetzt auch die gestrichelten Linien zu verwandten Themen (vorher blieben sie bis zum nächsten Fokus stehen). (2) Bei „Bewegung reduzieren“ fährt auch das Einpassen der Ansicht ohne Animation (vorher immer 600 ms). (3) Bei „Bewegung reduzieren“ entsteht das erste Layout mit den Zentrierkräften (sie fehlten in der ersten Berechnung). Zusätzlich misst das Seitenpanel seine Breite nur noch nach Öffnen, Schließen und Größenänderung statt bei jedem Filterlauf.
    • Gemessen (lokale Testseite, 905 Knoten, Chrome 4× CPU-gedrosselt, 390 px): Bildzeiten wie vorher (Median 16,7 ms bei Schwenken und Zoom, p95 ≤ 33 ms bzw. 17 ms), axe-core (WCAG 2.0–2.2 A/AA) auf Netz, Karten, Handy mit offener Filterleiste und Fokus mit Panel: keine Verstöße, im dunklen Schema einer außerhalb des Netzes (Rundgang des Plugins, siehe P-14). Kosten: unter HTTP/1.1 mit Drosselung (1,6 Mbit/s, 40 ms Latenz) ist das Netz nach 5,5 s statt 4,9 s sichtbar (57 statt 12 Anfragen); mit HTTP/2 dürfte der Unterschied klein sein (nicht gemessen), siehe T-20.

    Behoben

    • Handbuch: Themenseite lieferte „500“ (Speicher erschöpft). Lektionen des mitgelieferten Handbuchs zeigen Shortcode-Beispiele ([qa_academy], [qz_children] …) in Codeblöcken; auf der Themenseite führte WordPress sie aus, und die Akademie rendert sich dadurch rekursiv, bis der Speicher (256 MB) erschöpft ist. Der Handbuch-Generator schreibt eckige Klammern jetzt als Entität (&#91;), die Beispiele erscheinen unverändert, werden aber nicht mehr ausgeführt. Geprüft auf der Testseite: Themenseite 200 mit 54 Lektionen, alle 54 Lektionen ohne Überlauf bei 390 px, alle 10 Quizze 100 %. Die Ursache im Plugin (keine Rekursionssperre) ist als P-15 eingetragen.

    Tests

    • 90 Node-Tests (neu, node --test tests/js) für alle reinen Module, Browser-Szenarien mit goldener Ausgabe (neu, tests/e2e/graph-scenarios.mjs: Fokus, Themenwechsel, Suche mit Tippfehler, Typ-Schalter, Pfad, Zurücksetzen, Karten samt Navigation, 3D, Tastatur, Panel, Beschriftungsmodi, verwandte Themen, Handy, reduzierte Bewegung) und 27 PHPUnit-Tests (8 neu: Module, Importe, Import-Map). Die Szenarien liefen nach jedem Umbauschritt unverändert durch; die goldene Datei wurde vom Stand vor dem Umbau erzeugt (einzige Abweichung: das Szenario zu den verwandten Linien nach „Zurücksetzen“, siehe oben).
    • Nicht geprüft: echte Geräte, Safari und Firefox, Pinch-Geste per Touch, HTTP/2-Server, Caching-/Minify-Plugins mit Script-Modulen, die Pipeline (Paket mit assets/graph/), die 3D-Ansicht per Touch. Die 3D-Beschriftungen folgen der Beschriftungs-Einstellung weiter nicht (T-22).
    Downloads