การกำหนดค่าขั้นสูง

ส่วนนี้ครอบคลุมตัวเลือกการกำหนดค่าที่เพิ่มเติมซึ่งเกินกว่าการตั้งค่าพื้นฐาน ในขณะที่การตั้งค่าพื้นฐานให้ทุกสิ่งที่จำเป็นในการทำให้การ์ดทำงาน ตัวแปรขั้นสูงเหล่านี้ช่วยให้คุณปรับแต่งพฤติกรรมและลักษณะของการ์ดได้อย่างลึกซึ้ง

ด้วยการตั้งค่าเหล่านี้ คุณสามารถปรับขนาดเลย์เอาต์ให้เหมาะสมกับแดชบอร์ดของคุณ กำหนดค่าเลือกการเข้าถึง จัดการการมองเห็นขององค์ประกอบ UI เฉพาะ และแทนที่สีแผนที่เริ่มต้นได้อย่างสมบูรณ์

ความสูงเต็ม (full_height)

เนื่องจากแผนที่สามารถเลื่อนและซูมได้อย่างเต็มที่ การ์ดจึงถูกออกแบบให้ไม่เคยสูงเกินกว่าหน้าจอภายใต้สถานการณ์ใดๆ ซึ่งจะทำให้มุมมองแผนที่ทั้งหมดพอดีกับมุมมองโดยไม่ต้องเลื่อนหน้าจอ

หากคุณต้องการแทนที่การออกแบบที่ตั้งใจนี้ คุณสามารถตั้งค่าพารามิเตอร์นี้เป็น false เมื่อปิดใช้งาน การ์ดจะปรับขนาดให้เต็มความกว้างสูงสุดที่มีอยู่เสมอ แม้ว่าความสูงที่ได้จะเกินขอบเขตหน้าจอ

ไม่แนะนำ

การตั้งค่าพารามิเตอร์นี้เป็น false โดยทั่วไปไม่แนะนำ เนื่องจากอาจส่งผลกระทบในด้านลบต่อการนำทางและประสบการณ์โดยรวมของผู้ใช้งานบนแดชบอร์ด และอาจทำให้ฟังก์ชันการเลื่อนแผนที่ถูกล็อกโดยไม่จำเป็น เว้นแต่จะมีการกำหนดค่าแตกต่างออกไปในพารามิเตอร์การกำหนดค่า locked

อัตราส่วนภาพ (aspect_ratio)

นี่คือการกำหนดอัตราส่วนภาพของพื้นที่การแสดงผลแผนที่ ตัวอย่างเช่น ค่าของ 1.5 หมายความว่าความกว้างเท่ากับ 1.5 เท่าของความสูง สามารถตั้งค่าได้ระหว่าง 0.1 และ 100 ขึ้นอยู่กับรูปทรงของแผนผัง

สำคัญ

เว้นแต่ full_height จะถูกตั้งค่าเป็น true การ์ดจะไม่แสดงสูงเกินกว่าหน้าต่างมุมมอง ไม่ว่าค่าอัตราส่วนภาพจะถูกกำหนดไว้เท่าใด

โหมดสำหรับมือซ้าย (left_handed)

การตั้งค่าพารามิเตอร์นี้เป็น true จะแสดงปุ่มปฏิบัติการและเมนูที่เกี่ยวข้องทางด้านซ้ายของการ์ดแทนด้านขวา โดยมีเงื่อนไขว่าการ์ดมีความกว้างเพียงพอสำหรับให้เนื้อหาจัดชิดด้านขวา

ปิดการตอบสนองแบบสั่นdisable_haptic)

การตั้งค่าพารามิเตอร์นี้เป็น true จะปิดการสั่นตอบสนองแบบสัมผัสที่เกิดจากการ์ดระหว่างการโต้ตอบ UI บนอุปกรณ์มือถือที่มีความสามารถด้านสัมผัส

สำคัญ

การตอบสนองแบบสัมผัสสำหรับผลลัพธ์การเรียกใช้งานบริการสำเร็จหรือไม่สำเร็จไม่สามารถปิดได้ ซึ่งช่วยให้สอดคล้องกับพฤติกรรมมาตรฐานของ Home Assistant สำหรับส่วนประกอบแบบโต้ตอบ เช่น สวิตช์และตัวเลือกที่เรียกใช้งานบริการ

ระยะเวลาล็อกการสัมผัส (touch_lock)

เขียนทับระยะเวลาการถือปลดล็อกสัมผัสเริ่มต้น 100 ms ที่ใช้ในโหมด auto และ only_touch อธิบายในส่วน โหมดล็อกการ์ด สามารถรับค่าตั้งแต่ 100 ถึง 400 ms

สวิตช์แบบเก่า (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