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:
- Joonis – viitab figuuriobjektile või kujundi sõnastikuesitlusele.
- Config – määrab plotly.js konfiguratsioonisuvandid. Edastage konfiguratsioonivalikud sõnaraamatuna.
- Auto_play – määrab, kas animatsiooni jada esitatakse lehe laadimisel automaatselt. See parameeter on kasulik, kui teil on joonis, mis sisaldab animeeritud kaadreid.
- 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.
- 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'.
- Post_script – võimaldab lisada JavaScripti katkendeid, mis käivitatakse pärast süžee loomist.
- 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 .
- Animation_opts – võimaldab sõnaraamatuna määrata kohandatud animatsiooni atribuute. Need väärtused edastatakse seejärel faili plotly.js funktsioonile plotly.animate.
- Default_width – määrab tulemuseks oleva joonise vaikelaiuse pikslites.
- Default_height – määrab joonise vaikekõrguse pikslites.
- Valida – määrab, kas kujund tuleb enne HTML-stringiks teisendamist kontrollida.
- 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.