Aller au contenu

UIX Forge crée des éléments Home Assistant avec des modèles dans la configuration qu'il contrôle et des extensions grâce aux Sparks UIX Forge. À partir de UIX 9.0.0-beta.0, la configuration en couches permet de conserver les modèles natifs de l'élément et d'appliquer une surcouche Forge séparée, sans éditeur visuel.

Forge prend en charge les moules card, badge, row, picture-element, section, footer et card-feature. Les moules intercontextes permettent d'intégrer un type d'élément dans un autre contexte parent, par exemple une carte utilisée comme ligne dans une carte Entités ; consultez les moules intercontextes. La configuration en couches est disponible pour tous les moules.

Consultez Forge pour la référence complète de la configuration.

L’aperçu 9.0.0-beta.2 ajoute l’éditeur visuel de cartes et badges. element_base conserve les réglages et modèles natifs inchangés ; seules les valeurs modifiées par Forge vont dans element, pour tous les moules. Le element_base d’une Foundry est une source native préservée : le générer depuis Export et le conserver lors des modifications. Voir la règle d’ancrage du type.

Fonderies ​

Une fonderie est une configuration UIX Forge réutilisable. Elle permet de définir une seule fois des fragments forge, element et uix pour plusieurs cartes. À partir de UIX 9.0.0-beta.0, elle peut aussi fournir element_base : une base résolue active la configuration en couches. element_disabled_paths reste local à l'instance Forge qui utilise la fonderie.

Consultez Fonderies pour un guide complet sur la fusion, les fonderies imbriquées et leur gestion dans les options de l'intégration.

Sparks ​

Les Sparks sont des comportements optionnels ajoutés à la liste forge.sparks. Chaque Spark possède une clé type et ses propres options.

Sparks disponibles :

  • 💬 Infobulle — attache une infobulle stylisée à tout élément créé.
  • :material-button-cursor: Bouton — attache un bouton stylisé (ha-button) avec actions avant ou après un élément.
  • 🏷️ Attribut — ajoute, remplace ou supprime un attribut d'un élément.
  • ⚡ Événement — reçoit des événements DOM d'actions fire-dom-event et expose leurs données comme variables de modèle.
  • ⭐ Icône Tile — insère un élément ha-tile-icon avant ou après un élément.
  • 🛡️ Badge d'état — insère un élément state-badge avant ou après un élément.
  • :material-grid: Grille — applique une mise en page CSS Grid à un conteneur.
  • 🔍 Recherche — recherche des éléments avec un sélecteur CSS et applique des modifications aux éléments trouvés.
  • :material-map: Carte — préserve la vue de la carte et ajoute des visites, des curseurs d'historique et des filtres d'entités avec des positions de contrôle configurables.
  • :material-lock: Verrou — superpose un verrou et bloque l'interaction jusqu'à la saisie d'un PIN, d'une phrase secrète ou d'une confirmation.
  • :material-star-four-points-outline: Icône superposée — superpose une ha-icon ou ha-state-icon à un élément.
  • :material-image-outline: Arrière-plan — ajoute un calque d'arrière-plan, couleur, image, vidéo ou caméra, derrière un élément.
  • :material-palette: Thème — applique un thème Frontend à l'élément créé ou à l'un de ses descendants.
  • Formulaire — formulaire Home Assistant avec actions facultatives d'envoi et d'effacement.