Det är därför ingen överraskning att du kan behöva konvertera en specifik Plotly-figur till en HTML-sträng.
I den här handledningen kommer vi att lära oss hur du använder Plotly io-modulen för att konvertera en figur till en HTML-strängrepresentation.
Låt oss dyka in.
Plotly.io.to_html() funktion
Funktionen to_html() från Plotlys io-modul låter dig skicka en specifik figur som en parameter och konvertera den till en HTML-sträng.
Funktionens syntax uttrycks enligt nedan:
plottrigt. detta . to_html ( fikon , config = Ingen , autospela = Sann , include_plotlyjs = Sann , include_mathjax = Falsk , postskriptum = Ingen , full_html = Sann , animation_opts = Ingen , default_width = '100%' , default_height = '100%' , bekräfta = Sann , div_id = Ingen )
Låt oss utforska funktionsparametrarna nedan:
- Fig – hänvisar till figurobjektet eller ordboksrepresentationen av figuren.
- Config – anger plotly.js konfigurationsalternativ. Skicka konfigurationsalternativen som en ordbok.
- Auto_play – avgör om animeringssekvensen ska spelas upp automatiskt vid sidladdningen. Den här parametern är användbar om du har en figur som innehåller animerade ramar.
- Include_plotlyjs – den här parametern anger hur plotly.js-biblioteket ingår i HTML-koden. Godkända värden i denna parameter inkluderar:
- True – inkluderar plotly.js-biblioteket som en skripttagg i HTML-dokumentet. Detta kommer att öka filstorleken men gör att filen kan användas i offlinemiljöer.
- 'cdn' – om du ställer in include_plotlyjs-parametern till 'cdn' lägger du till en skripttagg som pekar på en fjärrlänk för plotly.js-biblioteket. Använd det här alternativet i en nätverksmiljö eller filstorlekskänslig miljö.
- 'katalog' – innehåller en skripttagg som pekar på ett externt plotly.min.js-paket som finns i samma katalog som HTML-dokumentet.
- 'require' – om du ställer in värdet på require kommer plotly.js-biblioteket att laddas med require.js. Se till att require.js är installerat och tillgängligt globalt på systemet.
- 'False' – inkluderar inte plotly.js-biblioteket. Undvik detta värde när du ställer in full_html-parametern till True eftersom det kommer att göra hela dokumentet oanvändbart.
- include_mathjax – anger om filen ska inkludera mathjax.js-biblioteket. Godkända värden liknar include_plotlyjs förutom värdet 'require'.
- Post_script – låter dig inkludera JavaScript-kodavsnitt som körs efter att plotten skapats.
- Full_html – om sant, kommer funktionen att returnera en sträng som innehåller hela HTML-dokumentet, med början med -taggarna. Om false returnerar funktionen en HTML-sträng som börjar med -elementet.
- Animation_opts – låter dig ange anpassade animeringsegenskaper som en ordbok. Dessa värden skickas sedan till funktionen plotly.animate i plotly.js.
- Default_width – anger standardbredden för den resulterande siffran i pixlar.
- Default_height – anger standardhöjden för figuren i pixlar.
- Validera – avgör om figuren ska valideras innan den konverteras till en HTML-sträng.
- Div_id – anger ett värde för id-attributet för div-taggen där plotten finns.
Sedan returnerar funktionen en strängrepresentation av figuren som en sträng.
Exempel på användning
Följande kod visar hur man använder to_html-funktionen för att konvertera en figur till en HTML-strängrepresentation.
importera plottrigt. uttrycka som px
df = px. data . lager ( indexeras = Sann )
fikon = px. område ( df , facet_col = 'företag' , facet_col_wrap = två )
fikon. show ( )I exemplet ovan börjar vi med att importera Plotly express-modulen som px. Vi skapar sedan en dataram med hjälp av lagerdata från Plotly.
Slutligen skapar vi en fasetterad areaplot med funktionen px.area. Detta bör returnera en siffra som visas nedan:
Vi kan konvertera ovanstående figur till en HTML-strängrepresentation som visas i koden nedan:
importera plottrigt. detta som detta
detta. to_html ( fikon , full_html = Falsk )Att köra koden ovan bör returnera en massiv HTML-sträng som visas i skärmdumpen nedan:
Observera att HTML-dokumentet börjar vid elementet
. Om du vill inkludera hela HTML-filen, ställ in parametern full_html=True som visas: importera plottrigt. detta som detta
detta. to_html ( fikon , full_html = Sann )
Lägg märke till att markeringen börjar vid -taggen.
För att inkludera plotly.js kan vi ställa in parametern som:
importera plottrigt. detta som detta
detta. to_html ( fikon , include_plotlyjs = 'cdn' , full_html = Sann )I exemplet ovan säger vi till funktionen att inkludera plotly.js-biblioteket via en CDN-länk.
Vi kan verifiera detta från utgången nedan:
Det bästa sättet att använda to_html-dokumentet är genom att exportera HTML-strängen till en HTML-fil.
Vi kan göra detta genom att köra en enkel kod som visas nedan:
importera plottrigt. detta som detta
med öppna ( 'facetterad.html' , 'i' ) som f:
f. skrivlinjer ( detta. to_html ( fikon , include_plotlyjs = 'cnd' , full_html = Sann ) )I det här exemplet använder vi filmodulen i Python för att skriva HTML-strängen som en N html-fil.
Vi kan sedan öppna HTML-dokumentet i webbläsaren och se bilden som visas:
Slutsats
Grattis, du har framgångsrikt exporterat din Plotly-figur som en HTML-sträng med funktionen plotly.io.to_html.