FAQ
Comment migrer au mieux depuis Card-mod ?
- Désinstallez Card-mod.
- Si vous utilisez
extra_module_urlpour charger la ressource Card-mod, supprimez cette entrée et redémarrez Home Assistant. - Suivez ensuite le guide de démarrage rapide de UI eXtension.
"Ajouter UI eXtension comme service"
UI eXtension est une intégration à ajouter comme service. Le Marketplace effectue cette étape automatiquement. En cas de problème, vérifiez la présence du service dans Paramètres → Appareils et services. Après une installation manuelle, ajoutez-le vous-même.
UI Lovelace Minimalist peut charger la ressource Card-mod
Si UI Lovelace Minimalist est installé, il peut charger la ressource Card-mod. En raison de l'ordre de chargement des intégrations, UI eXtension ne peut pas détecter ce conflit. Pour continuer à utiliser UI Lovelace Minimalist avec UI eXtension, désactivez l'option Include custom card resources it's depending on dans sa configuration, puis chargez les cartes personnalisées nécessaires avec le Marketplace ou manuellement.
UI eXtension peut-il remplacer Card-mod directement ?
Oui. UI eXtension remplace directement Card-mod jusqu'à la version 4.2.1 et prend en charge les configurations de cartes et de thèmes Card-mod. Il est conseillé d'adopter uix: dans les cartes et uix-<thing>(-yaml) dans les thèmes, mais ce changement n'est pas obligatoire.
UI eXtension est-il simplement Card-mod avec une documentation différente ?
Non. Le code de UI eXtension a évolué pour faire de UIX le domaine et la clé de configuration principaux. Les clés Card-mod restent prises en charge, mais uix: est prioritaire.
Différences entre UI eXtension et Card-mod
- La clé de configuration des cartes est
uix:. - La clé des thèmes est
uix-theme:. - Les clés de thème
thingsontuix-<thing>(-yaml):. - Le nœud HTML de UI eXtension est
<uix-node>; ses propriétés se rapportent toutes àuix. - Vous pouvez utiliser
{# uix.debug #}pour déboguer les modèles. - Tous les messages de débogage de la console commencent par
UIX.
Existe-t-il une liste des différences entre Card-mod et UI eXtension ?
Oui, consultez le tableau ci-dessous.
| Fonctionnalité | Card-mod | UIX |
|---|---|---|
Charge correctement les variables de thème ...-yaml | ❌ Depuis 2026.8.0 | Oui |
Gère correctement la variable de thème ...-more-info(-yaml) | ❌ Depuis 2026.3.0 | Oui |
Adapte correctement les dialogues pour la variable de thème ...-dialog(-yaml) | ❌ Depuis 2026.3.0 | Oui |
| Outils d'inspection du DOM | Non | Oui |
| Sélection de chemin hôte/élément | Non | Oui |
| Sélecteur de recherche rapide | Non | Oui |
| Forge (élément Lovelace personnalisé) | Non | Oui |
| Fonderies (configurations Forge réutilisables) | Non | Oui |
| Macros (modèles Jinja réutilisables) | Non | Oui |
| Sparks (comportements autonomes ajoutés aux éléments Forge) | Non | Oui |
| Broker pour les interactions déclaratives du frontend | Non | Oui |
| Limitation des mises à jour d'état du frontend (facultative) | Non | Oui |
| Délai d'application des styles aux dialogues (facultatif) | Non | Oui |
| Arrière-plans des vues du tableau de bord | Non | Oui |
| Arrière-plans des sections | Non | Oui |
| Arrière-plans des vues | Non | Oui |
| Style des icônes — remplacement par entité | Non | Oui |
| Style des images d'entité | Non | Oui |
| Style des panneaux personnalisés, y compris dans des iFrames | Non | Oui |
| Style des panneaux d'applications et d'Ingress, y compris dans des iFrames | Non | Oui |
| Fenêtre contextuelle pour recharger ou vider le cache | Non | Oui |
| Documentation détaillée avec exemples visuels | Limitée | Oui |
| Mod-card | Oui | Oui |
| Styles CSS dans les thèmes | Oui | Oui |
| Service/action de rechargement ou d'effacement du cache | Oui | Oui |
| Fournit des variables (par exemple l'utilisateur actuel) | Oui | Oui |
| Styles CSS | Oui | Oui |
| URL de ressource | Oui | S.O. |
UI eXtension rencontre-t-il des problèmes d'URL de ressource ?
Non. En tant qu'intégration, UI eXtension gère directement ses URL de ressources. Aucune intervention n'est nécessaire pour garantir son bon fonctionnement. UI eXtension ajoute dynamiquement sa ressource frontend uix.js comme module supplémentaire et ajoute également une ressource de tableau de bord si vous utilisez CAST. À chaque chargement de l'intégration, UI eXtension ajoute automatiquement sa version à ces ressources.
Faut-il vider manuellement le cache des navigateurs et des applications mobiles après une mise à jour de UI eXtension ?
Non. Lorsque UI eXtension détecte qu'un rechargement est nécessaire pour vider les caches, un message temporaire s'affiche avec le bouton Reload Now. La page se recharge automatiquement après 60 secondes.
::: note Le code de rechargement automatique est inclus depuis la version 8.1.0, mais il ne sera disponible qu'après votre prochaine mise à jour. Lors de l'installation de la version 8.1.0, l'appareil utilise encore le code de la version 8.0.1, qui ne comporte pas cette fonction.
:::
Peut-on désactiver le message de rechargement ?
Non. Le message garantit que le code JavaScript UIX du frontend correspond à la version de l'intégration. Il apparaît lorsque UIX a changé et que Home Assistant a redémarré, mais que le navigateur utilise encore un bundle UIX en cache d'une autre version.
La page se recharge automatiquement après 60 secondes, afin que les kiosques sans surveillance actualisent aussi leur frontend.
Aperçu : UIX 9.0.0-beta.0
UIX continue à servir la version chargée au démarrage jusqu’au prochain redémarrage de Home Assistant. Après une mise à jour, redémarrez Home Assistant lorsque vous souhaitez activer la nouvelle version. L’ancienne demande de redémarrage immédiat adressée aux administrateurs en raison d’un frontend mis à jour trop tôt disparaît. Ce comportement fait partie de UIX 9.0.0.
Comment désinstaller UI eXtension ?
Marketplace
Ouvrez UIX dans le Marketplace, puis choisissez Désinstaller dans le menu à trois points. Le Marketplace supprime le service et les fichiers de l’intégration.
Suppression de la configuration du service
La désinstallation supprime aussi les Foundries, les panneaux personnalisés de la barre latérale et les autres réglages du service. Les configurations YAML des tableaux de bord et des thèmes sont conservées, mais cessent de fonctionner sans UIX.
Installation manuelle
Supprimez d’abord l’entrée du service dans Appareils et services, puis le dossier uix dans custom_components.