Tramamente.IO.to_html

El lenguaje de marcado de hipertexto o los documentos HTML son documentos de marcado que le permiten mostrar información en la World Wide Web. Cuando está viendo un sitio web específico, está utilizando un documento HTML.

Por lo tanto, no sorprende que necesite convertir una figura complicada específica en una cadena HTML.

En este tutorial, aprenderemos cómo usar el módulo IO Plotly para convertir una figura en una representación de cadena HTML.

Vamos a sumergirnos.

Tramamente.IO.función to_html ()

La función To_html () del módulo IO de Plotly le permite pasar una figura específica como parámetro y convertirla en una cadena HTML.

La sintaxis de la función se expresa 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)

Exploremos los parámetros de la función, a continuación:

1. Fig: se refiere al objeto de la figura o a la representación del diccionario de la figura.
2. Config: especifica la trama.Opciones de configuración de JS. Pasar las opciones de configuración como diccionario.
3. Auto_play: determina si la secuencia de animación debe reproducirse automáticamente en la carga de la página. Este parámetro es útil si tiene una figura que contiene marcos animados.
4. Include_plotlyjs: este parámetro especifica cómo la trama.La biblioteca JS está incluida en el HTML. Los valores aceptados en este parámetro incluyen:
   • Verdadero - Incluye el Plotly.JS Library como etiqueta de script en el documento HTML. Esto aumentará el tamaño del archivo, pero permitirá que el archivo se use en entornos fuera de línea.
   • 'CDN': la configuración del parámetro incluir_plotlyjs a 'CDN' agregará una etiqueta de script que apunta a un enlace remoto para la trama.Biblioteca JS. Use esta opción cuando esté en un entorno en red o un entorno sensible al tamaño del archivo.
   • 'Directorio': incluye una etiqueta de script que apunta a una trama externa.mínimo.Js Bundle ubicado en el mismo directorio que el documento HTML.
   • 'requerir': establecer el valor para requerir cargará el complemento.Biblioteca JS usando requerir.js. Asegúrese de que requiere.JS está instalado y disponible a nivel mundial en el sistema.
   • 'Falso' - no incluye la trama.Biblioteca JS. Evite este valor al configurar el parámetro Full_HTML en verdadero, ya que hará todo el documento, inutilizable.
5. include_mathjax: especifica si el archivo debe incluir el mathJax.Biblioteca JS. Los valores aceptados son similares a incluir_plotlyjs, excepto el valor 'requerir'.
6. Post_script: le permite incluir fragmentos de JavaScript que se ejecutan después de la creación de la trama.
7. Full_html: si es verdadero, la función devolverá una cadena que contiene todo el documento HTML, comenzando con las etiquetas. Si False, la función devolverá una cadena HTML que comienza con el elemento.
8. Animation_opts: le permite especificar propiedades de animación personalizadas como diccionario. Estos valores se pasan a la trama.Función animada en Plotly.js.
9. Default_width: especifica el ancho predeterminado de la figura resultante en píxeles.
10. Default_Height: especifica la altura predeterminada de la figura en píxeles.
11. Validar: determina si la figura debe validarse antes de convertirse en una cadena HTML.
12. Div_id: especifica un valor del atributo de identificación de la etiqueta DIV donde se encuentra el gráfico.

Luego, la función devuelve una representación de cadena de la figura como una cadena.

Uso de ejemplo

El siguiente código muestra cómo usar la función TO_HTML para convertir una figura en una representación de cadena HTML.

Importar trama.expresar como PX
DF = PX.datos.existencias (indexado = verdadero)
Fig = PX.área (DF, facet_col = 'Company', FACET_COL_WRAP = 2)
higo.espectáculo()

En el ejemplo anterior, comenzamos importando el módulo Express Plotly como PX. Luego creamos un marco de datos utilizando los datos de stock de Plotly.

Finalmente, creamos una parcela de área facetada usando el PX.función de área. Esto debería devolver una figura como se muestra a continuación:

Podemos convertir la figura anterior en una representación de cadena HTML como se muestra en el código a continuación:

Importar trama.io como io
IO.to_html (fig, full_html = falso)

Ejecutar el código anterior debe devolver una cadena HTML masiva como se muestra en la captura de pantalla a continuación:

Tenga en cuenta que el documento HTML comienza en el elemento. Si desea incluir el archivo HTML completo, establezca el parámetro full_html = true como se muestra:

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

Observe que el marcado comienza en la etiqueta.

Para incluir Plotly.JS, podemos establecer el parámetro como:

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

En el ejemplo anterior, le decimos a la función que incluya la trama.Biblioteca JS a través de un enlace CDN.

Podemos verificar esto desde la siguiente salida:

La mejor manera de usar el documento TO_HTML es exportando la cadena HTML en un archivo HTML.

Podemos hacer esto ejecutando un código simple como se muestra a continuación:

Importar trama.io como io
con abierto ('facetado.html ',' w ') como f:
F.WriteLines (IO.to_html (fig, include_plotlyjs = 'cnd', full_html = true)))

En este ejemplo, usamos el módulo de archivo en Python para escribir la cadena HTML como un archivo HTML.

Luego podemos abrir el documento HTML en el navegador y ver la figura como se muestra:

Conclusión

Felicitaciones, ha exportado con éxito su cifra de trama como una cadena HTML utilizando la trama.IO.función to_html.