Cấu hình nâng cao

Phần này bao gồm các tùy chọn cấu hình bổ sung vượt ra ngoài thiết lập cơ bản. Trong khi các cài đặt cơ bản cung cấp mọi thứ cần thiết để thẻ hoạt động, các tham số nâng cao này cho phép bạn tùy chỉnh sâu hơn hành vi và giao diện của nó.

Sử dụng các cài đặt này, bạn có thể điều chỉnh kích thước bố cục để vừa vặn hoàn hảo với bảng điều khiển của mình, cấu hình các tùy chọn truy cập, quản lý khả năng hiển thị của các thành phần giao diện cụ thể và hoàn toàn ghi đè màu bản đồ mặc định.

Chiều cao đầy đủ (full_height)

Vì bản đồ có thể di chuyển và phóng to hoàn toàn, thẻ được thiết kế rõ ràng để không bao giờ hiển thị cao hơn màn hình trong bất kỳ trường hợp nào. Điều này đảm bảo toàn bộ chế độ xem bản đồ luôn vừa vặn trong khung nhìn mà không cần phải cuộn trang.

Nếu bạn muốn ghi đè thiết kế dự kiến này, bạn có thể đặt tham số này thành false. Khi bị vô hiệu hóa, thẻ sẽ luôn mở rộng để lấp đầy chiều rộng tối đa có sẵn, ngay cả khi chiều cao kết quả vượt quá giới hạn màn hình.

Không Khuyến Nghị

Việc thiết lập tham số này thành false thường không được khuyến nghị. Nó có thể ảnh hưởng tiêu cực đến việc điều hướng và trải nghiệm người dùng tổng thể của bảng điều khiển và có thể gây ra việc khóa chức năng kéo bản đồ không cần thiết, trừ khi được cấu hình khác trong tham số cấu hình locked.

Tỷ Lệ Khung Hình (aspect_ratio)

Tham số này xác định tỷ lệ khung hình của khu vực hiển thị bản đồ. Ví dụ, giá trị 1.5 có nghĩa là chiều rộng bằng 1,5 lần chiều cao. Nó có thể được đặt trong khoảng từ 0.1 đến 100 tùy thuộc vào hình dạng của sơ đồ mặt bằng.

Quan trọng

Trừ khi full_height được đặt thành true, thẻ sẽ không bao giờ được hiển thị cao hơn khung nhìn, bất kể tỷ lệ khung hình được cung cấp.

Chế Độ Tay Trái (left_handed)

Thiết lập tham số này thành true sẽ hiển thị các nút hành động và các menu liên quan ở bên trái của thẻ thay vì bên phải, với điều kiện thẻ đủ rộng để nội dung được căn sang phải.

Tắt Phản Hồi Cảm Ứngdisable_haptic)

Đặt tham số này thành true sẽ tắt rung phản hồi xúc giác được kích hoạt bởi thẻ trong các tương tác giao diện người dùng trên các thiết bị di động có khả năng xúc giác.

Quan trọng

Phản hồi xúc giác cho kết quả thành công và thất bại khi gọi dịch vụ không thể bị vô hiệu hóa. Điều này đảm bảo tính nhất quán với hành vi chuẩn của Home Assistant đối với các thành phần tương tác như công tắc và bộ chọn mà kích hoạt cuộc gọi dịch vụ.

Thời lượng khóa cảm ứng (touch_lock)

Ghi đè thời lượng giữ mở khóa cảm ứng mặc định 100 ms được sử dụng trong các chế độ auto và only_touch được chi tiết trong phần Chế Độ Khóa Thẻ. Nó chấp nhận các giá trị từ 100 đến 400 ms.

Công tắc cũ (legacy_switches)

Đặt tham số này thành true sẽ khôi phục các công tắc trở về thiết kế toggle Material cũ, thay vì sử dụng thiết kế toggle mới được giới thiệu trong Home Assistant 2026.5.

Cảnh báo

Nếu phiên bản Home Assistant được cài đặt cũ hơn 2026.5, việc đặt tham số này thành true sẽ không có tác dụng, vì thiết kế công tắc cũ đã được sử dụng sẵn.

Kịch bản (scripts)

Một danh sách các thực thể Kịch bản Home Assistant, chẳng hạn như - script.sweep_living_room, được thêm trực tiếp vào danh sách Phím tắt của máy hút bụi trên màn hình chính.

Danh sách phím tắt hiển thị các kịch bản này cùng với tên thực thể của chúng và một nút Bắt đầu (). Chúng được chèn ở ngay đầu danh sách phím tắt, giữ nguyên thứ tự chính xác được định nghĩa trong cấu hình. Điều này có nghĩa là các kịch bản tùy chỉnh được hiển thị trước các phím tắt mặc định của robot.

Ngoài ra, nếu thiết bị máy hút bụi không hỗ trợ phím tắt một cách nguyên bản, việc định nghĩa các kịch bản ở đây sẽ buộc nút hành động phím tắt trở nên hiển thị trên màn hình chính. Điều này cho phép thẻ cung cấp chức năng phím tắt tương tự thông qua Home Assistant cho các thiết bị không được hỗ trợ.

Ví dụ 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