Zaawansowana konfiguracja

Ta sekcja obejmuje dodatkowe opcje konfiguracji, które wykraczają poza podstawową konfigurację. Podczas gdy podstawowe ustawienia zapewniają wszystko, co potrzebne do uruchomienia karty, te zaawansowane parametry pozwalają na głęboką personalizację jej zachowania i wyglądu.

Korzystając z tych ustawień, możesz dostosować wymiary układu, aby idealnie pasowały do twojego pulpitu nawigacyjnego, skonfigurować opcje dostępności, zarządzać widocznością konkretnych elementów interfejsu użytkownika oraz całkowicie nadpisać domyślne kolory mapy.

Pełna wysokość (full_height)

Ponieważ mapa jest w pełni przesuwalna i powiększalna, karta została wyraźnie zaprojektowana tak, aby nigdy nie renderować się wyżej niż ekran w żadnych okolicznościach. Zapewnia to, że cały widok mapy zawsze mieści się w obszarze widoku bez konieczności przewijania strony.

Jeśli chcesz nadpisać ten zamierzony projekt, możesz ustawić ten parametr na false. Po wyłączeniu karta zawsze będzie skalować się, aby wypełnić maksymalną dostępną szerokość, nawet jeśli jej wynikowa wysokość przekroczy granice ekranu.

Nie zalecane

Ustawienie tego parametru na false jest ogólnie niezalecane. Może negatywnie wpłynąć na nawigację i ogólne doświadczenie użytkownika na pulpicie oraz może powodować niepotrzebne blokowanie funkcji przesuwania mapy, chyba że jest skonfigurowane inaczej w parametrze konfiguracji locked.

Proporcje (aspect_ratio)

To definiuje proporcje obszaru wyświetlania mapy. Na przykład, wartość 1.5 oznacza, że szerokość jest 1,5 razy większa niż wysokość. Można ją ustawić w zakresie od 0.1 do 100, w zależności od kształtu planu piętra.

Ważne

Jeśli full_height nie jest ustawione na true, karta nigdy nie będzie wyświetlana wyższa niż widok, niezależnie od podanych proporcji.

Tryb leworęczny (left_handed)

Ustawienie tego parametru na true wyświetla przyciski akcji i odpowiadające im menu po lewej stronie karty zamiast po prawej, pod warunkiem, że karta jest wystarczająco szeroka, aby zawartość mogła być wyrównana do prawej.

Wyłącz wibracje (disable_haptic)

Ustawienie tego parametru na true wyłącza wibracje sprzętowe wywoływane przez kartę podczas interakcji w interfejsie użytkownika na urządzeniach mobilnych z funkcją haptyczną.

Ważne

Nie można wyłączyć sprzężenia zwrotnego haptycznego dla wyników powodzenia lub niepowodzenia wywołań usług. Zapewnia to zgodność ze standardowym zachowaniem Home Assistant dla interaktywnych komponentów, takich jak przełączniki i selektory, które wywołują usługi.

Czas blokady dotyku (touch_lock)

Nadpisuje domyślny czas przytrzymania odblokowania dotyku 100 ms używany w trybach auto i only_touch, opisanych w sekcji Tryb blokady karty. Akceptuje wartości między 100 a 400 ms.

Przełączniki klasyczne (legacy_switches)

Ustawienie tego parametru na true przywraca przełączniki do starego projektu Material toggle, zamiast używać nowego projektu toggle wprowadzonego w Home Assistant 2026.5.

Ostrzeżenie

Jeśli zainstalowana wersja Home Assistant jest starsza niż 2026.5, ustawienie tego parametru na true nie ma efektu, ponieważ klasyczny projekt przełącznika jest już używany natywnie.

Skrypty (scripts)

Lista jednostek Home Assistant Script, takich jak - script.sweep_living_room, które są dodawane bezpośrednio do listy Skróty odkurzacza na ekranie głównym.

Lista skrótów wyświetla te skrypty z ich nazwami jednostek obok przycisku Start (). Są one wstawiane na samą górę listy skrótów, zachowując dokładną kolejność określoną w konfiguracji. Oznacza to, że skrypty niestandardowe są wyświetlane przed natywnymi skrótami robota.

Dodatkowo, jeśli urządzenie odkurzacza nie obsługuje skrótów natywnie, zdefiniowanie tutaj skryptów wymusza, aby przycisk akcji skrótu stał się widoczny na ekranie głównym. Pozwala to karcie zapewnić podobną funkcjonalność skrótów za pośrednictwem Home Assistant dla urządzeń nieobsługiwanych.

Przykład 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