التهيئة المتقدمة

يغطي هذا القسم خيارات التكوين الإضافية التي تتجاوز الإعداد الأساسي. بينما توفر الإعدادات الأساسية كل ما هو مطلوب لتشغيل البطاقة، تتيح لك هذه المعلمات المتقدمة تخصيص سلوكها ومظهرها بشكل عميق.

باستخدام هذه الإعدادات، يمكنك ضبط أبعاد التخطيط لتتناسب تمامًا مع لوحة التحكم الخاصة بك، وتكوين خيارات الوصول، وإدارة رؤية عناصر واجهة المستخدم المحددة، وتجاوز ألوان الخريطة الافتراضية بالكامل.

الارتفاع الكامل (full_height)

نظرًا لأن الخريطة قابلة للتمرير والتكبير بالكامل، تم تصميم البطاقة بشكل صريح بحيث لا تصبح أطول من الشاشة تحت أي ظرف من الظروف. وهذا يضمن أن عرض الخريطة بأكمله يتناسب دائمًا مع نافذة العرض دون الحاجة إلى تمرير الصفحة.

إذا كنت ترغب في تجاوز هذا التصميم المقصود، يمكنك ضبط هذا المعامل على false. عند تعطيله، ستقوم البطاقة دائمًا بالتمدد لتملأ الحد الأقصى المتاح للعرض، حتى إذا تجاوز ارتفاعها الناتج حدود الشاشة.

غير موصى به

تعيين هذا المعامل إلى false غير موصى به بشكل عام. يمكن أن يؤثر سلبًا على التنقل وتجربة المستخدم الكلية للوحة المعلومات وقد يسبب قفل غير ضروري لوظيفة تمرير الخريطة إلا إذا تم تكوينه بخلاف ذلك في معامل التكوين locked.

نسبة الطول إلى العرض (aspect_ratio)

هذا يحدد نسبة الطول إلى العرض لمنطقة عرض الخريطة. على سبيل المثال، القيمة 1.5 تعني أن العرض يساوي 1.5 ضعف الارتفاع. يمكن تعيينه بين 0.1 و 100 اعتمادًا على شكل مخطط الطابق.

مهم

ما لم يتم تعيين full_height إلى true، لن يتم عرض البطاقة أبدًا أطول من العرض، بغض النظر عن نسبة الطول إلى العرض المقدمة.

وضع اليد اليسرى (left_handed)

تعيين هذا المعامل إلى true يعرض أزرار الإجراءات والقوائم المرتبطة بها على الجانب الأيسر من البطاقة بدلاً من الجانب الأيمن، شريطة أن تكون البطاقة واسعة بما يكفي لمواءمة المحتوى إلى اليمين.

تعطيل ردود الفعل اللمسية (disable_haptic)

إعداد هذه المعلمة إلى true يعطل الاهتزازات المرتجعة اللمسية التي يتم تشغيلها بواسطة البطاقة أثناء التفاعل مع واجهة المستخدم على الأجهزة المحمولة التي تمتلك قدرات لمسية.

مهم

لا يمكن تعطيل ردود الفعل اللمسية لنجاح أو فشل استدعاء الخدمة. هذا يضمن التوافق مع سلوك Home Assistant القياسي للمكونات التفاعلية مثل المفاتيح والمحددات التي تقوم بتفعيل استدعاءات الخدمة.

مدة قفل اللمس (touch_lock)

يتجاوز مدة الضغط الافتراضية 100 مللي ثانية لإلغاء قفل اللمس المستخدمة في أوضاع auto و only_touch الموضحة في القسم وضع قفل البطاقة. ويمكن أن يقبل القيم بين 100 و400 مللي ثانية.

المفاتيح القديمة (legacy_switches)

إعداد هذه المعلمة إلى true يعيد المفاتيح إلى تصميم التبديل القديم من Material، بدلاً من استخدام تصميم التبديل الأحدث الذي تم تقديمه في Home Assistant 2026.5.

تحذير

إذا كان إصدار Home Assistant المثبت أقدم من 2026.5، فإن إعداد هذه المعلمة إلى true ليس له أي تأثير، حيث أن تصميم المفتاح القديم مستخدم أصلاً.

السكريبتات (scripts)

قائمة من الكيانات Home Assistant Script، مثل - script.sweep_living_room، التي تُضاف مباشرة إلى قائمة الاختصارات على الشاشة الرئيسية.

تعرض قائمة الاختصارات هذه النصوص البرمجية بأسماء الكيانات الخاصة بها جنبًا إلى جنب مع زر تشغيل (). يتم إدراجها في أعلى قائمة الاختصارات، مع الحفاظ على الترتيب الدقيق المحدد في التكوين. وهذا يعني أن النصوص البرمجية المخصصة تُعرض قبل الاختصارات الأصلية للروبوت.

بالإضافة إلى ذلك، إذا لم يدعم جهاز المكنسة الاختصارات بشكل أصلي، فإن تعريف النصوص البرمجية هنا يجبر زر إجراء الاختصار على الظهور على الشاشة الرئيسية. وهذا يسمح للبطاقة بتوفير وظائف اختصار مشابهة عبر Home Assistant للأجهزة غير المدعومة.

مثال YAML

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
aspect_ratio: 1.5
full_height: true
touch_lock: 200
disable_haptic: true
left_handed: true
legacy_switches: true
scripts:
  - script.sweep_living_room
  - script.mop_kitchen