Démarrage rapide

UIX 9.0.0 nécessite Home Assistant 2026.11.0 ou ultérieur. Voir la version 9.0.0.

::: note Utilisateurs de Card-mod Si vous migrez depuis Card-mod, consultez la FAQ, qui répond à la plupart des questions. Pour toute autre question, utilisez les discussions GitHub.

:::

Installation

Marketplace

Ouvrez UI eXtension dans le Marketplace de Home Assistant, puis choisissez Installer. Le Marketplace ajoute également UI eXtension comme service.

Installation manuelle

Utilisez votre méthode habituelle pour accéder aux fichiers de configuration Home Assistant. Ajoutez le dossier uix à custom_components, puis copiez dans ce dossier tous les fichiers de custom_components/uix. Redémarrez Home Assistant.

Ajouter le service après une installation manuelle

Après le redémarrage, ajoutez UI eXtension comme service dans Paramètres → Appareils et services. Le bouton ci-dessus vous guide à travers les étapes nécessaires.

Une fois UI eXtension ajouté, actualisez la page pour rendre la ressource Frontend disponible.

Votre premier style UIX

• Ouvrez votre carte dans l'éditeur graphique Home Assistant.
• Cliquez sur Afficher l'éditeur de code au bas de la boîte de dialogue.
• Ajoutez ce code à la fin de la configuration YAML :

type: tile
entity: light.bed_light
uix:
  style: |
    ha-card {
      background: red;
    }

Le fond de la carte devrait devenir rouge pendant la saisie. Une petite icône de pinceau apparaît aussi près du bouton Afficher l'éditeur visuel. Elle indique que la carte contient du code UIX, qui n'est pas affiché dans l'éditeur visuel.

Votre premier UIX Forge

Utilisez le YAML suivant, en l'adaptant à votre entité, pour créer une carte Tile masquée lorsque input_boolean.test_boolean est à on. Les autres options de forge et element utilisent ici des valeurs simples, mais montrent que toute la configuration de l'élément, ainsi que hidden, grid_options et les sparks, peuvent être construits avec des modèles.

type: custom:uix-forge
forge:
  mold: card
  show_error: false
  hidden: "{{ is_state('input_boolean.test_boolean', 'on') }}"
  grid_options:
    columns: "{{ 6 }}"
    rows: 1
element:
  type: tile
  icon: "{{ 'mdi:test-tube' }}"
  entity: "{{ 'sun.sun' }}"
  uix:
    style: |
      ha-card {
        background: red;
      }