Couleurs du menu latéral / Sidebar Colors

0.1.0 · Extension frontend · DE / EN / FR · MIT

Attribuer une couleur propre à l’icône et au libellé de chaque entrée Home Assistant. Le nouveau carré de couleur se trouve directement dans Modifier la barre latérale, entre le nom et l’œil. La visibilité et l’ordre restent réglables avec les commandes natives habituelles.

GitHub · Téléchargement / Versions · Ouvrir dans HACS

Sélecteur de couleur

Zone de saturation/luminosité, curseur de teinte, saisie HEX et opacité avec aperçu immédiat. Le damier représente la transparence. Appliquer ferme le sélecteur ; seul Enregistrer dans la fenêtre HA sauvegarde durablement. Annuler abandonne le brouillon correspondant. Couleur du thème supprime la couleur personnalisée de l’entrée.

Exemples de l’utilisateur

Les images montrent des couleurs choisies individuellement pour les icônes et les textes. Des noms identiques restent distincts grâce aux chemins des panneaux. Aucune palette n’est imposée.

Premier résultat avec des couleurs personnalisées.

Autre configuration avec les outils ATLAS.

Prérequis et vérifications

Version minimale prévue : Home Assistant Core 2026.10.3. Tests réels sous 2026.10.4 : choix des couleurs, opacité de 70 % et de 0 %, aperçu, enregistrement/annulation, rechargement, retour au thème, synchronisation entre deux onglets et commandes natives de visibilité/tri. L’utilisateur confirme le résultat. La couleur temporaire du test a été supprimée ; ses couleurs personnelles ont été conservées.

La version minimale repose sur les interfaces disponibles, sans test réel distinct sous 2026.10.3. Marketplace à partir de 2026.11 utilise le même format compatible HACS ; aucun test d’exécution séparé n’y est revendiqué. Description officielle de Marketplace

Installation HACS / Marketplace

Créer d’abord une sauvegarde complète de HA. C’est un plugin frontend, pas une application Supervisor ni une carte à insérer. Il est d’abord disponible comme dépôt personnalisé ; sa publication ne l’ajoute pas automatiquement au catalogue par défaut.

1. Dans HACS, ajouter https://github.com/rockbaer2007/ha-sidebar-colors via Dépôts personnalisés, catégorie Tableau de bord (plugin), puis télécharger Sidebar Colors.
2. À partir de 2026.11, utiliser la procédure correspondante sous Paramètres → Marketplace. Marketplace reprend les réglages HACS ; aucun format de migration séparé n’est requis.
3. Compléter la section frontend: existante. Garder les thèmes et modules présents ; ne pas créer une section en double :

frontend:
  extra_module_url:
    - /hacsfiles/ha-sidebar-colors/ha-sidebar-colors.js

4. Vérifier la configuration, redémarrer HA puis recharger le navigateur. Une ressource de tableau de bord seule ne suffit pas si une autre page HA est ouverte d’abord. L’entrée de module charge aussi l’extension sur ces pages.
5. Maintenir l’en-tête Home Assistant du menu latéral puis cliquer sur un carré de couleur.

Installation manuelle ou migration

Copier le fichier unique ha-sidebar-colors.js de la version publiée dans /config/www/ha-sidebar-colors.js et utiliser /local/ha-sidebar-colors.js comme module. Le ZIP contient le même fichier, la licence et la documentation. Ne pas charger les deux méthodes simultanément.

Pour l’ancien prototype à trois fichiers, remplacer /local/ugso-sidebar-colors/0.1.0/sidebar-colors.js par le nouveau chemin, redémarrer HA puis recharger le navigateur. Le stockage des couleurs reste identique ; les anciens fichiers peuvent rester comme sauvegarde.

Conserver les réglages et mettre à jour

Les couleurs sont enregistrées par utilisateur HA sous la clé séparée ugso_sidebar_colors_v1 et synchronisées sur les appareils où l’extension est chargée. Les chemins des panneaux évitent les confusions de noms. Un enregistrement de couleurs seul ne réécrit ni l’ordre natif, ni les éléments masqués, ni le thème. Configurations des tableaux de bord et autorisations restent inchangées.

Avant l’enregistrement, l’ancien état des couleurs et des préférences est conservé localement dans ugso-sidebar-colors-backup:<user-id>. Cela ne remplace pas une sauvegarde HA complète. Un stockage navigateur plein ou bloqué empêche l’enregistrement. Aucun nouvel identifiant, script externe ou service de traduction cloud n’est nécessaire.

Mettre à jour via le même dépôt HACS/Marketplace, garder le chemin du module puis recharger le navigateur. Pour désinstaller, retirer uniquement l’entrée du module, redémarrer HA et recharger. Les couleurs du thème reviennent et les réglages natifs sont conservés.

Limites

L’extension utilise des méthodes internes des fenêtres HA ; la revérifier après les mises à jour du frontend. Les conflits et confirmations incertaines gardent le brouillon ouvert ; aucune répétition aveugle. Cette API n’offre pas de comparaison/enregistrement atomique. Couleurs et ordre natif sont deux opérations distinctes, avec compensation contrôlée au mieux en cas d’échec.

À 0 % d’opacité, icône et texte peuvent être invisibles, mais le carré reste accessible. Fond de sélection, titres et droits restent inchangés. Les pannes et conflits ont été simulés localement ; aucun test réel sur téléphone/tablette ni coupure réseau provoquée sous Marketplace n’est revendiqué. Détails des tests et code source.