Webentwicklung für den im Simulator integrierten Browser

Aus ZusiWiki
Version vom 7. Juli 2026, 22:20 Uhr von F. Schn. (Diskussion | Beiträge) (JS-Scripte)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Grundlagen

Simulator und 3D-Editor nutzen den ins Betriebssystem integrierten Edge derzeit für folgende Funktionen:

  • Darstellung einer Begrüßung nach dem Laden eines Fahrplans
  • Einblendung eines „Anfangsbefehls“ nach dem Aufgleisen eines Zuges
  • Einblendung von vorkonfigurierten oder individuellen Befehlsformularen bei der Fahrt des Zuges

Zusi verwendet hierbei den WebView2. Gibt es Probleme hierbei, fällt Delphi auf den InternetExplorer zurück, der bis heute tief in Windows integriert ist.

Zu testende Konfigurationen

WebView2 verwendet ein Edge-Derivat mit der Cromium-Engine.

Unter Wine wird zur HTML-Anzeige ein Gecko-Derivat (ähnlich Firefox) verwendet.

Möchte man Webseiten für Zusi entwickeln, sollte man daher für folgende Platformen testen:

  • Aktueller Chromium (z.B. Edge)
  • Aktueller Gecko (z.B. Firefox)

Der Test sollte umfassen:

  • Normale Darstellung
  • Drucken mit Hintergrundbildern (zu finden in den Druckoptionen)
  • Drucken ohne Hintergrundbilder

Einbinden externer Dateien in Befehlsvorlagen

Das Einbinden externer Dateien (Bilder, CSS, ...) in Befehlsvorlagen (nicht komplett individuelle Befehls-HTMLs) gestaltet sich schwierig, da die ausgefüllte Befehlsdatei vom Simulator im Temp-Verzeichnis abgelegt wird. Stattdessen nutzt man für CSS das style-Tag und für andere Dateien Data-URIs.

Auf das Einbinden von Dateien aus dem Internet (Bilder, Webfonts, ...) sollte man verzichten. Zusi liefert die Schriftart Open Sans im Ordner _Setup\timetable_basics mit.

JS-Scripte

Bei JavaScripten muss darauf geachtet werden, dass kein Zeilenkommentar ("//blub") möglich ist, da Zusi die Zeilenumbrüche entfernt. Kommentare müssen daher mit "/*Blubb*/" geschrieben werden.

Im Regelfall wird der Fallback auf den InternetExplorer nicht ordentlich funktionieren, wenn man JS einsetzt.

Zum Schutz vor unbefugtem Zugriff auf den eigenen Rechner können Zusi-Webseiten auf nahezu keine externen Daten zugreifen. Ausgenommen sind Daten, die nur zur Anzeige dienen können, etwa CSS- und PNG-Dateien. Details sind im Regelfall unter dem Stichwort Cross-Origin Resource Sharing (CORS) zu finden.

Alte Themen

Alte Themen sind hier aufgeführt: https://zusiwiki.echoray.de/index.php?title=Webentwicklung_f%C3%BCr_den_im_Simulator_integrierten_Browser&oldid=899