Configuração Avançada

Esta seção aborda opções de configuração adicionais que vão além da configuração essencial. Enquanto as configurações básicas fornecem tudo o que é necessário para colocar o cartão em funcionamento, esses parâmetros avançados permitem personalizar profundamente seu comportamento e aparência.

Usando essas configurações, você pode ajustar as dimensões do layout para se encaixar perfeitamente no seu painel, configurar opções de acessibilidade, gerenciar a visibilidade de elementos específicos da interface do usuário e substituir completamente as cores padrão do mapa.

Altura Total (full_height)

Como o mapa é totalmente panorâmico e ampliável, o cartão é explicitamente projetado para nunca ser renderizado com altura maior que a da tela em nenhuma circunstância. Isso garante que toda a visualização do mapa sempre caiba na janela de exibição sem necessidade de rolagem da página.

Se você desejar substituir esse design pretendido, pode definir este parâmetro como false. Quando desativado, o cartão sempre se ajustará para preencher a largura máxima disponível, mesmo que sua altura resultante ultrapasse os limites da tela.

Não Recomendado

Configurar este parâmetro para false geralmente não é recomendado. Isso pode impactar negativamente a navegação e a experiência geral do usuário no painel e pode causar bloqueios desnecessários da funcionalidade de movimentação do mapa, a menos que seja configurado de outra forma no parâmetro de configuração locked.

Proporção da Tela (aspect_ratio)

Isto define a proporção da área de exibição do mapa. Por exemplo, um valor de 1.5 significa que a largura é 1,5 vezes a altura. Pode ser definido entre 0.1 e 100, dependendo do formato da planta.

Importante

A menos que full_height seja definido como true, o cartão nunca será exibido mais alto que a visualização, independentemente da proporção fornecida.

Modo Canhoto (left_handed)

Configurar este parâmetro para true exibe os botões de ação e seus menus associados no lado esquerdo do cartão em vez do lado direito, desde que o cartão seja suficientemente largo para que o conteúdo seja alinhado à direita.

Desabilitar Feedback Tátil (disable_haptic)

Definir este parâmetro como true desativa as vibrações de feedback háptico acionadas pelo cartão durante interações na interface em dispositivos móveis com capacidade háptica.

Importante

O feedback háptico para resultados de sucesso e falha de chamadas de serviço não pode ser desativado. Isso garante consistência com o comportamento padrão do Home Assistant para componentes interativos, como interruptores e seletores que acionam chamadas de serviço.

Duração do Bloqueio por Toque (touch_lock)

Substitui a duração padrão de 100 ms de manutenção do bloqueio por toque usada nos modos auto e only_touch, detalhados na seção Modo de Bloqueio do Cartão. Aceita valores entre 100 e 400 ms.

Interruptores Legados (legacy_switches)

Definir este parâmetro como true reverte os interruptores para o antigo design de alternância do Material, em vez de usar o design mais recente introduzido no Home Assistant 2026.5.

Aviso

Se a versão instalada do Home Assistant for anterior a 2026.5, definir este parâmetro como true não terá efeito, pois o design de interruptor legado já é usado nativamente.

Scripts (scripts)

Uma lista de entidades Script do Home Assistant, como - script.sweep_living_room, que são adicionadas diretamente à lista de Atalhos do aspirador na tela inicial.

A lista de atalhos exibe esses scripts com os nomes das entidades junto a um botão Iniciar (). Eles são inseridos no topo da lista de atalhos, mantendo a ordem exata definida na configuração. Isso significa que scripts personalizados são exibidos antes dos atalhos nativos do robô.

Além disso, se o dispositivo aspirador não suportar atalhos nativamente, definir scripts aqui força o botão de ação do atalho a se tornar visível na tela inicial. Isso permite que o cartão forneça funcionalidade de atalho semelhante via Home Assistant para dispositivos não suportados.

Exemplo 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