Plotly.io.write_html

“I documenti HTML non sono una novità. Sono ciò che alimenta Internet e tutti i siti Web che visitiamo. Pertanto, ti imbatterai in casi in cui è necessario esportare una figura con una trama in un documento HTML. È quindi possibile condividere quel documento o caricarlo su un server Web come pagina statica."

In questo articolo, esploreremo come possiamo usare la funzione TO_HTML dal modulo Plotly IO per esportare una figura in una stringa HTML.

Elenco di sintassi e parametri della funzione

La funzione ha una sintassi relativamente semplice, 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)

Parametri:

1. Fig - Specifica la figura da convertire in una stringa HTML.
2. config - definisce la crema.Opzioni di configurazione JS.
3. AUTO_PLAY - Specifica se l'animazione della figura, se presente, deve iniziare automaticamente dopo il caricamento della pagina.
4. include_plotlyjs - definisce il metodo in cui il trama.La libreria JS è inclusa nel file HTML. Le opzioni accettate includono:
   1. Vero - Plotly.JS è incluso come un tag di script contenente il codice sorgente per il trama.Biblioteca JS. Ciò può portare all'uso offline dei file ma porta a una dimensione di un file elevato.
   2. 'CDN' - Questa opzione include la trama.Biblioteca JS come tag di script che fa riferimento a un link CDN.
   3. "Directory" - Se impostata su una directory, la funzione includerà la trama.Biblioteca JS come una trama esterna.min.Bundle JS memorizzato nella stessa directory del file HTML.
   4. 'requisite' - se impostato per richiedere, trama.JS viene caricato utilizzando Requisito.js.
   5. Falso - Plotly.JS non è incluso nel file HTML.
5. Include_mathjax - Specifica come la Mathjax.La libreria JS è inclusa. Le opzioni accettate sono simili al trama.Biblioteca JS.
6. Post_Script - Specifica gli snippet JavaScript inclusi nel Div dopo la creazione della trama.
7. Full_html - Imposta se la funzione deve convertire la figura in un intero documento HTML che inizia con tag o una stringa HTML parziale che inizia con l'elemento.
8. Convalida: specifica se la figura deve essere validata prima di convertire in HTML.

La funzione restituirà quindi una stringa HTML che rappresenta la figura specificata.

Crea una figura di esempio

Prima di imparare come convertire una figura in una stringa HTML, lascia che possano utilizzare i dati di esempio.

Per questo tutorial, useremo una semplice figura di Sunburst come mostrato nel codice seguente:

importazione della trama.esprimere come px
data = dict (
Distros = ['Debian', 'Centos', 'Fedora', 'Red Hat Linux', 'Opensuse', 'Qubes', 'Suse Studio', 'Ubuntu', 'Kubuntu', 'Xubuntu'],
genitori = ["," Red Hat Linux "," Red Hat Linux ",", "Red Hat Linux", "Fedora", "Opensuse", "Debian", "Ubuntu", "Ubuntu"]
)
FIG = px.SunBurst (Data, nams = 'Distros', Parents = 'Parents', Color = 'Distros')
Fico.spettacolo()

Il codice sopra dovrebbe restituire una figura come mostrato:

Figura di esportazione come stringa HTML

Per esportare la figura sopra come una stringa HTML statica, possiamo eseguire il codice come mostrato:

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

Il codice sopra restituirà una stringa HTML che rappresenta la trama di Sunburst sopra. Tieni presente che la stringa HTML includerà la trama.Libreria JS come CDN come sopra specificato.

Dall'output sopra, possiamo vedere che il documento HTML inizia dall'elemento.

Per generare un documento HTML completo, possiamo impostare il parametro full_html su True come mostrato:

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

Salva la stringa html su file

Una funzionalità utile della funzione TO_HTML è la scrittura della stringa HTML risultante in un file HTML.

Un esempio è come mostrato:

importazione della trama.io come io
con Open ('Sunburst.html ',' w ') come f:
F.Scrivi (io.to_html (fig, include_plotlyjs = 'cdn', full_html = true))

Il codice sopra dovrebbe scrivere la stringa HTML dalla funzione TO_HTML nel SUNBURST.file html.

Puoi quindi visualizzare questo file aprendolo nel browser.

Dal momento che includiamo la trama.Biblioteca JS come CDN, avrai bisogno di una connessione di rete per la libreria per scaricare e ottenere la piena interattività della figura.

Conclusione

In questo articolo, abbiamo imparato come potremmo convertire una traccia in una stringa HTML usando l'IO.funzione to_html ().

Grazie per la lettura e la codifica felice!!