Tracer.Io.write_html

«Les documents HTML ne sont rien de nouveau. Ils sont ce qui alimente Internet et tous les sites Web que nous visitons. Par conséquent, vous rencontrerez des cas où vous devez exporter une figure de tracé dans un document HTML. Vous pouvez ensuite partager ce document ou le télécharger sur un serveur Web comme page statique."

Dans cet article, nous explorerons comment nous pouvons utiliser la fonction TO_HTML du module IO Plotly pour exporter une figure en une chaîne HTML.

Syntaxe de fonction et liste de paramètres

La fonction a une syntaxe relativement simple, 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)

Paramètres:

1. Fig - Spécifie la figure à convertir en une chaîne HTML.
2. config - définit l'intrigue.Options de configuration JS.
3. Auto_Play - Spécifie si l'animation de figure, le cas échéant, doit démarrer automatiquement le chargement de la page.
4. include_plotlyjs - définit la méthode dans laquelle l'intrigue.La bibliothèque JS est incluse dans le fichier HTML. Les options acceptées incluent:
   1. Vrai -.JS est inclus comme une balise de script contenant le code source pour l'intrigue.bibliothèque JS. Cela peut conduire à l'utilisation hors ligne des fichiers mais conduit à une grande taille de fichier.
   2. 'cdn' - cette option inclut l'intrigue.La bibliothèque JS comme une balise de script qui fait référence à un lien CDN.
   3. «Répertoire» - Si défini sur un répertoire, la fonction inclura l'intrigue.La bibliothèque JS comme une parcelle externe.min.JS Bundle stocké dans le même répertoire que le fichier HTML.
   4. 'exiger' - si réglé pour exiger,.JS est chargé en utilisant l'exigence.js.
   5. Faux -.JS n'est pas inclus dans le fichier HTML.
5. include_mathjax - spécifie comment le mathjax.La bibliothèque JS est incluse. Les options acceptées sont similaires à l'intrigue.bibliothèque JS.
6. POST_Script - Spécifie les extraits JavaScript inclus dans la div après la création de l'intrigue.
7. Full_html - Définit si la fonction doit convertir la figure en un document HTML entier en commençant par des balises ou une chaîne HTML partielle à commencer par l'élément.
8. Valider - Spécifie si la figure doit être validée avant de se convertir en HTML.

La fonction renverra ensuite une chaîne HTML représentant la figure spécifiée.

Créer un exemple de figure

Avant d'apprendre à convertir une figure en une chaîne HTML, avons des exemples de données que nous pouvons utiliser.

Pour ce tutoriel, nous utiliserons une simple figure Sunburst comme indiqué dans le code ci-dessous:

Importer un terrain.Exprime comme PX
data = dict (
Distros = ['Debian', 'Centos', 'Fedora', 'Red Hat Linux', 'OpenSUSE', 'Qubes', 'SUSE Studio', 'Ubuntu', 'Kubuntu', 'xubuntu'],
Parents = [", 'Red Hat Linux', 'Red Hat Linux',", 'Red Hat Linux', 'Fedora', 'Opensuse', 'Debian', 'Ubuntu', 'Ubuntu']
)
Fig = px.Sunburst (données, noms = «distros», parents = «parents», color = «distros»)
figue.montrer()

Le code ci-dessus doit renvoyer une figure comme indiqué:

Exportation Figure comme chaîne HTML

Pour exporter la figure ci-dessus en tant que chaîne HTML statique, nous pouvons exécuter le code comme indiqué:

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

Le code ci-dessus renverra une chaîne HTML représentant le tracé de Sunburst ci-dessus. Gardez à l'esprit que la chaîne HTML inclura l'intrigue.La bibliothèque JS comme CDN spécifié ci-dessus.

De la sortie ci-dessus, nous pouvons voir que le document HTML commence à l'élément.

Pour générer un document HTML complet, nous pouvons définir le paramètre full_html sur true comme indiqué:

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

Enregistrer la chaîne HTML dans le fichier

Une caractéristique utile de la fonction TO_HTML est d'écrire la chaîne HTML résultante à un fichier HTML.

Un exemple est comme indiqué:

Importer un terrain.Io comme io
avec ouvert ('Sunburst.html ',' w ') comme f:
F.Écrire (IO.to_html (fig, include_plotlyjs = 'cdn', full_html = true))

Le code ci-dessus doit écrire la chaîne HTML de la fonction à_html dans le Sunburst.fichier html.

Vous pouvez ensuite afficher ce fichier en l'ouvrant dans votre navigateur.

Puisque nous incluons l'intrigue.La bibliothèque JS en tant que CDN, vous aurez besoin d'une connexion réseau pour que la bibliothèque puisse télécharger et obtenir l'interactivité complète de la figure.

Conclusion

Dans cet article, nous avons appris comment convertir une figure d'intrigue en une chaîne HTML à l'aide de l'IO.fonction à_html ().

Merci d'avoir lu et codage heureux!!