고급 구성
이 섹션에서는 기본 설정을 넘어서는 추가 구성 옵션을 다룹니다. 기본 설정은 카드를 실행하는 데 필요한 모든 것을 제공하지만, 이러한 고급 매개변수는 카드의 동작과 외형을 깊이 있게 사용자 정의할 수 있게 해줍니다.
이러한 설정을 사용하여 대시보드에 완벽하게 맞도록 레이아웃 크기를 조정하고, 접근성 옵션을 구성하며, 특정 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)
카드 잠금 모드 섹션에 자세히 설명된 auto 및 only_touch 모드에서 사용되는 기본 100 ms 터치 잠금 해제 유지 시간을 재정의합니다. 100에서 400 ms 사이의 값을 허용합니다.
레거시 스위치 (legacy_switches)
이 매개변수를 true으로 설정하면 스위치가 Home Assistant 2026.5에서 도입된 새로운 토글 디자인 대신 이전 Material 토글 디자인으로 되돌아갑니다.
경고
설치된 Home Assistant 버전이 2026.5보다 이전인 경우, 이 매개변수를 true로 설정해도 효과가 없으며, 레거시 스위치 디자인이 이미 기본으로 사용됩니다.
스크립트 (scripts)
홈 화면에서 진공청소기의 Shortcuts 목록에 직접 추가되는 - script.sweep_living_room와 같은 Home Assistant 스크립트 엔티티 목록입니다.
단축키 목록은 이러한 스크립트를 엔티티 이름과 함께 시작 () 버튼으로 표시합니다. 이들은 단축키 목록의 맨 위에 삽입되며, 구성에서 정의된 정확한 순서를 유지합니다. 즉, 맞춤 스크립트가 로봇의 기본 단축키보다 먼저 표시됩니다.
또한, 진공청소기 장치가 기본적으로 단축키를 지원하지 않는 경우, 여기에서 스크립트를 정의하면 홈 화면에서 단축키 동작 버튼이 표시되도록 강제합니다. 이를 통해 카드가 Home Assistant를 통해 지원되지 않는 장치에서도 유사한 단축키 기능을 제공할 수 있습니다.
YAML 예제
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