PyGWalker HTML API Anleitung
Mit PyGWalker können Sie die Graphic Walker-Oberfläche in jeder Anwendung rendern, die HTML-Rendering unterstützt. Diese Anleitung erklärt, wie Sie die HTML-API effektiv nutzen.
Wichtiger Hinweis
Die aktuelle HTML-API ist nur für Frontend-Berechnungen ausgelegt. Sie ist möglicherweise nicht für große Datensätze geeignet, da es zu Leistungsproblemen kommen kann.
Verwendung von to_html()
Die Funktion to_html() ist die primäre Methode zur Generierung von HTML-Ausgabe aus Ihrem DataFrame.
Grundlegende Verwendung
import pygwalker as pyg
import pandas as pd
df = pd.read_csv('data.csv')
html_str = pyg.to_html(df)Funktionsparameter
| Parameter | Typ | Standardwert | Beschreibung |
|---|---|---|---|
| dataset | DataFrame | - | Der Eingabe-DataFrame. Siehe Dataset Of Walker für weitere Details. |
| gid | Union[int, str] | None | ID für das GraphicWalker Container-Div. Format: 'gwalker-{gid}'. Wird automatisch generiert, wenn None. |
| field_specs | Optional[Dict[str, FieldSpec]] | None | Feldspezifikationen. Automatisch aus dem dataset abgeleitet, wenn nicht angegeben. |
| theme_key | Literal['vega', 'g2'] | 'g2' | Thema für GraphicWalker. |
| appearance | Literal['media', 'light', 'dark'] | 'media' | Thema-Einstellungen. 'media' erkennt automatisch das OS-Thema. |
| spec | str | "" | Diagrammkonfigurationsdaten. Kann eine Konfigurations-ID, JSON oder URL einer externen Datei sein. |
| default_tab | Literal["data", "vis"] | "vis" | Standard-Tab, der beim Laden der Benutzeroberfläche angezeigt wird. |
| **kwargs | Any | - | Zusätzliche Schlüsselwörter. |
Beispiele
Exportieren in eine HTML-Datei
Sie können das generierte HTML in eine Datei speichern, um es später zu verwenden oder zu teilen:
import pandas as pd
import pygwalker as pyg
df = pd.read_csv('data.csv')
with open("pygwalker_demo.html", "w", encoding="utf-8") as f:
f.write(pyg.to_html(df))Verwendung von PyGWalker mit Shiny
PyGWalker kann in Shiny-Anwendungen integriert werden. Für eine detaillierte Anleitung und ein Beispiel, siehe unser Shiny-Integrationstutorial.
Bewährte Vorgehensweisen
- Leistungsüberlegungen: Achten Sie auf die Datensatzgröße bei der Verwendung der HTML-API, da die Daten auf der Client-Seite verarbeitet werden.
- Anpassung: Verwenden Sie den Parameter
field_specs, um feine Abstimmungen darüber vorzunehmen, wie Ihre Daten interpretiert und angezeigt werden. - Theming: Experimentieren Sie mit verschiedenen
theme_key- undappearance-Einstellungen, um das Erscheinungsbild Ihrer Anwendung anzupassen. - Integration: Stellen Sie bei der Integration in Web-Frameworks wie Shiny sicher, dass Sie die HTML-Ausgabe angemessen in die Struktur Ihrer Anwendung einbinden.
Für eine fortgeschrittene Nutzung und Integrationsbeispiele beziehen Sie sich bitte auf die PyGWalker-Dokumentation.