لذلك ليس من المستغرب أنك قد تحتاج إلى تحويل شكل محدد إلى سلسلة HTML.
في هذا البرنامج التعليمي ، سوف نتعلم كيفية استخدام وحدة Plotly io لتحويل الشكل إلى تمثيل سلسلة HTML.
هيا بنا نتعمق.
وظيفة Plotly.io.to_html ()
تسمح لك الوظيفة to_html () من الوحدة النمطية io لـ Plotly بتمرير رقم محدد كمعامل وتحويله إلى سلسلة HTML.
يتم التعبير عن بناء جملة الوظيفة كما هو موضح أدناه:
مؤامرة. هذه . to_html ( تين و التكوين = لا أحد و تشغيل تلقائي = حقيقي و include_plotlyjs = حقيقي و include_mathjax = خطأ شنيع و post_script = لا أحد و full_html = حقيقي و Animation_opts = لا أحد و عرض_الافتراضي = '100٪' و الارتفاع_الافتراضي = '100٪' و التحقق من صحة = حقيقي و div_id = لا أحد )
دعنا نستكشف معلمات الوظيفة ، أدناه:
- التين - يشير إلى كائن الشكل أو تمثيل القاموس للشكل.
- التكوين - يحدد خيارات التكوين plotly.js. قم بتمرير خيارات التكوين كقاموس.
- Auto_play - يحدد ما إذا كان يجب تشغيل تسلسل الرسوم المتحركة تلقائيًا عند تحميل الصفحة. هذه المعلمة مفيدة إذا كان لديك شكل يحتوي على إطارات متحركة.
- Include_plotlyjs - تحدد هذه المعلمة كيفية تضمين مكتبة plotly.js في HTML. تشمل القيم المقبولة في هذه المعلمة ما يلي:
- صواب - يتضمن مكتبة plotly.js كعلامة برنامج نصي في مستند HTML. سيؤدي ذلك إلى زيادة حجم الملف ولكنه سيسمح باستخدام الملف في البيئات غير المتصلة بالإنترنت.
- 'cdn' - سيؤدي تعيين معلمة include_plotlyjs إلى 'cdn' إلى إضافة علامة نصية تشير إلى ارتباط بعيد لمكتبة plotly.js. استخدم هذا الخيار عندما تكون في بيئة شبكية أو بيئة حساسة لحجم الملف.
- 'الدليل' - يتضمن علامة البرنامج النصي الذي يشير إلى حزمة plotly.min.js الخارجية الموجودة في نفس الدليل مثل مستند HTML.
- 'يتطلب' - يؤدي تعيين القيمة المطلوب إلى تحميل مكتبة plotly.js باستخدام تتطلب. تأكد من تثبيت required.js وإتاحته عالميًا على النظام.
- 'خطأ' - لا يشمل مكتبة plotly.js. تجنب هذه القيمة عند تعيين معلمة full_html على True لأنها ستعرض المستند بأكمله ، غير قابل للاستخدام.
- include_mathjax - تحدد ما إذا كان يجب أن يتضمن الملف مكتبة mathjax.js. تتشابه القيم المقبولة مع include_plotlyjs باستثناء قيمة 'تتطلب'.
- Post_script - يسمح لك بتضمين مقتطفات JavaScript التي يتم تنفيذها بعد إنشاء المؤامرة.
- Full_html - إذا كان هذا صحيحًا ، ستعيد الوظيفة سلسلة تحتوي على مستند HTML بأكمله ، بدءًا من علامات . إذا كان خطأ ، ستعيد الوظيفة سلسلة HTML تبدأ بالعنصر .
- Animation_opts - يسمح لك بتحديد خصائص الرسوم المتحركة المخصصة كقاموس. ثم يتم تمرير هذه القيم إلى الدالة plotly.animate في plotly.js.
- عرض_الافتراضي - يحدد العرض الافتراضي للشكل الناتج بالبكسل.
- Default_height - تحدد الارتفاع الافتراضي للشكل بالبكسل.
- تحقق - يحدد ما إذا كان يجب التحقق من صحة الشكل قبل تحويله إلى سلسلة HTML.
- Div_id - تحدد قيمة سمة id لعلامة div حيث توجد المؤامرة.
بعد ذلك ، ترجع الدالة سلسلة تمثيل للرقم كسلسلة.
مثال على الاستخدام
يوضح الكود التالي كيفية استخدام وظيفة to_html لتحويل شكل إلى تمثيل سلسلة HTML.
يستورد مؤامرة. التعبير كما مقصف
مدافع = مقصف. بيانات . مخازن ( مفهرسة = حقيقي )
تين = مقصف. منطقة ( مدافع و facet_col = 'شركة' و facet_col_wrap = اثنين )
تين. تبين ( )في المثال أعلاه ، نبدأ باستيراد الوحدة النمطية Plotly express كـ px. نقوم بعد ذلك بإنشاء إطار بيانات باستخدام بيانات المخزون من Plotly.
أخيرًا ، نقوم بإنشاء مخطط منطقة ذات أوجه باستخدام وظيفة px.area. يجب أن يعيد هذا الرقم كما هو موضح أدناه:
يمكننا تحويل الشكل أعلاه إلى تمثيل سلسلة HTML كما هو موضح في الكود أدناه:
يستورد مؤامرة. هذه كما هذه
هذه. to_html ( تين و full_html = خطأ شنيع )يجب أن يؤدي تشغيل الكود أعلاه إلى إرجاع سلسلة HTML ضخمة كما هو موضح في لقطة الشاشة أدناه:
لاحظ أن مستند HTML يبدأ عند عنصر
. إذا كنت تريد تضمين ملف HTML بأكمله ، فقم بتعيين المعلمة full_html = True كما هو موضح: يستورد مؤامرة. هذه كما هذه
هذه. to_html ( تين و full_html = حقيقي )لاحظ أن الترميز يبدأ في علامة .
لتضمين plotly.js ، يمكننا تعيين المعلمة على النحو التالي:
يستورد مؤامرة. هذه كما هذه
هذه. to_html ( تين و include_plotlyjs = 'cdn' و full_html = حقيقي )في المثال أعلاه ، أخبرنا الوظيفة بتضمين مكتبة plotly.js عبر رابط CDN.
يمكننا التحقق من ذلك من الإخراج أدناه:
أفضل طريقة لاستخدام مستند to_html هي تصدير سلسلة HTML إلى ملف HTML.
يمكننا القيام بذلك عن طريق تشغيل رمز بسيط كما هو موضح أدناه:
يستورد مؤامرة. هذه كما هذه
مع افتح ( 'facetted.html' و 'في' ) كما F:
F. كتابات ( هذه. to_html ( تين و include_plotlyjs = 'cnd' و full_html = حقيقي ) )في هذا المثال ، نستخدم وحدة الملف في Python لكتابة سلسلة HTML كملف aN html.
يمكننا بعد ذلك فتح مستند HTML في المتصفح وعرض الشكل كما هو موضح:
استنتاج
تهانينا ، لقد نجحت في تصدير شكل Plotly الخاص بك كسلسلة HTML باستخدام الدالة plotly.io.to_html.