Guide de l'API HTML PyGWalker
PyGWalker vous permet de rendre l'interface utilisateur de Graphic Walker dans toute application prenant en charge le rendu HTML. Ce guide explique comment utiliser l'API HTML de manière efficace.
Note Importante
L'API HTML actuelle est conçue uniquement pour le calcul côté client. Elle peut ne pas convenir pour les grands ensembles de données en raison de limitations de performance.
Utilisation de to_html()
La fonction to_html()
est la méthode principale pour générer une sortie HTML à partir de votre DataFrame.
Utilisation Basique
import pygwalker as pyg
import pandas as pd
df = pd.read_csv('data.csv')
html_str = pyg.to_html(df)
Paramètres de la Fonction
Paramètre | Type | Par Défaut | Description |
---|---|---|---|
dataset | DataFrame | - | Le DataFrame d'entrée. Voir Dataset Of Walker pour plus de détails. |
gid | Union[int, str] | None | ID pour le conteneur div de GraphicWalker. Format : 'gwalker-{gid}'. Généré automatiquement si None. |
field_specs | Optional[Dict[str, FieldSpec]] | None | Spécifications de champs. Inférées automatiquement à partir de dataset si non spécifiées. |
theme_key | Literal['vega', 'g2'] | 'g2' | Type de thème pour GraphicWalker. |
appearance | Literal['media', 'light', 'dark'] | 'media' | Paramètre de thème. 'media' détecte automatiquement le thème de l'OS. |
spec | str | "" | Données de configuration du graphique. Peut être un ID de configuration, du JSON ou une URL de fichier à distance. |
default_tab | Literal["data", "vis"] | "vis" | Onglet par défaut à afficher lors du chargement de l'interface utilisateur. |
**kwargs | Any | - | Arguments supplémentaires. |
Exemples
Exporter vers un Fichier HTML
Vous pouvez enregistrer le HTML généré dans un fichier pour une utilisation ultérieure ou un partage :
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))
Utiliser PyGWalker avec Shiny
PyGWalker peut être intégré dans des applications Shiny. Pour un guide détaillé et un exemple, consultez notre tutoriel d'intégration Shiny.
Bonnes Pratiques
- Considérations de Performance : Soyez conscient de la taille de l'ensemble de données lors de l'utilisation de l'API HTML, car elle traite les données côté client.
- Personnalisation : Utilisez le paramètre
field_specs
pour affiner l'interprétation et l'affichage de vos données. - Thématisation : Expérimentez avec différents paramètres
theme_key
etappearance
pour assortir le style de votre application. - Intégration : Lors de l'intégration avec des frameworks web comme Shiny, assurez-vous de gérer la sortie HTML de manière appropriée dans la structure de votre application.
Pour des exemples d'utilisation avancée et d'intégration, veuillez consulter la documentation de PyGWalker.