Using the card FR

🇬🇧 English version

Utiliser la carte

Ce que tout le monde voit et touche, éditeur mis à part.

• Disposition · Zoom et déplacement
• Vue de pièce
• Fiches
• Panneaux latéraux
• Bouton Calques pour les visiteurs
• Interaction et tablette murale

Disposition

De haut en bas : le titre et le bouton Modifier le plan (administrateurs), les puces du résumé, le plan entre ses panneaux gauche et droit, et la légende (échelle de température, fermé, ouvert, volet baissé).

• Ordinateur : avec full_page: true (défaut) et une carte d'au moins 760 px de large, la carte remplit la hauteur de l'écran sans barres de défilement et les panneaux tiennent à côté du plan. Pour le meilleur résultat, mettez la carte seule dans une vue Panneau.
• Téléphone : le plan d'abord, les panneaux empilés en dessous, la page défile.

Ordinateur, thème clair	Téléphone, thème sombre

Zoom et déplacement

• Boutons en bas à droite du plan : Zoomer, Dézoomer, Toute la maison (retour au plan entier), et Revoir la journée quand le replay est activé. À la souris, ils apparaissent quand le pointeur survole le plan.
• Ctrl+molette ou pincement sur le pavé tactile d'un ordinateur, pincement à deux doigts au téléphone ; glissez pour vous déplacer une fois zoomé.
• interaction.lock_view: true désactive déplacement et zoom et masque les boutons (les touchers fonctionnent toujours).
• Nouveau en 0.2.1. interaction.zoom_buttons choisit l'emplacement des boutons : map (sur le plan), header (dans l'en-tête, hors du plan), hidden, ou auto (défaut : dans l'en-tête sur un téléphone pour qu'ils ne cachent plus le plan, sur le plan sinon). Contrairement à lock_view, les masquer garde le pincement, le glissement et le toucher des pièces. Éditeur : ⚙ Paramètres › Interaction.

Vue de pièce

Un toucher sur une pièce (son sol ou son étiquette) zoome dessus et ne montre que ce qui la concerne :

• En-tête : « Titre › Pièce », un bouton ← Toute la maison, et la température et l'humidité de la pièce.
• Boutons automatiques (auto_actions, activés par défaut) : Éteindre tout / Allumer tout pour les lumières de la pièce, Ouvrir / Fermer pour ses volets, stores et rideaux.
• Vos boutons (actions) : n'importe quel service, sur une entité ou sur toute la pièce. Les services sensibles sont toujours confirmés dans un dialogue ; confirm: true confirme aussi les autres (Sécurité).
• Scènes liées à la pièce Home Assistant, en boutons.
• Appareils : les pastilles posées dans la pièce, avec un interrupteur pour lumières, prises, ventilateurs, input_boolean et humidificateurs.
• Ouvertures : une ligne par baie, « Ouverte / Fermée · volet 70 % ».
• Automatisations (et scripts) liées à la pièce Home Assistant ou aux entités de la pièce, avec « il y a 5 h » et un interrupteur marche / arrêt (automations: false les masque).
• Panneaux : les panels propres à la pièce, à la place des panneaux de la maison.

On la ferme avec ←, un toucher hors de la pièce, Toute la maison, ou automatiquement après interaction.reset_after secondes. Une sous-zone ouvre la pièce qui la contient ; zoom: false désactive la vue d'une pièce.

rooms:
  - name: Séjour
    poly: [[0, 0], [500, 0], [500, 420], [0, 420]]
    area: living_room
    actions:
      - name: Mode cinéma
        icon: mdi:movie-open-outline
        action: scene.turn_on
        target: scene.movie
      - name: Tout éteindre
        icon: mdi:power
        action: homeassistant.turn_off
        target: room          # la pièce Home Assistant si elle est liée, sinon les entités de la pièce
        confirm: true         # dialogue de confirmation
      - name: Lumière chaude
        icon: mdi:lightbulb-on
        action: light.turn_on
        target: light.living_room
        data: {color_temp_kelvin: 2700, brightness_pct: 60}

target: room utilise l'area de la pièce quand elle est liée, sinon les entités de la pièce du domaine du service (toutes pour homeassistant.*). Toute autre target est un identifiant d'entité. Ces boutons appellent exactement le service écrit dans la configuration : gardez confirm: true pour tout ce qui est sensible.

Fiches

Une fiche est le dialogue ouvert par un toucher sur un meuble connecté, ou sur une ouverture ou une pastille qui a une card (ou tap: card). Une feuille en bas au téléphone.

Fiche d'une borne de recharge (ordinateur)	Fiche d'une baie (téléphone)

• En-tête : icône (allumée quand l'élément est actif), titre (card.title, sinon le nom de l'élément), état et valeur ; un interrupteur marche / arrêt pour les entités light, switch, fan, input_boolean et humidifier, sauf avec protected: true (un bouton Rallumer n'apparaît alors que quand l'appareil est éteint) ; un bouton Plus d'infos ⓘ ; ✕.
• Corps : les widgets (mêmes types que dans les panneaux). Dans une fiche, les lignes des listes montrent des valeurs, pas des interrupteurs ; un toucher sur une valeur ouvre son plus d'infos. Les widgets cover, lock et thermostat fonctionnent dans une fiche.
• Taille sur ordinateur : environ 420 px pour un widget, 760 px pour deux (deux colonnes), jusqu'à 1120 px et trois colonnes au-delà.
• Échap, ✕ ou un toucher à l'extérieur la ferme ; les ouvertures avec une fiche sont aussi accessibles au clavier (Entrée / Espace).

badges:
  - entity: switch.fridge_plug
    pos: [80, 60]
    icon: mdi:fridge-outline
    protected: true             # jamais « arrêt » depuis le plan
    card:
      title: Frigo
      more_info: /energy        # le bouton ⓘ ouvre le tableau de bord Énergie
      widgets:
        - {type: tile, title: Puissance, entity: sensor.fridge_power, history: 24}
        - {type: entities, entities: [sensor.fridge_temperature, {entity: sensor.fridge_energy, name: Total}]}

card.more_info : une entité (son plus d'infos ; défaut : l'entité principale de l'élément), un chemin de tableau de bord (/energy), une URL (https://…, nouvel onglet) ou false pour masquer le bouton. card peut aussi être une simple liste de widgets.

Panneaux latéraux

Des colonnes de widgets à gauche et à droite du plan (panels.left, panels.right). Une vue de pièce montre à la place les panneaux propres à la pièce. Dans l'éditeur, glissez les widgets dans un panneau et d'un panneau à l'autre.

Bouton Calques pour les visiteurs

Avec layers.view_button: true (⚙ Paramètres › Affichage), un bouton Calques affichés à côté des boutons de zoom permet à chaque visiteur de masquer des calques (meubles, halos, textes…) pour lui-même ; le choix reste dans son navigateur, jamais dans la configuration.

Interaction et tablette murale

interaction:
  room_tap: room_view   # room_view (vue de pièce, défaut) | more_info | none
  lock_view: false      # true : pas de déplacement, pas de zoom, boutons de zoom masqués
  zoom_buttons: auto    # auto (en-tête sur téléphone, plan sinon) | map | header | hidden
  reset_after: 0        # secondes sans interaction avant de revenir au plan entier ; 0 = jamais
tablet: true            # ou {summary: false, panels: false, burn_in: true}
animation_level: full   # full | reduced | none

• room_tap: more_info ouvre le plus d'infos de l'entité tap de la pièce (sinon de sa temperature) ; none ne fait rien.
• reset_after ferme la vue de pièce et les fiches, remet le zoom et ramène un replay en pause au direct (jamais pendant l'édition ni pendant la lecture d'un replay). L'éditeur accepte jusqu'à 3600 s.
• Mode tablette murale (tablet: true) : les puces du résumé et les panneaux latéraux sont masqués, le plan remplit la carte, en pleine page et centré. Avec title: "", il n'y a pas d'en-tête (le bouton Modifier le plan rejoint les boutons de zoom). tablet.summary / tablet.panels font revenir les puces / panneaux ; burn_in (activé par défaut) décale toute la carte d'un pixel toutes les trois minutes, dans un rayon de 2 px, pour protéger l'écran.
• Le niveau d'animation limite les mouvements.

Conseillé pour une tablette murale :

title: ""
tablet: true
interaction:
  lock_view: true
  reset_after: 60