Es ist daher keine Überraschung, dass Sie möglicherweise eine bestimmte Plotly-Figur in einen HTML-String umwandeln müssen.
In diesem Tutorial lernen wir, wie man das Plotly io-Modul verwendet, um eine Figur in eine HTML-String-Darstellung umzuwandeln.
Tauchen wir ein.
Plotly.io.to_html()-Funktion
Mit der Funktion to_html() aus dem io-Modul von Plotly können Sie eine bestimmte Zahl als Parameter übergeben und in einen HTML-String umwandeln.
Die Funktionssyntax wird wie folgt ausgedrückt:
anschaulich. Dies . to_html ( Feige , Konfig = Keiner , automatisches Abspielen = WAHR , include_plotlyjs = WAHR , include_mathjax = FALSCH , post_script = Keiner , full_html = WAHR , animation_opts = Keiner , default_width = '100%' , default_height = '100%' , bestätigen = WAHR , div_id = Keiner )
Lassen Sie uns die Funktionsparameter unten untersuchen:
- Fig – bezieht sich auf das Figurenobjekt oder die Wörterbuchdarstellung der Figur.
- Config – legt die Konfigurationsoptionen von plotly.js fest. Übergeben Sie die Konfigurationsoptionen als Wörterbuch.
- Auto_play – legt fest, ob die Animationssequenz beim Laden der Seite automatisch abgespielt werden soll. Dieser Parameter ist nützlich, wenn Sie eine Figur mit animierten Frames haben.
- Include_plotlyjs – dieser Parameter gibt an, wie die Plotly.js-Bibliothek in den HTML-Code eingebunden wird. Zulässige Werte in diesem Parameter sind:
- True – Fügt die plotly.js-Bibliothek als Skript-Tag in das HTML-Dokument ein. Dadurch wird die Dateigröße erhöht, die Datei kann jedoch in Offline-Umgebungen verwendet werden.
- „cdn“ – Wenn Sie den Parameter „include_plotlyjs“ auf „cdn“ setzen, wird ein Skript-Tag hinzugefügt, das auf einen Remote-Link für die plotly.js-Bibliothek verweist. Verwenden Sie diese Option, wenn Sie sich in einer Netzwerkumgebung oder in einer Umgebung mit sensibler Dateigröße befinden.
- „Verzeichnis“ – enthält ein Skript-Tag, das auf ein externes plotly.min.js-Bundle verweist, das sich im selben Verzeichnis wie das HTML-Dokument befindet.
- ‘require’ – Wenn Sie den Wert auf require setzen, wird die Bibliothek plotly.js mithilfe von require.js geladen. Stellen Sie sicher, dass require.js installiert und global auf dem System verfügbar ist.
- „False“ – enthält nicht die plotly.js-Bibliothek. Vermeiden Sie diesen Wert, wenn Sie den Parameter full_html auf True setzen, da dadurch das gesamte Dokument unbrauchbar wird.
- include_mathjax – gibt an, ob die Datei die Bibliothek mathjax.js enthalten soll. Akzeptierte Werte ähneln include_plotlyjs mit Ausnahme des „require“-Werts.
- Post_script – ermöglicht das Einfügen von JavaScript-Schnipseln, die nach der Ploterstellung ausgeführt werden.
- Full_html – wenn wahr, gibt die Funktion einen String zurück, der das gesamte HTML-Dokument enthält, beginnend mit den -Tags. Bei „false“ gibt die Funktion einen HTML-String zurück, der mit dem -Element beginnt.
- Animation_opts – ermöglicht es Ihnen, benutzerdefinierte Animationseigenschaften als Wörterbuch anzugeben. Diese Werte werden dann an die Funktion plotly.animate in plotly.js übergeben.
- Default_width – gibt die Standardbreite der resultierenden Figur in Pixeln an.
- Default_height – gibt die Standardhöhe der Figur in Pixel an.
- Validieren – legt fest, ob die Abbildung validiert werden soll, bevor sie in einen HTML-String umgewandelt wird.
- Div_id – gibt einen Wert des id-Attributs des div-Tags an, in dem sich der Plot befindet.
Dann gibt die Funktion eine Zeichenfolgendarstellung der Figur als Zeichenfolge zurück.
Beispielnutzung
Der folgende Code zeigt, wie die to_html-Funktion verwendet wird, um eine Abbildung in eine HTML-Zeichenfolgendarstellung zu konvertieren.
importieren anschaulich. ausdrücken wie px
df = px. Daten . Vorräte ( indexiert = WAHR )
Feige = px. Bereich ( df , facet_col = 'Gesellschaft' , facet_col_wrap = zwei )
Feige. Show ( )Im obigen Beispiel importieren wir zunächst das Plotly-Express-Modul als px. Wir erstellen dann einen Datenrahmen mit den Bestandsdaten von Plotly.
Schließlich erstellen wir mit der Funktion px.area ein facettiertes Flächendiagramm. Dies sollte eine Abbildung wie unten gezeigt zurückgeben:
Wir können die obige Abbildung in eine HTML-String-Darstellung umwandeln, wie im folgenden Code gezeigt:
importieren anschaulich. Dies wie Dies
Dies. to_html ( Feige , full_html = FALSCH )Das Ausführen des obigen Codes sollte eine massive HTML-Zeichenfolge zurückgeben, wie im folgenden Screenshot gezeigt:
Beachten Sie, dass das HTML-Dokument beim
-Element beginnt. Wenn Sie die gesamte HTML-Datei einschließen möchten, setzen Sie den Parameter full_html=True wie gezeigt: importieren anschaulich. Dies wie Dies
Dies. to_html ( Feige , full_html = WAHR )
Beachten Sie, dass das Markup beim -Tag beginnt.
Um plotly.js einzuschließen, können wir den Parameter wie folgt einstellen:
importieren anschaulich. Dies wie Dies
Dies. to_html ( Feige , include_plotlyjs = 'CDN' , full_html = WAHR )Im obigen Beispiel weisen wir die Funktion an, die plotly.js-Bibliothek über einen CDN-Link einzubinden.
Wir können dies anhand der folgenden Ausgabe überprüfen:
Der beste Weg, das to_html-Dokument zu verwenden, besteht darin, den HTML-String in eine HTML-Datei zu exportieren.
Wir können dies tun, indem wir einen einfachen Code wie unten gezeigt ausführen:
importieren anschaulich. Dies wie Dies
mit offen ( 'facettiert.html' , 'in' ) wie f:
f. Schreibzeilen ( Dies. to_html ( Feige , include_plotlyjs = 'cnd' , full_html = WAHR ) )In diesem Beispiel verwenden wir das Dateimodul in Python, um den HTML-String als N-HTML-Datei zu schreiben.
Wir können dann das HTML-Dokument im Browser öffnen und die Abbildung wie gezeigt anzeigen:
Fazit
Herzlichen Glückwunsch, Sie haben Ihre Plotly-Abbildung erfolgreich als HTML-String mit der Funktion plotly.io.to_html exportiert.