Tramamente.IO.write_html

"Los documentos HTML no son nada nuevo. Son lo que impulsa Internet y todos los sitios web que visitamos. Por lo tanto, se encontrará con casos en los que necesite exportar una figura complementaria en un documento HTML. Luego puede compartir ese documento o subirlo a un servidor web como una página estática."

En este artículo, exploraremos cómo podemos usar la función TO_HTML del módulo IO Plotly para exportar una figura en una cadena HTML.

Sintaxis de funciones y lista de parámetros

La función tiene una sintaxis relativamente simple, como se muestra a continuación:

tramamente.IO.to_html (fig, config = none, auto_play = true, include_plotlyjs = true, include_mathjax = false, post_script = none, full_html = true, animation_opts = none, default_width = '100%', default_height = '100%', validato = true,, div_id = ninguno)

Parámetros:

1. Fig: especifica que la figura se convierta en una cadena HTML.
2. config: define la trama.Opciones de configuración de JS.
3. auto_play: especifica si la animación de la figura, si la hay, debe comenzar automáticamente después de la carga de la página.
4. include_plotlyjs: define el método en el que traza.La biblioteca JS está incluida en el archivo HTML. Las opciones aceptadas incluyen:
   1. Verdadero - Plotly.JS se incluye como una etiqueta de script que contiene el código fuente para la trama.Biblioteca JS. Esto puede conducir al uso fuera de línea de los archivos, pero conduce a un tamaño de archivo grande.
   2. 'CDN': esta opción incluye la trama.JS Library como una etiqueta de script que hace referencia a un enlace CDN.
   3. 'Directorio': si se establece en un directorio, la función incluirá la trama.JS Library como una trama externa.mínimo.JS Bundle almacenado en el mismo directorio que el archivo HTML.
   4. 'requerir' - si se establece para requerir, complemente.JS está cargado usando requerir.js.
   5. Falso - Plotly.JS no está incluido en el archivo HTML.
5. include_mathjax: especifica cómo el mathjax.La biblioteca JS está incluida. Las opciones aceptadas son similares a la trama.Biblioteca JS.
6. post_script: especifica los fragmentos de JavaScript incluidos en la creación de la trama DIV después de.
7. Full_html: establece si la función debe convertir la figura en un documento HTML completo que comienza con etiquetas o una cadena HTML parcial que comienza con el elemento.
8. Validar: especifica si la cifra debe validarse antes de convertirse en HTML.

La función devolverá una cadena HTML que representa la figura especificada.

Crear figura de muestra

Antes de aprender cómo convertir una cifra en una cadena HTML, tengamos datos de muestra que podamos usar.

Para este tutorial, utilizaremos una figura simple de Hurburst como se muestra en el código a continuación:

Importar trama.expresar como PX
datos = dict (
distribuys = ['Debian', 'Centos', 'Fedora', 'Red Hat Linux', 'OpenSuse', 'Qubes', 'Suse Studio', 'Ubuntu', 'Kubuntu', 'Xubuntu']],
Padres = [", 'Red Hat Linux', 'Red Hat Linux',", 'Red Hat Linux', 'Fedora', 'OpenSuse', 'Debian', 'Ubuntu', 'Ubuntu']
)
Fig = PX.SunBurst (Data, Names = 'Distros', Padres = 'Padres', Color = 'Distross')
higo.espectáculo()

El código anterior debe devolver una figura como se muestra:

Figura de exportación como cadena HTML

Para exportar la figura anterior como una cadena HTML estática, podemos ejecutar el código como se muestra:

Importar trama.io como io
IO.to_html (fig, include_plotlyjs = 'cdn')

El código anterior devolverá una cadena HTML que representa la gráfica de SunBurst de arriba anterior. Tenga en cuenta que la cadena HTML incluirá la trama.JS Biblioteca como CDN como se especifica anteriormente.

De la salida anterior, podemos ver que el documento HTML comienza en el elemento.

Para generar un documento HTML completo, podemos establecer el parámetro Full_html en True como se muestra:

Importar trama.io como io
IO.to_html (fig, include_plotlyjs = 'cdn', full_html = true)

Guardar la cadena HTML en el archivo

Una característica útil de la función TO_HTML es escribir la cadena HTML resultante en un archivo HTML.

Un ejemplo es como se muestra:

Importar trama.io como io
con abierto ('Sunburst.html ',' w ') como f:
F.Escribir (IO.to_html (fig, include_plotlyjs = 'cdn', full_html = true)))

El código anterior debe escribir la cadena HTML desde la función To_html en el Sunburst.archivo html.

Luego puede ver este archivo abriéndolo en su navegador.

Dado que incluimos la trama.JS Library como CDN, necesitará una conexión de red para que la biblioteca descargue y obtenga la interactividad completa de la figura.

Conclusión

En este artículo, aprendimos cómo podríamos convertir una figura complentamente en una cadena HTML usando el IO.función to_html ().

Gracias por leer y feliz codificación!!