Plotly.io.to_html

Plotly Io To Html



Hüperteksti märgistuskeel ehk HTML-dokumendid on märgistusdokumendid, mis võimaldavad kuvada teavet veebis. Kui vaatate konkreetset veebisaiti, kasutate HTML-dokumenti.

Seetõttu pole üllatav, et peate võib-olla teisendama konkreetse Plotly kujundi HTML-stringiks.

Selles õpetuses õpime kasutama Plotly io moodulit kujundi teisendamiseks HTML-stringi esitusviisiks.







Sukeldume sisse.



Funktsioon Plotly.io.to_html().

Plotly io mooduli funktsioon to_html() võimaldab teil parameetrina edastada konkreetse joonise ja teisendada selle HTML-stringiks.



Funktsiooni süntaks on väljendatud järgmiselt:





süžeeliselt. see . to_html ( joon , konfig = Mitte ühtegi , auto_play = Tõsi , include_plotlyjs = Tõsi , include_mathjax = Vale , post_script = Mitte ühtegi , full_html = Tõsi , animatsiooni_valikud = Mitte ühtegi , vaikimisi_laius = '100%' , vaikekõrgus = '100%' , kinnitada = Tõsi , divi_id = Mitte ühtegi )

Uurime funktsiooni parameetreid allpool:

  1. Joonis – viitab figuuriobjektile või kujundi sõnastikuesitlusele.
  2. Config – määrab plotly.js konfiguratsioonisuvandid. Edastage konfiguratsioonivalikud sõnaraamatuna.
  3. Auto_play – määrab, kas animatsiooni jada esitatakse lehe laadimisel automaatselt. See parameeter on kasulik, kui teil on joonis, mis sisaldab animeeritud kaadreid.
  4. Include_plotlyjs – see parameeter määrab, kuidas teek plotly.js kaasatakse HTML-i. Selle parameetri aktsepteeritud väärtused hõlmavad järgmist:
    • Tõsi – sisaldab HTML-dokumendis skriptimärgendina teeki plotly.js. See suurendab faili suurust, kuid võimaldab faili kasutada võrguühenduseta keskkondades.
    • „cdn” – parameetri include_plotlyjs määramine väärtusele „cdn” lisab skriptimärgendi, mis osutab teegi plotly.js kauglingile. Kasutage seda suvandit võrgukeskkonnas või failisuurusetundlikus keskkonnas.
    • „kataloog” – sisaldab skriptimärgendit, mis osutab välisele plotly.min.js paketile, mis asub HTML-dokumendiga samas kataloogis.
    • 'require' – kui määrate väärtuse nõue, laaditakse teek plotly.js, kasutades request.js'i. Veenduge, et fail request.js oleks installitud ja süsteemis globaalselt saadaval.
    • „False” – ei sisalda teeki plotly.js. Vältige seda väärtust, kui määrate parameetri full_html väärtuseks Tõene, kuna see muudab kogu dokumendi kasutuskõlbmatuks.
  5. include_mathjax – määrab, kas fail peaks sisaldama teeki mathjax.js. Aktsepteeritud väärtused on sarnased väärtusele include_plotlyjs, välja arvatud väärtus 'require'.
  6. Post_script – võimaldab lisada JavaScripti katkendeid, mis käivitatakse pärast süžee loomist.
  7. Full_html – kui see on tõene, tagastab funktsioon stringi, mis sisaldab kogu HTML-dokumenti, alustades siltidest . Kui Väär, tagastab funktsioon HTML-stringi, mis algab elemendiga
    .
  8. Animation_opts – võimaldab sõnaraamatuna määrata kohandatud animatsiooni atribuute. Need väärtused edastatakse seejärel faili plotly.js funktsioonile plotly.animate.
  9. Default_width – määrab tulemuseks oleva joonise vaikelaiuse pikslites.
  10. Default_height – määrab joonise vaikekõrguse pikslites.
  11. Valida – määrab, kas kujund tuleb enne HTML-stringiks teisendamist kontrollida.
  12. Div_id – määrab graafiku asukohas oleva div märgendi id atribuudi väärtuse.

Seejärel tagastab funktsioon joonise stringi esituse stringina.



Kasutamise näide

Järgmine kood näitab, kuidas kasutada funktsiooni to_html joonise teisendamiseks HTML-stringi esitusviisiks.

importida süžeeliselt. väljendada nagu px

df = px. andmeid . aktsiad ( indekseeritud = Tõsi )

joon = px. ala ( df , tahk_col = 'firma' , tahk_col_wrap = kaks )

joon. näidata ( )

Ülaltoodud näites alustame Plotly expressi mooduli importimisest kui px. Seejärel loome andmeraami, kasutades Plotly aktsiaandmeid.

Lõpuks loome lihvitud ala graafiku, kasutades funktsiooni px.area. See peaks tagastama joonise, nagu allpool näidatud:

Saame ülaltoodud joonise teisendada HTML-stringi esitusviisiks, nagu on näidatud allolevas koodis:

importida süžeeliselt. see nagu see

see. to_html ( joon , full_html = Vale )

Ülaltoodud koodi käivitamine peaks tagastama tohutu HTML-stringi, nagu on näidatud alloleval ekraanipildil:

Pange tähele, et HTML-dokument algab elemendist

. Kui soovite kaasata kogu HTML-faili, määrake parameeter full_html=True, nagu näidatud:

importida süžeeliselt. see nagu see

see. to_html ( joon , full_html = Tõsi )

Pange tähele, et märgistus algab märgendist .

Plotly.js kaasamiseks saame määrata parameetri järgmiselt:

importida süžeeliselt. see nagu see

see. to_html ( joon , include_plotlyjs = 'cdn' , full_html = Tõsi )

Ülaltoodud näites käsime funktsioonil kaasata teegi plotly.js CDN-i lingi kaudu.

Saame seda kontrollida alloleva väljundi põhjal:

Parim viis to_html-dokumendi kasutamiseks on HTML-stringi eksportimine HTML-faili.

Saame seda teha, käivitades lihtsa koodi, nagu allpool näidatud:

importida süžeeliselt. see nagu see

koos avatud ( 'facetted.html' , 'sisse' ) nagu f:

f. kirjaridad ( see. to_html ( joon , include_plotlyjs = 'cnd' , full_html = Tõsi ) )

Selles näites kasutame Pythoni failimoodulit HTML-stringi N html-failina kirjutamiseks.

Seejärel saame avada brauseris HTML-dokumendi ja vaadata joonist, nagu näidatud:

Järeldus

Õnnitleme, olete edukalt eksportinud oma Plotly kujundi HTML-stringina, kasutades funktsiooni plotly.io.to_html.