Skip to content
PYGWALKER
Référence de l'API
HTML Exports

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ètreTypePar DéfautDescription
datasetDataFrame-Le DataFrame d'entrée. Voir Dataset Of Walker pour plus de détails.
gidUnion[int, str]NoneID pour le conteneur div de GraphicWalker. Format : 'gwalker-{gid}'. Généré automatiquement si None.
field_specsOptional[Dict[str, FieldSpec]]NoneSpécifications de champs. Inférées automatiquement à partir de dataset si non spécifiées.
theme_keyLiteral['vega', 'g2']'g2'Type de thème pour GraphicWalker.
appearanceLiteral['media', 'light', 'dark']'media'Paramètre de thème. 'media' détecte automatiquement le thème de l'OS.
specstr""Données de configuration du graphique. Peut être un ID de configuration, du JSON ou une URL de fichier à distance.
default_tabLiteral["data", "vis"]"vis"Onglet par défaut à afficher lors du chargement de l'interface utilisateur.
**kwargsAny-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

  1. 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.
  2. Personnalisation : Utilisez le paramètre field_specs pour affiner l'interprétation et l'affichage de vos données.
  3. Thématisation : Expérimentez avec différents paramètres theme_key et appearance pour assortir le style de votre application.
  4. 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.

sur shiny