Editor guide FR

🇬🇧 English version

Guide de l'éditeur

L'éditeur est intégré à la carte. Il modifie une copie du plan, l'affiche en direct, et l'écrit dans la configuration du tableau de bord quand vous cliquez sur Enregistrer.

• Ouvrir l'éditeur
• Barre d'outils · Raccourcis clavier
• Dessin et magnétisme
• Sélectionner, déplacer, grouper
• Annuler, brouillon, enregistrement et versions
• Le catalogue Ajouter
• Barre flottante et fenêtres d'édition (nouveau en 0.2.0)
• Ateliers : Créer un widget · Créer une ouverture · Créer un meuble
• Mes modèles
• Export et import
• Calques · Ambiance et animations · Paramètres
• Sur téléphone ou tablette
• Nettoyer le plan

Ouvrir l'éditeur

Le bouton Modifier le plan (règle et crayon) est en haut à droite de la carte. Il n'apparaît que :

• pour les administrateurs de Home Assistant ;
• quand editor: false n'est pas réglé (⚙ Paramètres › Général › Bouton d'édition (crayon) ; pour retrouver un bouton masqué, retirez editor: false dans l'éditeur de code de la carte) ;
• hors du sélecteur de cartes et hors du mode édition du tableau de bord.

À l'ouverture, la zone de dessin est le plan plus une marge de 5 m de chaque côté (elle s'agrandit quand on dessine près du bord). Au téléphone, la vue est cadrée sur le plan. Si le plan contient des éléments sans coordonnées valides (une pièce sans trois sommets, un mur sans extrémités), un message indique combien seront retirés au prochain enregistrement.

Barre d'outils

Sur ordinateur, de gauche à droite :

Groupe	Bouton	Raccourci
Historique	Annuler · Rétablir	Ctrl+Z · Ctrl+Y (ou Ctrl+Maj+Z)
Outils	Sélection	V
	Mur	M
	Limite / clôture	L
	Ouverture	O
	Pièce rectangulaire avec ses murs	R
	Pièce de forme libre	P
	Texte	T
Grille	Grille : 5 cm ▾ : pas de 1, 5, 10 ou 25 cm (aussi le pas du magnétisme et des flèches)
	Recadrer : tout le plan avec la marge de 5 m
Fenêtres	Calques · Ambiance et animations
Fichiers	Nettoyer le plan (baguette magique, voir Nettoyer le plan) · Exporter / importer le plan (YAML, JSON) · Paramètres ⚙ · Raccourcis clavier ⌨	?
Fin	Ajouter	A
	Quitter · Appliquer (enregistrer sans quitter) · Enregistrer (enregistrer et quitter ; un point = modifications non enregistrées)	Ctrl+S = Appliquer

Au téléphone, la barre a deux rangées : Grille, ⋮ Plus d'outils (Recadrer, Calques, Ambiance et animations, Nettoyer le plan, Restaurer un plan d'avant nettoyage s'il y en a un, Importer / exporter, Paramètres), Ajouter, Quitter et Enregistrer en haut ; Annuler, Rétablir et les sept outils en dessous.

Raccourcis clavier

Appuyez sur ? (ou sur le bouton ⌨) pour afficher cette liste dans l'éditeur.

Touches	Action
Ctrl+Z · Ctrl+Y / Ctrl+Maj+Z	Annuler · rétablir
Ctrl+S	Appliquer : enregistrer sans quitter (même pendant la saisie dans un champ)
Entrée · double-clic	Ouvrir la fenêtre d'édition de la sélection
A	Ajouter un objet ou un widget
Échap	Annuler l'outil, désélectionner, fermer une fenêtre (← revient à la précédente)
V M L O R P T	Sélection, Mur, Limite / clôture, Ouverture, Pièce rectangulaire, Pièce de forme libre, Texte
Clic · Ctrl+clic (ou Maj+clic)	Sélectionner · ajouter à la sélection ou en retirer
Glisser dans le vide	Cadre de sélection
Ctrl+A	Tout sélectionner (sauf calques masqués et verrouillés)
Flèches · Maj+flèches	Déplacer d'un pas de grille · de dix pas
Suppr (ou Retour arrière)	Supprimer
Ctrl+D	Dupliquer
Ctrl+G · Ctrl+Maj+G	Grouper · dégrouper
Espace+glisser · bouton du milieu	Déplacer la vue
Ctrl+molette · pincement	Zoomer
Alt (maintenu)	Sans magnétisme
Maj (pendant un tracé)	Angle libre
Entrée · clic droit · double clic	Terminer un mur, une clôture ou une pièce de forme libre

Sur Mac, Cmd fonctionne comme Ctrl.

Dessin et magnétisme

Outil	Comment
Mur (M)	Cliquez pour enchaîner les segments ; terminez avec Entrée, Échap, clic droit ou double clic (Terminer sur écran tactile). Chaque segment est une étape d'annulation.
Limite / clôture (L)	Comme les murs ; trait plus fin (fences).
Pièce rectangulaire (R)	Cliquez deux coins opposés : la pièce et ses quatre murs sont créés, sans doubler un mur existant. Une bulle affiche largeur × hauteur · surface. Réglez ensuite la Largeur et la Hauteur exactes (cm) dans sa fenêtre d'édition.
Pièce de forme libre (P)	Cliquez chaque sommet ; refermez sur le premier, avec Entrée ou Terminer.
Ouverture (O)	Cliquez ses deux extrémités sur un mur. Le côté extérieur est réglé tout seul (à l'opposé de la pièce intérieure). Armée depuis un préréglage, ses capteurs sont cherchés dans la pièce.
Texte (T)	Un clic pose un texte et sélectionne son champ. Ajouter › Zone d'informations pose plutôt un cadre de valeurs en direct.

Magnétisme, dans cet ordre : Alt maintenu pour aucun ; pendant un tracé, un segment à moins d'environ 15° de l'horizontale ou de la verticale est redressé (Maj pour un angle libre) ; les points s'aimantent aux extrémités de murs, de clôtures et d'ouvertures et aux sommets des pièces à moins de 12 px ; sinon à la grille. Pas d'aimantation à 45° ni d'outil de mesure : la bulle près du curseur affiche longueurs, tailles et surfaces.

Sommets des pièces : glissez un sommet ; le point au milieu d'une arête ajoute un sommet ; un double clic sur un sommet le retire (il en reste au moins trois). Changer la Largeur / Hauteur d'une pièce rectangulaire déplace ses bords droit et bas avec leurs murs, ouvertures et meubles ; un mur partagé avec une voisine reste et un nouveau mur est ajouté.

Les meubles se déplacent sur la grille (Alt : 1 cm) et se collent à l'intérieur des murs horizontaux et verticaux. Les poignées des coins les redimensionnent (Maj garde les proportions).

Sélectionner, déplacer, grouper

• Pièces : le premier clic sélectionne la pièce ; une fois sélectionnée, glissez-la pour la déplacer avec les meubles et les sous-zones qu'elle contient. L'étiquette se déplace seule. Un second clic sur une sous-zone sélectionne la pièce qui l'entoure.
• Cadre de sélection : glissez dans le vide ; garde ce qui est entièrement dedans. Ctrl ou Maj ajoute à la sélection.
• Sélection multiple (détails) : nombres, Aligner (gauche, centre, droite, haut, milieu, bas) avec au moins deux pastilles, textes ou meubles, Répartir horizontalement ou verticalement avec au moins trois, Grouper, Dupliquer, Supprimer.
• Groupes (groups) : le premier clic sur un membre sélectionne tout le groupe, un second clic l'élément seul.
• Dupliquer décale la copie de 40 cm ; pas de copier / coller entre plans (utilisez les modèles ou l'export).
• Supprimer affiche un message avec Annuler. Supprimer une pièce garde ses meubles et sous-zones et propose de les supprimer aussi.
• Rotation (meubles) : boutons ±15° et ±90°, ou champ d'angle.

Annuler, brouillon, enregistrement et versions

• Annuler / rétablir : 150 étapes. Le bouton Annuler d'un message ne marche que si rien d'autre n'a changé depuis.
• Brouillon : chaque modification est gardée dans le navigateur (localStorage). À l'ouverture de l'éditeur, si un brouillon existe, un message propose Reprendre ou Supprimer. Quitter la page avec des modifications non enregistrées demande confirmation.
• Appliquer (Ctrl+S) enregistre et garde l'éditeur ouvert (Plan enregistré.) ; Enregistrer enregistre et quitte l'éditeur. Nouveau en 0.2.0. Les deux écrivent dans le tableau de bord (lovelace/config/save). La carte est retrouvée par son id (écrit au premier enregistrement s'il manque). Si la carte a changé entre-temps (autre navigateur, éditeur YAML), le dialogue Plan modifié ailleurs propose Exporter mon plan, Annuler ou Écraser avec mon plan. Un tableau de bord en mode YAML ne peut pas être enregistré : exportez le plan et collez-le dans votre YAML.
• Un tableau de bord Maquette créé par Ajouter un tableau de bord est converti en vues ordinaires au premier enregistrement.
• Versions précédentes : les cinq dernières versions remplacées par un enregistrement sont gardées dans le navigateur et listées dans le dialogue Exporter / importer, avec Charger.
• Quitter avec des modifications non enregistrées demande : Continuer l'édition, Abandonner les modifications ou Quitter (le brouillon reste dans le navigateur).

Le catalogue Ajouter

Ajouter (touche A) ouvre le catalogue. Onglets : Tout, Pièces, Appareils, Ouvertures, Meubles, Widgets, et Mes modèles dès que vous en avez. La recherche ignore accents et majuscules ; chaque mot doit correspondre ; elle couvre tous les onglets, widgets prêts à l'emploi compris, et met en tête les noms qui correspondent.

Onglet	Entrées
Pièces et tracé	Pièce Home Assistant (tracer une pièce liée à une pièce HA, avec ses appareils) · Toutes mes pièces HA (une pièce par pièce HA, voir Premiers pas) · Pièce rectangulaire · Pièce de forme libre · Mur · Limite / clôture · Texte · Zone d'informations
Appareils	Lumière (halo) · Prise / interrupteur · Appareil mesuré (valeur et « actif » d'après un capteur de puissance) · Caméra (clignote) · Détecteur de mouvement · Thermostat · Capteur (valeur) · TV / média · Appareil libre
Ouvertures	Créer une ouverture · Fenêtre + volet + contact · Fenêtre + contact · Fenêtre oscillo-battante · Porte + volet + contact · Porte + contact · Porte-fenêtre + volet + contact · Baie coulissante · Porte intérieure · Porte de garage · Portail
Meubles	Créer un meuble · Sous-zones (Cuisine, Douche, Coin repas, Coin salon, Coin bureau, Dressing, Buanderie, Entrée, Sous-zone) · 45 meubles en 8 catégories, voir Meubles
Widgets	Les 10 types de base et Tous les widgets (65 prêts à l'emploi, voir Widgets) ; ← / → sur une tuile choisit le panneau gauche ou droit
Mes modèles	Vos pastilles, ouvertures et widgets enregistrés (un meuble personnalisé apparaît dans sa catégorie)

Un appareil demande une entité (sélecteur complet, filtré par domaine), puis un clic sur le plan. Les champs restés vides sont surlignés en orange « à compléter ».

Pré-remplissage des entités

Ouvertures, widgets prêts à l'emploi et modèles de meubles connectés cherchent les entités qui conviennent (domaine, classe d'appareil, unité, mots du nom) dans la pièce où ils vont :

• une seule correspond : elle est reliée ;
• plusieurs : une petite liste (Dans « pièce » d'abord, puis Ailleurs) avec Autre entité… (sélecteur complet) et Ignorer ;
• aucune : le champ reste surligné « à compléter ».

La pièce est son area, sinon la pièce Home Assistant de même nom (accents et majuscules ignorés), sinon la seule dont le nom contient celui de la pièce ou y est contenu (quatre lettres au moins). Détails par élément : Entités.

Barre flottante et fenêtres d'édition

Nouveau en 0.2.0 : le panneau latéral n'existe plus. Tous les éléments (pièce, ouverture, pastille, meuble, texte, zone d'informations, mur, limite, widget, puce du résumé) fonctionnent de la même façon :

1. Cliquez-le : ses poignées apparaissent, avec une petite barre flottante à côté, toujours hors de l'élément et visible (elle suit le zoom et le déplacement) : Modifier, Dupliquer, verrou, Premier plan / Arrière-plan, Supprimer.
2. Modifier, un double-clic ou Entrée ouvre sa fenêtre d'édition, en onglets, avec un aperçu en direct : l'élément découpé dans le vrai plan, dans sa pièce (un widget ou une puce se montre lui-même). Ctrl+Z y fonctionne ; Appliquer garde le changement, Échap ferme. Plein écran au téléphone.
3. Un élément choisi dans une fenêtre (ou dans Calques) ouvre la sienne ; ← ou Échap revient en arrière.

Ordinateur	Téléphone

Élément	Onglets et champs principaux
Pièce	Général : nom, largeur / hauteur (rectangles), température, humidité, Réglages avancés, Extérieur, Sous-zone, Vue de la pièce au toucher, Afficher l'étiquette · Pièce Home Assistant : liaison, Intégrer les appareils de la pièce, À placer sur les murs · Vue de la pièce : panneaux gauche / droit, Boutons automatiques, Afficher les automatisations liées, Boutons d'action
Ouverture	Général : nom, type, Vantaux, Ouverture (aucune, gauche, droite, coulissant), Ouvre vers l'extérieur, côté extérieur, Baie (vantaux regroupés) · Capteurs : contact (Ajouter un capteur), volet, entité motorisée, volet seul · Lumière : vitrage de la porte, allège, hauteur, avancée de toit, lames · Fiche · Animation. En bas : Modifier dans l'atelier
Pastille	Général : entité, nom, icône, Couleur quand actif, Halo quand allumée, valeur affichée, clignote quand actif · Réglages avancés : entité ou attribut « actif », Actif au-dessus de, unité, décimales, halo limité à une pièce · Fiche · Animation
Meuble	Général : nom, type, largeur / profondeur, chaises, orientation et Miroir, Position · Connecté : entité, valeur, couleur, toucher, protégé, fiche, Remplir depuis l'appareil, Fusionner avec une pastille proche · Animation (une fois connecté). En bas : Personnaliser la forme, modèle
Texte / Zone d'informations	Général : texte, taille, position · pour une zone d'informations : Général (titre, style encadré ou discret, taille, position) et Entités (n) : ses lignes d'entités
Mur / clôture	Général : coordonnées de départ et d'arrivée. En bas : En limite / En mur, Couper en deux
Widget	Général : titre, icône, couleur d'accent et les champs de son type ; monter / descendre, vers l'autre panneau, dupliquer, modèle
Puce du résumé	Général : champs de la puce entité, alerte, masquage, affichage (toujours / personne à la maison / quelqu'un à la maison), icône, empilement. En bas : ← / → pour la déplacer

Chaque fenêtre a Masquer en vue et Premier plan / Arrière-plan (ordre dans son calque). Les aides sont derrière ⓘ.

Pièce	Ouverture

Sélection multiple

Sélectionnez plusieurs éléments (cadre, Ctrl+clic, Ctrl+A) : la barre flottante agit sur tous (Modifier, Dupliquer, verrou, Supprimer). Modifier ouvre une fenêtre avec les réglages communs (Général : Aligner, Masquer en vue, nom du groupe), la liste de la sélection (Sélection) et les actions groupées (Grouper, verrou, dupliquer, supprimer), en aperçu ensemble.

Verrou, couleurs nommées, pastilles dans leur pièce

Nouveau en 0.2.0 :

• Verrou (cadenas dans la barre flottante, la fenêtre d'édition et Calques › Éléments du plan ; locked: true sur une pièce, une ouverture, une pastille, un texte ou un meuble) : toujours sélectionnable et modifiable, mais plus déplacé ni redimensionné à la souris ou aux flèches, et un clic dessus va à l'élément dessous. Les murs et les limites se verrouillent par calque.

• Couleurs nommées (⚙ Paramètres › Affichage › Couleurs nommées, palette) : proposées dans chaque sélecteur de couleur ; un élément qui utilise un nom suit la palette quand elle change.

  palette:
    accent: "#e8710a"
    bleu_mur: "rgb(30, 90, 160)"
  badges:
    - {entity: light.sejour, pos: [200, 150], color: accent}

• Pastilles seulement dans la vue de leur pièce : zoom_only: true sur une pastille, ou badge_style.zoom_only: true pour toutes (⚙ Paramètres › Pastilles d'appareils).

Section Fiche (ouverture, pastille, meuble) : Au toucher, en vue (par défaut, ouvrir sa fiche, plus d'infos, rien), Protégé, Toujours demander confirmation (marche / arrêt confirmés, voir Sécurité), titre de la fiche, Bouton « Plus d'infos », ses widgets, Ajouter un widget, Remplir depuis l'appareil (un aperçu des widgets proposés depuis le même appareil, puis Ajouter ou Remplacer la fiche), Enregistrer la fiche comme modèle. Tant que l'élément est sélectionné, la colonne de droite montre sa vraie fiche.

Ateliers

Un atelier est un dialogue en deux étapes : 1. Choisir le type, puis 2. Réglages avec un aperçu en direct. Ajouter pose le résultat, Enregistrer dans Mes modèles le garde pour plus tard (au besoin avec Entités à choisir à chaque ajout). Plein écran au téléphone.

Créer un widget

Ajouter un widget › Créer un widget : choisissez l'un des 11 types (Tuile + courbe, Jauge, Liste d'entités, Commande, Serrure, Thermostat, Climat des pièces, Périodes, Tarif en direct, Véhicule électrique, Séparateur), réglez l'essentiel (titre, icône, entités, unité, min / max…) et le panneau (gauche ou droit ; la fiche quand il est ouvert depuis une fiche).

Créer une ouverture

Ajouter › Ouvertures › Créer une ouverture : choisissez un préréglage, puis le nom, le type, les vantaux, le côté d'ouverture, vers l'extérieur, les capteurs (contact, volet, motorisation ; laissés vides, ils sont cherchés dans la pièce à la pose) et l'animation, avec un aperçu sur un bout de mur. Ajouter arme l'outil Ouverture : cliquez ses deux extrémités sur un mur. Une ouverture tracée se rouvre dans l'atelier avec Modifier dans l'atelier pour appliquer un autre préréglage sans la redessiner.

Créer un meuble

Ajouter › Meubles › Créer un meuble : partez d'une forme de base (rectangle, rectangle arrondi, rond, forme en L) ou de n'importe quel meuble du catalogue, puis réglez le nom, la taille, la catégorie, les mots de recherche, la couleur, une entité éventuelle et la liste des formes. Les formes se modifient directement dans l'aperçu :

• cliquez une forme pour la sélectionner (sa ligne est surlignée), glissez-la, redimensionnez-la avec ses 8 poignées (Maj garde les proportions) ;
• glissez les points des traits et des polygones ; le + au milieu d'une arête ajoute un point ; un appui long, Suppr ou le bouton de la ligne en retire un (un polygone en garde au moins 3) ;
• aimantation sur une grille de 5 cm et aux bords et centres du meuble et des autres formes, avec des guides ; Alt ou le bouton aimant la coupe ; les formes restent dans le meuble ;
• les flèches déplacent de 1 cm (Maj : 10 cm) ; Ctrl+Z / Ctrl+Y annulent dans l'atelier ; Agrandir l'aperçu grossit l'aperçu.

Un meuble posé se rouvre dans le même atelier avec Personnaliser la forme (meuble du catalogue) ou Modifier la forme (meuble personnalisé). Le YAML est décrit dans Meubles › Meubles personnalisés.

Mes modèles

Presque tout s'enregistre pour être réutilisé, dans la configuration de la carte (templates) :

Depuis	Bouton	Option
Une pastille, une ouverture, un widget	Modèle dans sa fenêtre d'édition	Garder les entités (sinon elles sont demandées à chaque usage)
Un meuble	Modèle	Garder les entités (seulement s'il est connecté)
Une fiche	Enregistrer la fiche comme modèle	Garder les entités
Un atelier	Enregistrer dans Mes modèles	Entités à choisir à chaque ajout

Les modèles apparaissent dans Ajouter › Mes modèles (un meuble personnalisé dans sa catégorie du catalogue, avec ✎ pour le modifier) ; 🗑 en supprime un (annulable avec Ctrl+Z). Les champs d'entité à choisir (ask) sont vidés et surlignés pour les widgets, cherchés dans la pièce pour les ouvertures et les meubles.

Export et import

Le bouton Exporter / importer montre tout le plan en YAML ou en JSON (clés anglaises, exactement comme dans le tableau de bord) :

• Copier, Télécharger (plan-<id>.yaml ou .json), Ouvrir un fichier… (.yaml, .yml, .json) ;
• collez un plan et cliquez sur Importer : il remplace le plan actuel en une seule étape annulable et garde le type et l'id de la carte ; Enregistrer pour le garder ;
• Versions précédentes : Charger met une version enregistrée dans la zone de texte, puis Importer.

L'import vérifie la structure (listes, contours des pièces) et refuse les plans écrits avec les anciennes clés françaises (pieces, murs…). Un plan différent du plan actuel affiche d'abord Vérifier avant d'importer : les services de ses boutons de pièce (les sensibles marqués), les entités que ses widgets commandent, ses liens, les valeurs retirées car invalides et les clés du tableau de bord ignorées ; rien n'est appliqué avant un clic sur Importer. N'importez que des plans de personnes de confiance : voir Sécurité › Vérification à l'import.

Calques

Calques (une fenêtre depuis la 0.2.0) liste les calques en deux groupes, Au-dessus du dessin (étiquettes des pièces, étiquettes des zones, appareils, textes) et Dessin (pièces, sous-zones, halos de lumière, meubles, limites, murs, ouvertures). Glissez une ligne (ou ↑ / ↓) pour changer l'ordre, 👁 pour masquer un calque en vue, 🔒 pour laisser passer les clics dans l'éditeur. Éléments du plan liste chaque pièce, appareil, ouverture, meuble, texte, widget, puce et groupe : un clic ouvre sa fenêtre d'édition, Échap revient à Calques. Voir Dessiner le plan › Calques et groupes.

Ambiance et animations

Nouveau en 0.2.0 : une fenêtre à 6 onglets, comme ⚙ Paramètres : Général (ambiance : intensité, nord, jour et nuit, météo, traces), Lumière (lumière, avec une pièce fictive à n'importe quelle heure et par n'importe quel temps), Personnes, Énergie, Animations (par événement) et Alertes (alertes plein plan). L'ambiance n'est dessinée dans l'éditeur que pendant qu'elle est ouverte (un aperçu en direct sur le plan derrière). Personnes › Placer sur le plan permet de glisser les avatars des personnes présentes.

Ordinateur	Téléphone

Paramètres

⚙ Paramètres regroupe les options de toute la carte, en onglets : Général, Affichage, Fonctions, Pièces et légende, Personnes sur le plan (quand les personnes sont affichées), Pastilles d'appareils, Interaction. Affichage contient aussi les Couleurs nommées et un lien vers l'onglet Lumière. Les changements sont prévisualisés en direct et annulables ; un réglage remis à sa valeur par défaut sort du YAML ; un nombre hors bornes est refusé. La liste complète des champs et des clés est dans Référence › Réglages généraux.

Sous le titre : la version installée (Maquette 0.2.0) et deux liens, Documentation (le README du dépôt) et Signaler un problème (ses issues). Indiquez la version quand vous signalez un problème.

Sur téléphone ou tablette

• La barre a deux rangées ; les boutons moins fréquents sont dans ⋮ Plus d'outils.
• Touchez un élément pour sa barre flottante ; sa fenêtre d'édition et les autres fenêtres sont en plein écran.
• Terminez murs, clôtures et pièces de forme libre avec Terminer. Pincez pour zoomer.
• Le dialogue Ajouter un widget et les ateliers sont en plein écran ; dans Créer un meuble, l'aperçu reste en haut pendant qu'on fait défiler le formulaire, et un appui long retire un point.
• Les indications clavier et le bouton des raccourcis sont masqués sur les écrans seulement tactiles.

Éditeur	Plus d'outils