Spiski.io.to_html

Hypertext Marka Language lub dokumenty HTML to dokumenty znaczników, które pozwalają wyświetlać informacje w sieci WWW na całym świecie. Podczas przeglądania określonej strony internetowej używasz dokumentu HTML.

Nie jest zatem zaskoczeniem, że może być konieczne przekonwertowanie określonej figury na ciąg HTML.

W tym samouczku nauczymy się, jak używać modułu IO, aby przekonwertować figurę na reprezentację łańcucha HTML.

Zanurzmy się.

Spiski.io.to_html () funkcja

Funkcja to_html () z modułu IO Plotly pozwala przekazać określoną liczbę jako parametr i przekonwertować na ciąg HTML.

Składnia funkcji jest wyrażona, jak pokazano poniżej:

spiski.io.to_html (ryc, config = none, auto_play = true, include_plotlyJS = true, include_mathjax = false, post_script = none, full_html = true, animation_opts = brak, default_width = '100%', default_height = '100%', valiate = true, true, div_id = brak)

Zbadajmy parametry funkcji poniżej:

1. Rysunek - odnosi się do obiektu rysunkowego lub reprezentacji słownika rysunku.
2. Config - określa plotly.Opcje konfiguracji JS. Przekaż opcje konfiguracji jako słownik.
3. Auto_play - określa, czy sekwencja animacji powinna odtwarzać automatycznie na obciążeniu strony. Ten parametr jest przydatny, jeśli masz figurę zawierającą animowane ramki.
4. Ableal_plotlyjs - ten parametr określa, w jaki sposób spiski.Biblioteka JS jest zawarta w HTML. Zaakceptowane wartości w tym parametrze obejmują:
   • True - obejmuje spiski.Biblioteka JS jako znacznik skryptu w dokumencie HTML. Zwiększy to rozmiar pliku, ale pozwoli na użycie pliku w środowiskach offline.
   • „CDN” - Ustawienie parametru w conclude_plotlyJS na „cdn” doda znacznik skryptu wskazujący na zdalny link dla plotly.Biblioteka JS. Użyj tej opcji, gdy jest w środowisku sieciowym lub wrażliwym na rozmiar plików.
   • „Directory” - zawiera znacznik skryptu, który wskazuje na zewnętrzny spiski.min.pakiet JS znajdujący się w tym samym katalogu co dokument HTML.
   • „Wymagaj” - Ustawienie wymaganej wartości będzie załadować spiski.Biblioteka JS za pomocą wymagań.JS. Upewnij się, że to wymagają.JS jest zainstalowany i dostępny na całym świecie w systemie.
   • „Fałsz” - nie obejmuje plotly.Biblioteka JS. Unikaj tej wartości podczas ustawiania parametru Full_Html na true, ponieważ będzie on czyni cały dokument, bezużyteczny.
5. include_mathjax - Określa, czy plik powinien zawierać MathJax.Biblioteka JS. Zaakceptowane wartości są podobne do include_plotlyjs, z wyjątkiem wartości „wymagania”.
6. Post_script - pozwala dołączyć fragmenty JavaScript, które są wykonywane po tworzeniu fabuły.
7. Full_html - Jeśli prawda, funkcja zwróci ciąg zawierający cały dokument HTML, zaczynając od znaczników. Jeśli Fałsz, funkcja zwróci ciąg HTML, zaczynając od elementu.
8. Animation_opts - pozwala określić niestandardowe właściwości animacji jako słownik. Wartości te są następnie przekazywane do dzielnicy.Animate Funkcja w dzielnicy.JS.
9. Default_Width - określa domyślną szerokość uzyskanego figury w pikselach.
10. Default_height - określa domyślną wysokość figury w pikselach.
11. Waliduj - określa, czy rysunek powinien zostać zatwierdzony przed przekonwertowaniem na ciąg HTML.
12. Div_id - określa wartość atrybutu identyfikatora znacznika div, w którym znajduje się wykres.

Następnie funkcja zwraca reprezentację łańcucha rysunku jako ciąg.

Przykładowe użycie

Poniższy kod pokazuje, jak używać funkcji To_Html do konwersji rysunku na reprezentację ciągów HTML.

importować fabuły.Wyraź jako PX
df = px.dane.zapasy (indeksowane = true)
Ryc. = PX.obszar (df, facet_col = 'company', facet_col_wrap = 2)
Figa.pokazywać()

W powyższym przykładzie zaczynamy od zaimportowania modułu ekspresowego jako PX. Następnie tworzymy ramkę danych przy użyciu danych zapasowych z Plotly.

Wreszcie tworzymy wykres objęty fanatycznie za pomocą PX.Funkcja obszaru. Powinno to zwrócić liczbę, jak pokazano poniżej:

Możemy przekonwertować powyższą rysunek na reprezentację ciągów HTML, jak pokazano w poniższym kodzie:

importować fabuły.IO jako IO
io.to_html (ryc, full_html = false)

Uruchamianie powyższego kodu powinno zwrócić masywny ciąg HTML, jak pokazano na zrzucie ekranu poniżej:

Zauważ, że dokument HTML zaczyna się od elementu. Jeśli chcesz dołączyć cały plik HTML, ustaw parametr pełny_html = true, jak pokazano:

importować fabuły.IO jako IO
io.to_html (ryc, full_html = true)

Zwróć uwagę, że znacznik zaczyna się na tagu.

Uwzględnić plotly.JS, możemy ustawić parametr jako:

importować fabuły.IO jako IO
io.to_html (ryc, w calive_plotlyjs = 'cdn', full_html = true)

W powyższym przykładzie mówimy o funkcji, aby uwzględniła plotly.Biblioteka JS za pośrednictwem linku CDN.

Możemy to zweryfikować na podstawie danych wyjściowych:

Najlepszym sposobem na użycie dokumentu To_Html jest eksport ciągu HTML do pliku HTML.

Możemy to zrobić, uruchamiając prosty kod, jak pokazano poniżej:

importować fabuły.IO jako IO
z otwartym („FACETTED.html ', „w”) jako f:
F.Writines (IO.to_html (ryc, w calive_plotlyjs = 'cnd', full_html = true)))

W tym przykładzie używamy modułu pliku w Pythonie, aby zapisać ciąg HTML jako plik HTML.

Następnie możemy otworzyć dokument HTML w przeglądarce i wyświetlić rysunek, jak pokazano:

Wniosek

Gratulacje, z powodzeniem wyeksportowałeś swoją figurkę jako ciąg HTML za pomocą fabuły.io.To_html funkcja.