Configuração Avançada

Esta secção cobre opções adicionais de configuração que vão além da configuração essencial. Enquanto as definições básicas fornecem tudo o que é necessário para pôr o cartão a funcionar, estes parâmetros avançados permitem-lhe personalizar profundamente o seu comportamento e aparência.

Usando estas definições, pode ajustar as dimensões do layout para se adaptar perfeitamente ao seu painel, configurar opções de acessibilidade, gerir a visibilidade de elementos específicos da interface e substituir completamente as cores do mapa por defeito.

Altura Total (full_height)

Como o mapa é totalmente panoramável e ampliável, o cartão foi explicitamente desenhado para nunca ser apresentado com maior altura que o ecrã em circunstância alguma. Isto garante que toda a visualização do mapa se encaixe sempre na janela de visualização sem necessidade de rolar a página.

Se desejar substituir este design pretendido, pode definir este parâmetro para false. Quando desativado, o cartão irá sempre dimensionar-se para preencher a largura máxima disponível, mesmo que a altura resultante exceda os limites do ecrã.

Não Recomendado

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

Proporção (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 da forma do plano do piso.

Importante

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

Modo Canhoto (left_handed)

Definir este parâmetro como true exibe os botões de ação e os 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.

Desativar Feedback Háptico (disable_haptic)

Definir este parâmetro para true desativa as vibrações de feedback háptico ativadas pelo cartão durante as interações com a interface em dispositivos móveis com capacidades hápticas.

Importante

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

Duração do Bloqueio do Toque (touch_lock)

Substitui a duração padrão de 100 ms do bloqueio do toque utilizado 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 para true reverte os interruptores para o antigo design de alternância Material, em vez de utilizar o novo design de alternância introduzido no Home Assistant 2026.5.

Aviso

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

Scripts (scripts)

Uma lista de entidades Script do Home Assistant, como - script.sweep_living_room, que são adicionadas diretamente à lista Atalhos do aspirador no ecrã principal.

A lista de atalhos apresenta estes scripts com os seus nomes de entidade juntamente com um botão Iniciar (). Eles são inseridos no topo da lista de atalhos, mantendo a ordem exata definida na configuração. Isto significa que os scripts personalizados são exibidos antes dos atalhos nativos do robô.

Além disso, se o dispositivo aspirador não suportar atalhos de forma nativa, definir scripts aqui força o botão de ação de atalho a tornar-se visível no ecrã principal. Isto permite que o cartão forneça funcionalidade de atalho semelhante através do 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