Plotly.io.to_html

La lingua di markup ipertestuale o i documenti HTML sono documenti di markup che consentono di visualizzare informazioni sul World Wide Web. Quando si visualizza un sito Web specifico, si utilizza un documento HTML.

Non sorprende quindi che tu possa dover convertire una figura specifica in una stringa HTML.

In questo tutorial, impareremo come utilizzare il modulo Plotly IO per convertire una figura in una rappresentazione di stringa HTML.

Immerciamoci.

Plotly.io.funzione to_html ()

La funzione TO_HTML () dal modulo IO di Plotly ti consente di passare una figura specifica come parametro e convertirla in una stringa HTML.

La sintassi della funzione è espressa come mostrato di seguito:

Plotly.io.to_html (Fig, config = none, Auto_play = true, include_plotlyjs = true, include_mathjax = false, post_script = nessuno, full_html = true, animation_opts = nessuna, default_width = '100%', default_height = '100%', valida div_id = nessuno)

Esploriamo i parametri della funzione, di seguito:

1. Fig - si riferisce all'oggetto figura o alla rappresentazione del dizionario della figura.
2. Config - Specifica la trama.Opzioni di configurazione JS. Passa le opzioni di configurazione come dizionario.
3. AUTO_PLAY - Determina se la sequenza di animazione deve riprodurre automaticamente sul caricamento della pagina. Questo parametro è utile se si dispone di una figura contenente cornici animate.
4. Include_plotlyjs - Questo parametro specifica come il trama.La libreria JS è inclusa nell'HTML. I valori accettati in questo parametro includono:
   • Vero: include la trama.Libreria JS come tag di script nel documento HTML. Ciò aumenterà la dimensione del file ma consentirà di utilizzare il file in ambienti offline.
   • 'cdn' - Impostazione del parametro include_plotlyjs su 'cdn' aggiungerà un tag di script che punta a un collegamento remoto per la trama.Biblioteca JS. Usa questa opzione quando in un ambiente in rete o un ambiente sensibile alle dimensioni del file.
   • "Directory" - Include un tag di script che indica una trama esterna.min.Bundle JS situato nella stessa directory del documento HTML.
   • 'requisite' - Impostazione del valore da richiedere caricerà il tracciamento.Libreria JS che utilizza Requisito.js. Assicurarsi che richiedano.JS è installato e disponibile a livello globale sul sistema.
   • 'False' - non include la trama.Biblioteca JS. Evita questo valore quando si imposta il parametro full_html su True in quanto renderà l'intero documento, inutilizzabile.
5. Include_mathjax - Specifica se il file deve includere il Mathjax.Biblioteca JS. I valori accettati sono simili a include_plotlyjs tranne il valore "richiedere".
6. Post_script - ti consente di includere frammenti JavaScript che vengono eseguiti dopo la creazione della trama.
7. Full_html - Se true, la funzione restituirà una stringa contenente l'intero documento HTML, a partire dai tag. Se false, la funzione restituirà una stringa HTML a partire dall'elemento.
8. Animation_opts - consente di specificare le proprietà di animazione personalizzate come dizionario. Questi valori vengono quindi passati alla trama.Animate Function in Plotly.js.
9. Default_Width - Specifica la larghezza predefinita della figura risultante nei pixel.
10. Default_height - Specifica l'altezza predefinita della figura in pixel.
11. Convalida: determina se la figura deve essere validata prima di essere convertita in una stringa HTML.
12. Div_id - Specifica un valore dell'attributo ID del tag DIV in cui si trova la trama.

Quindi, la funzione restituisce una rappresentazione della stringa della figura come stringa.

Esempio di utilizzo

Il seguente codice mostra come utilizzare la funzione TO_HTML per convertire una figura in una rappresentazione di stringa HTML.

importazione della trama.esprimere come px
df = px.dati.Stocks (indicizzato = true)
FIG = px.area (df, facet_col = 'società', facet_col_wrap = 2)
Fico.spettacolo()

Nell'esempio sopra, iniziamo importando il modulo Express come PX. Creiamo quindi un frame di dati utilizzando i dati di serie da Plotly.

Infine, creiamo un diagramma di area sfaccettato usando il PX.funzione di area. Questo dovrebbe restituire una figura come mostrato di seguito:

Possiamo convertire la figura sopra in una rappresentazione della stringa HTML come mostrato nel codice seguente:

importazione della trama.io come io
io.to_html (fig, full_html = false)

L'esecuzione del codice sopra dovrebbe restituire un'enorme stringa HTML come mostrato nello screenshot seguente:

Si noti che il documento HTML inizia dall'elemento. Se si desidera includere l'intero file HTML, imposta il parametro full_html = true come mostrato:

importazione della trama.io come io
io.to_html (fig, full_html = true)

Si noti che il markup inizia dal tag.

Per includere la trama.JS, possiamo impostare il parametro come:

importazione della trama.io come io
io.to_html (fig, include_plotlyjs = 'cdn', full_html = true)

Nell'esempio sopra, diciamo alla funzione di includere la trama.Libreria JS tramite un collegamento CDN.

Possiamo verificarlo dall'output di seguito:

Il modo migliore per utilizzare il documento TO_HTML è esportando la stringa HTML in un file HTML.

Possiamo farlo eseguendo un codice semplice come mostrato di seguito:

importazione della trama.io come io
con open ('sfaccettato.html ',' w ') come f:
F.WriteLines (IO.to_html (fig, include_plotlyjs = 'cnd', full_html = true))

In questo esempio, utilizziamo il modulo file in Python per scrivere la stringa HTML come file HTML.

Possiamo quindi aprire il documento HTML nel browser e visualizzare la figura come mostrato:

Conclusione

Congratulazioni, hai esportato con successo la tua figura di trama come una stringa HTML usando la trama.io.funzione to_html.