Tracer.Io.to_html

La langue de balisage hypertexte ou les documents HTML sont des documents de balisage qui vous permettent d'afficher des informations sur le World Wide Web. Lorsque vous consultez un site Web spécifique, vous utilisez un document HTML.

Il n'est donc pas surprenant que vous puissiez convertir une figure spécifique en une chaîne HTML.

Dans ce tutoriel, nous apprendrons à utiliser le module IO Plotly pour convertir une figure en une représentation de chaîne HTML.

Plongeons-nous dans.

Tracer.Io.fonction à_html ()

La fonction to_html () du module IO de Plotly vous permet de passer une figure spécifique en tant que paramètre et de le convertir en une chaîne HTML.

La syntaxe de fonction est exprimée comme indiqué ci-dessous:

tracer.Io.to_html (fig, config = non, auto_play = true, include_plotlyjs = true, include_mathjax = false, post_script = non, full_html = true, animation_opts = non, default_width = '100%', default_height = '100%', valide = true, div_id = aucun)

Explorons les paramètres de fonction ci-dessous:

1. Fig - fait référence à l'objet de figure ou à la représentation du dictionnaire de la figure.
2. Config - spécifie le tracé.Options de configuration JS. Passez les options de configuration en tant que dictionnaire.
3. Auto_play - détermine si la séquence d'animation doit jouer automatiquement sur le chargement de la page. Ce paramètre est utile si vous avez une figure contenant des cadres animés.
4. Include_plotlyjs - Ce paramètre spécifie comment le tracé.La bibliothèque JS est incluse dans le HTML. Les valeurs acceptées dans ce paramètre incluent:
   • Vrai - inclut l'intrigue.La bibliothèque JS comme balise de script dans le document HTML. Cela augmentera la taille du fichier mais permettra au fichier d'être utilisé dans des environnements hors ligne.
   • 'cdn' - Définition du paramètre inclut_plotlyjs sur 'cdn' ajoutera une balise de script pointant vers un lien distant pour l'intrigue.bibliothèque JS. Utilisez cette option dans un environnement en réseau ou un environnement sensible à la taille du fichier.
   • 'Directory' - inclut une balise de script qui pointe vers un tracé externe.min.JS Bundle situé dans le même répertoire que le document HTML.
   • 'exiger' - régler la valeur à exiger.La bibliothèque JS utilisant l'exigence.js. S'assurer que cela nécessite.JS est installé et disponible à l'échelle mondiale sur le système.
   • 'False' - n'inclut pas l'intrigue.bibliothèque JS. Évitez cette valeur lors de la définition du paramètre full_html.
5. include_mathjax - Spécifie si le fichier doit inclure le mathjax.bibliothèque JS. Les valeurs acceptées sont similaires à l'inclure_plotlyjs sauf la valeur «requise».
6. Post_script - vous permet d'inclure des extraits JavaScript qui sont exécutés après la création de tracé.
7. Full_html - Si vrai, la fonction renverra une chaîne contenant l'intégralité du document HTML, en commençant par les balises. Si false, la fonction renverra une chaîne HTML à commencer par l'élément.
8. Animation_opts - vous permet de spécifier les propriétés d'animation personnalisées en tant que dictionnaire. Ces valeurs sont ensuite transmises à l'intrigue.animer la fonction dans l'intrigue.js.
9. Default_width - Spécifie la largeur par défaut du chiffre résultant en pixels.
10. Default_height - Spécifie la hauteur par défaut de la figure en pixels.
11. Valider - détermine si la figure doit être validée avant d'être convertie en une chaîne HTML.
12. Div_id - spécifie une valeur de l'attribut ID de la balise div où se trouve le tracé.

Ensuite, la fonction renvoie une représentation de chaîne de la figure en tant que chaîne.

Exemple d'utilisation

Le code suivant montre comment utiliser la fonction TO_HTML pour convertir une figure en une représentation de chaîne HTML.

Importer un terrain.Exprime comme PX
df = px.données.actions (indexé = true)
Fig = px.Zone (DF, FACET_COL = 'Company', FACET_COL_WRAP = 2)
figue.montrer()

Dans l'exemple ci-dessus, nous commençons par importer le module Plotly Express comme PX. Nous créons ensuite un cadre de données à l'aide des données de stock à partir de l'intrigue.

Enfin, nous créons un tracé de zone à facettes en utilisant le PX.fonction de zone. Cela devrait renvoyer une figure comme indiqué ci-dessous:

Nous pouvons convertir la figure ci-dessus en une représentation de chaîne HTML comme indiqué dans le code ci-dessous:

Importer un terrain.Io comme io
Io.to_html (fig, full_html = false)

L'exécution du code ci-dessus doit renvoyer une chaîne HTML massive comme indiqué dans la capture d'écran ci-dessous:

Notez que le document HTML commence à l'élément. Si vous souhaitez inclure l'intégralité du fichier HTML, définissez le paramètre full_html = true comme indiqué:

Importer un terrain.Io comme io
Io.to_html (fig, full_html = true)

Remarquez que le balisage commence à la balise.

Inclure l'intrigue.JS, nous pouvons définir le paramètre comme:

Importer un terrain.Io comme io
Io.to_html (Fig, include_plotlyjs = 'cdn', full_html = true)

Dans l'exemple ci-dessus, nous disons à la fonction d'inclure l'intrigue.bibliothèque JS via un lien CDN.

Nous pouvons le vérifier à partir de la sortie ci-dessous:

La meilleure façon d'utiliser le document TO_HTML est en exportant la chaîne HTML dans un fichier HTML.

Nous pouvons le faire en exécutant un code simple comme indiqué ci-dessous:

Importer un terrain.Io comme io
avec ouvert ('facetted.html ',' w ') comme f:
F.écrivains (IO.to_html (Fig, include_plotlyjs = 'cnd', full_html = true))

Dans cet exemple, nous utilisons le module de fichier dans Python pour écrire la chaîne HTML en tant que fichier html.

Nous pouvons ensuite ouvrir le document HTML dans le navigateur et afficher la figure comme indiqué:

Conclusion

Félicitations, vous avez réussi à exporter votre silhouette sous forme de chaîne HTML en utilisant l'intrigue.Io.Fonction TO_HTML.