Plotly.io.to_html

Nie jest więc niespodzianką, że konieczne może być przekonwertowanie określonej figury Plotly na ciąg HTML.

W tym samouczku dowiemy się, jak używać modułu Plotly io do konwersji figury na reprezentację ciągu HTML.

Zanurzmy się.

Funkcja Plotly.io.to_html()

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

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

Przyjrzyjmy się poniższym parametrom funkcji:

1. Fig – odnosi się do obiektu figury lub słownikowej reprezentacji figury.
2. Config – określa opcje konfiguracyjne plotly.js. Przekaż opcje konfiguracji jako słownik.
3. Auto_play – określa, czy sekwencja animacji powinna być odtwarzana automatycznie po wczytaniu strony. Ten parametr jest przydatny, jeśli masz figurę zawierającą animowane ramki.
4. Include_plotlyjs – ten parametr określa sposób włączenia biblioteki plotly.js do kodu HTML. Akceptowane wartości w tym parametrze to:
   • True – zawiera bibliotekę plotly.js jako znacznik skryptu w dokumencie HTML. Zwiększy to rozmiar pliku, ale pozwoli na używanie pliku w środowiskach offline.
   • „cdn” – ustawienie parametru include_plotlyjs na „cdn” doda tag skryptu wskazujący na zdalny link do biblioteki plotly.js. Użyj tej opcji w środowisku sieciowym lub środowisku wrażliwym na rozmiar pliku.
   • „katalog” – zawiera tag skryptu, który wskazuje na zewnętrzny pakiet plotly.min.js znajdujący się w tym samym katalogu, co dokument HTML.
   • ‘wymagaj’ – ustawienie wartości wymaga załaduje bibliotekę plotly.js przy użyciu require.js. Upewnij się, że plik require.js jest zainstalowany i dostępny globalnie w systemie.
   • „Fałsz” – nie obejmuje biblioteki plotly.js. Unikaj tej wartości podczas ustawiania parametru full_html na True, ponieważ spowoduje to, że cały dokument będzie bezużyteczny.
5. include_mathjax – określa, czy plik powinien zawierać bibliotekę mathjax.js. Akceptowane wartości są podobne do include_plotlyjs z wyjątkiem wartości „wymagaj”.
6. Post_script – umożliwia dołączenie fragmentów kodu JavaScript, które są wykonywane po utworzeniu wykresu.
7. Full_html – jeśli true, funkcja zwróci ciąg zawierający cały dokument HTML, zaczynając od znaczników . Jeśli false, funkcja zwróci ciąg HTML zaczynający się 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 funkcji plotly.animate w plotly.js.
9. Default_width – określa domyślną szerokość wynikowej figury w pikselach.
10. Default_height – określa domyślną wysokość figury w pikselach.
11. Sprawdź poprawność — określa, czy rysunek powinien zostać zweryfikowany przed przekonwertowaniem na ciąg HTML.
12. Div_id – określa wartość atrybutu id znacznika div, w którym znajduje się działka.

Następnie funkcja zwraca ciąg reprezentujący figurę jako ciąg.

Przykładowe użycie

Poniższy kod pokazuje, jak używać funkcji to_html do konwertowania figury na reprezentację ciągu HTML.

W powyższym przykładzie zaczynamy od zaimportowania modułu Plotly express jako px. Następnie tworzymy ramkę danych, korzystając z danych giełdowych z Plotly.

Na koniec tworzymy fasetowany wykres powierzchniowy za pomocą funkcji px.area. Powinno to zwrócić liczbę, jak pokazano poniżej:

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

Uruchomienie powyższego kodu powinno zwrócić ogromny ciąg HTML, jak pokazano na poniższym zrzucie ekranu:

Zauważ, że dokument HTML zaczyna się od elementu