Gespeicherte Webseiten mit HtmlViewer anzeigen
de.neitzel.fx.control.HtmlViewer zeigt lokale HTML-Dateien und SingleFile-Exporte an. Gespeicherte Formatierungen, eingebettete Schriften und Hintergrundbilder bleiben erhalten. SVG wird als Bild dargestellt. Eingebettete WebP-Bilder wandelt der Viewer bei Bedarf im Speicher in PNG um. Die Originaldatei bleibt erhalten.
Im folgenden Beispiel gehört der Viewer einem Fenster. load liest und verarbeitet die Datei im Hintergrund. Alle Aufrufe am Viewer selbst gehören auf den JavaFX Application Thread.
// In Application.start(Stage stage)
var viewer = new HtmlViewer();
stage.setScene(new Scene(viewer, 900, 600));
stage.setOnHidden(event -> viewer.close());
stage.show();
viewer.load(Path.of("artikel.html"));
Bereits vorliegenden HTML-Text übernimmt loadHtml(html). Der zweite Parameter von loadHtml(html, quellUri) dient als Basis für relative Bildadressen. Eine im Dokument gespeicherte Basisadresse hat Vorrang. Beim Laden einer Datei gilt eine Obergrenze von 32 MiB. Für mehrere Ansichten lässt sich ein unveränderliches HtmlDocument im Hintergrund mit read oder parse vorbereiten und mit viewer.display(document) anzeigen.
Jedes Dokument öffnet sich offline. Die eingebaute Schaltfläche erlaubt auf Wunsch HTTP(S)-Anfragen für Bilder einschließlich CSS-Hintergrundbildern. Die Freigabe gilt für das angezeigte Dokument in dieser Viewer-Instanz. Beim Dokumentwechsel erlischt sie. JavaScript, Navigation und externe Stylesheets bleiben gesperrt.
Eine eigene Schaltfläche kann loadExternalImages() aufrufen. externalImagesAvailableProperty() meldet gefundene externe Bildadressen und externalImagesAllowedProperty() die erteilte Freigabe. Das folgende FXML blendet die eingebaute Aktion aus. Nach dem Laden der Ansicht öffnet der Controller das gewünschte Dokument.
<?import de.neitzel.fx.control.HtmlViewer?>
<HtmlViewer xmlns:fx="http://javafx.com/fxml/1"
fx:id="artikel" mediaButtonVisible="false"/>
loadingProperty() und errorProperty() liefern Ladezustand und Fehler. clear() bricht einen laufenden Ladevorgang ab und leert die wiederverwendbare Ansicht. Beim endgültigen Schließen des Fensters oder Tabs gibt close() den Viewer frei.