Repository navigation
Widgets FR
Les widgets remplissent les panneaux latéraux à côté du plan (panels.left, panels.right), les panneaux d'une
vue de pièce (rooms[].panels) et les fiches ouvertes depuis les éléments du plan (card.widgets). Les mêmes
11 types fonctionnent partout, et l'éditeur propose 65 widgets prêts à l'emploi construits dessus.
- Panneaux
- Clés communes et lignes
- Types : tile · gauge · entities · cover · lock · thermostat · climate · periods · tariff · ev · divider
- Widgets prêts à l'emploi (65, par catégorie)
- Ajouter des widgets dans l'éditeur
panels:
left:
- {type: tariff, title: Tarif en direct, price: sensor.kwh_price, period: sensor.tariff_period}
right:
- {type: gauge, title: Puissance, entity: sensor.home_power, min: 0, max: 9000, unit: W}
rooms:
- name: Bureau
poly: [[0, 0], [300, 0], [300, 300], [0, 300]]
panels: # affichés à la place des panneaux de la maison tant que la vue de cette pièce est ouverte
left: [{type: climate, rooms: [Bureau]}]Sur ordinateur, la carte prend toute la hauteur sans barres de défilement (full_page) et les panneaux tiennent à côté du
plan ; sur un écran étroit, ils s'empilent sous le plan. Le mode tablette les masque sauf avec tablet.panels: true.
| Clé | Signification |
|---|---|
type |
Type de widget (obligatoire) |
title |
Titre de l'en-tête (cover, lock, thermostat : nom de l'entité par défaut) |
icon |
Icône de l'en-tête (une par défaut selon le type) |
color |
Couleur d'accent (icône, courbe, barre de position ; l'arc d'une jauge sans severity) |
rows |
Lignes supplémentaires sous tile, gauge, tariff, ev, cover, lock et thermostat
|
confirm |
true : chaque service du widget demande confirmation, même sûr (interrupteurs et Activer de ses lignes, − / + du thermostat, boutons cover et lock). Voir Sécurité
|
Une ligne (et un élément du widget entities) est un identifiant d'entité ou {entity, name, icon, decimals, unit} :
rows:
- sensor.outdoor_humidity
- {entity: sensor.outdoor_pressure, name: Pression, icon: mdi:gauge, decimals: 0, unit: hPa}À droite d'une ligne : un interrupteur pour light, switch, fan, input_boolean et humidifier (panneaux latéraux seulement),
un bouton Activer pour scene, script, button et input_button (panneaux latéraux seulement ; scripts et boutons
demandent confirmation), sinon la valeur (en rouge pour un détecteur à on). Un
toucher sur une valeur ouvre le plus d'infos. Dans l'éditeur, les widgets s'affichent en direct mais un toucher les
sélectionne au lieu d'agir.
Une grande valeur, avec une courbe d'historique facultative.
- type: tile
title: Puissance de la maison
icon: mdi:flash
entity: sensor.home_power
unit: W
decimals: 0
history: 24 # heures de courbe ; 0 ou absent = pas de courbe
rows: [{entity: sensor.coffee_machine_power, name: Machine à café}]
La courbe lit l'historique de Home Assistant (en cache 5 minutes). Un état non numérique est affiché formaté. Sans
title, l'en-tête n'a pas de titre.
Une valeur sur un arc entre min (0 par défaut) et max (100 par défaut).
- type: gauge
title: CO₂
icon: mdi:molecule-co2
entity: sensor.living_room_co2
min: 400
max: 2000
unit: ppm
decimals: 0
severity: {green: 0, yellow: 800, red: 1200} # chaque couleur à partir de sa valeur
Couleur : severity (comme la carte jauge de Home Assistant : la couleur dont la valeur est la plus haute sous la valeur
actuelle), sinon color, sinon vert sous 60 %, orange sous 85 %, rouge au-delà. Le pourcentage est affiché quand max
est réglé.
Une liste d'entités, avec interrupteurs et boutons Activer (voir lignes).
- type: entities
title: Séjour
icon: mdi:sofa-outline
entities:
- light.living_room
- {entity: scene.movie, name: Cinéma}
- binary_sensor.bathroom_leak
Commande d'un cover (volet, store, portail, porte de garage) ou d'une valve.
- type: cover
title: Portail
entity: cover.gate
confirm: true # défaut : true pour les classes garage, gate, door et pour les vannes
État, position (current_position) avec une barre, Ouvrir, Stop, Fermer (chacun masqué quand l'entité ne le
permet pas, tous inactifs quand elle est indisponible). Avec confirm, chaque bouton ouvre un dialogue de confirmation
qui nomme l'action et l'entité. Ouvrir une vanne, une porte de garage, un portail, une porte ou une cover sans classe est
toujours confirmé (confirm: false ne le retire pas). Une entité d'un autre domaine dans entity est écartée.
- type: lock
title: Porte d'entrée
entity: lock.front_door
# Déverrouiller et Ouvrir sont toujours confirmés ; confirm: true = Verrouiller aussi
Déverrouiller quand elle est verrouillée, Verrouiller quand elle est déverrouillée, les deux quand elle est bloquée ou inconnue, Ouvrir si c'est possible. Rouge quand elle est déverrouillée, ouverte ou bloquée. Aucun code n'est envoyé.
- type: thermostat
entity: climate.thermostat
rows: [sensor.living_room_humidity]
Température actuelle, consigne avec − / + (climate.set_temperature, pas de l'appareil ou 0,5, entre min_temp et
max_temp), action en cours (Chauffe, Refroidit, Inactif…) et mode avec préréglage. Les boutons sont inactifs quand
l'entité n'a pas une consigne unique (par exemple heat_cool avec une basse et une haute).
Température et humidité de chaque pièce qui a des capteurs, avec leur tendance.
- type: climate
title: Climat des pièces
duration: 30 # fenêtre de tendance en minutes (5 à 240)
rooms: [Chambre, Séjour] # défaut : toutes les pièces avec un capteur (hors sous-zones)
outside: false # masque les espaces extérieurs (défaut true = affichés)
average: true # première ligne : moyenne intérieure et sa tendance
stable_t: 0.3 # flèche à plat en dessous de cette variation (°C)
alert_t: 1.5 # alerte à partir de cette variation
stable_h: 2 # pareil pour l'humidité (%)
alert_h: 10
t_min: 16 # limites absolues facultatives
t_max: 28
h_min: 30
h_max: 70
Une ligne par pièce (les pièces qui partagent les mêmes capteurs n'apparaissent qu'une fois), des flèches d'après la
variation sur duration (historique de Home Assistant), une icône d'alerte rouge quand la variation ou une limite est
dépassée. Les capteurs lus par un attribut n'ont pas de tendance.
Un tableau jour / semaine / mois / année, depuis les statistiques à long terme de Home Assistant ou depuis quatre entités par colonne.
- type: periods
title: Consommation
periods: [day, week, month, year] # défaut : les quatre
note: D'après le compteur électrique
columns:
- {name: Énergie, unit: kWh, stat: sensor.total_energy, factor: 0.001, decimals: 1}
- name: Coût
unit: €
day: sensor.cost_today
week: sensor.cost_week
month: sensor.cost_month
year: sensor.cost_year
stat est un capteur cumulatif avec statistiques (énergie, gaz, eau, coût) : chaque case est sa variation sur la période
calendaire (recorder/statistic_during_period, en cache 5 minutes). factor (1 par défaut) multiplie les valeurs, avec
stat comme avec les quatre entités ; decimals vaut 2 par défaut. L'éditeur écrit aussi source: stat | entities.
Prix de l'électricité en direct, période en cours et couleurs Tempo.
- type: tariff
title: Tarif en direct
price: sensor.kwh_price # 4 décimales ; unité de l'entité, sinon €/kWh
period: sensor.tariff_period # vert quand il contient « creuse » (ou « off-peak »), orange sinon, neutre si indisponible
color_today: sensor.tempo_today # Bleu / Blanc / Rouge (ou Blue / White / Red)
color_tomorrow: sensor.tempo_tomorrow
Véhicule électrique : anneau de batterie, état de charge, autonomie et session.
- type: ev
title: Voiture
battery: sensor.ev_battery
range: sensor.ev_range
power: sensor.charger_power # W, kW ou MW (converti en W)
threshold: 50 # en charge au-dessus de cette puissance (W)
plugged: binary_sensor.ev_plugged # on / plugged / connected / true
session_kwh: sensor.charger_session
session_cost: sensor.charger_session_cost
État : « En charge · 2,28 kW », « Branchée », « Débranchée » ou « À l'arrêt ». L'anneau est vert pendant la charge, rouge
sous 20 %. power est comparé en watts : avec un capteur en kW, réglez threshold en conséquence (par exemple 0.05).
- {type: divider, title: Chauffage, spacing: 12} # titre de section facultatif ; espacement en px au-dessus et en dessousAjouter un widget propose 65 widgets prêts à l'emploi en 13 catégories, après les 10 types de base. Chacun est l'un des types ci-dessus avec des bornes et des couleurs raisonnables ; à l'insertion, ses champs d'entité sont remplis depuis votre Home Assistant (voir Pré-remplissage des entités). « dc » est la classe d'appareil ; les mots sont cherchés dans l'identifiant ou le nom de l'entité (en anglais ou en français).
Air et climat
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| CO₂ | gauge | 400–2000 ppm, vert / 800 jaune / 1200 rouge | sensor dc carbon_dioxide, ou ppm + « co2 » |
| COV | gauge | 0–1000, 300 / 500 | sensor dc volatile organic compounds, ou « voc » / « cov » |
| Particules PM2.5 | gauge | 0–100 µg/m³, 25 / 50 | sensor dc pm25 |
| Humidité | gauge | 0–100 %, jaune / 35 vert / 65 rouge | sensor dc humidity |
| Température | tile | °C, courbe 24 h, ligne humidité | sensor dc temperature |
| Qualité de l'air | tile | courbe 24 h | sensor dc aqi, ou « aqi », « iaq » |
| Radon | gauge | 0–400 Bq/m³, 100 / 300 | « radon » |
Lumière
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Luminosité | gauge | 0–1000 lx | sensor dc illuminance |
| Lumières | entities | jusqu'à 6 lumières | |
| Scènes | entities | jusqu'à 5 scènes |
Sécurité
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Serrure | lock | une serrure | |
| Alarme | tile | alarm_control_panel | |
| Détecteurs de fumée | entities | jusqu'à 6 binary_sensor dc smoke | |
| Monoxyde de carbone | entities | jusqu'à 4, dc carbon_monoxide | |
| Détecteurs de gaz | entities | jusqu'à 4 binary_sensor dc gas | |
| Mouvements | entities | jusqu'à 6 dc motion / occupancy / presence | |
| Caméras | entities | jusqu'à 4 caméras | |
| Sonnette | tile | event dc doorbell, ou « sonnette » / « doorbell » |
Eau
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Fuites d'eau | entities | jusqu'à 6 binary_sensor dc moisture | |
| Vanne d'arrêt | cover | confirmée | une vanne (valve) |
| Consommation d'eau | periods | m³, 2 décimales | sensor dc water (statistiques) |
| Pression d'eau | gauge | 0–6 bar, rouge / 1,5 vert / 4 jaune | sensor dc pressure en bar, ou « eau » |
| Adoucisseur | entities | « adoucisseur » / « softener » |
Énergie
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Production solaire | tile | W, courbe 24 h, ligne énergie | capteur de puissance nommé solaire / pv / onduleur / production |
| Batterie domestique | gauge | 0–100 %, rouge / 20 jaune / 50 vert, ligne puissance | capteur de batterie nommé batterie domestique / powerwall / stockage |
| Puissance instantanée | tile | W, courbe 24 h | capteur de puissance nommé maison / total / réseau / compteur, sinon n'importe lequel |
| Conso et coût | periods | kWh (1 décimale) et € (2 décimales) | capteur d'énergie (pas un journalier), capteur monétaire |
| Prix de l'électricité | tile | 4 décimales, courbe 24 h | €/kWh ou €/MWh, ou « prix » / « tarif » |
| Compteur gaz | periods | m³ | sensor dc gas |
Ouvertures
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Volet | cover | cover dc shutter / blind / shade / curtain / awning / window | |
| Portail | cover | confirmé pour dc gate | cover dc gate, ou « portail » |
| Porte de garage | cover | confirmée pour dc garage | cover dc garage, ou « garage » |
| Fenêtres et portes | entities | jusqu'à 8 binary_sensor dc window / door / opening / garage_door |
Chauffage et clim
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Pompe à chaleur / clim | thermostat | climate nommé pompe à chaleur / clim / split, sinon n'importe quel climate | |
| Chaudière | tile | °C, courbe 24 h | capteur de température nommé chaudière / départ |
| Chauffe-eau | tile | °C, courbe 24 h | water_heater, ou capteur de température nommé chauffe-eau / ballon |
| VMC / ventilation | entities | jusqu'à 3 fans, ou « vmc » / « ventilation » | |
| Purificateur d'air | entities | un fan purificateur et un capteur PM2.5 | |
| Déshumidificateur | entities | un humidifier et un capteur d'humidité |
Électroménager
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Lave-linge | entities | jusqu'à 3 nommées lave-linge / washer | |
| Sèche-linge | entities | jusqu'à 3 nommées sèche-linge / dryer | |
| Lave-vaisselle | entities | jusqu'à 3 nommées lave-vaisselle / dishwasher | |
| Aspirateur robot | tile | ligne batterie | un vacuum |
| Imprimante 3D | gauge | 0–100 % | progression de l'imprimante (OctoPrint, Bambu, Prusa…), temps restant, buse |
| Frigo et congélateur | entities | jusqu'à 3 capteurs de température nommés frigo / congélateur |
Multimédia
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Télévision | tile | media_player dc tv, ou « tv » | |
| Enceintes | entities | jusqu'à 4 media_player dc speaker (ou qui ne sont pas une TV) |
Extérieur et jardin
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Météo | tile | ligne température extérieure | une entité weather |
| Pluie | tile | courbe 24 h | sensor dc precipitation, ou mm + « pluie » |
| Vent | tile | courbe 24 h, ligne rafales | sensor dc wind_speed |
| Indice UV | gauge | 0–11, 3 / 6 | « uv » |
| Arrosage | entities | jusqu'à 4 switches ou vannes nommés arrosage / irrigation / jardin | |
| Humidité du sol | gauge | 0–100 %, rouge / 20 jaune / 35 vert | sensor dc moisture, ou % + « sol » / « plante » |
| Piscine | entities | pH, chlore / ORP, température de la piscine | |
| pH de la piscine | gauge | 6,8–8, jaune / 7,2 vert / 7,7 rouge | sensor dc ph, ou « ph » |
Réseau et serveur
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Débit internet | entities | descendant, montant (débit) et ping (ms) | |
| Processeur | gauge | 0–100 %, 70 / 90 | % nommé cpu / processeur |
| Mémoire | gauge | 0–100 %, 80 / 90 | % nommé mémoire / ram |
| Disque | gauge | 0–100 %, 80 / 90 | % nommé disque / stockage / volume |
| Onduleur | entities | jusqu'à 4 nommées onduleur / ups / nut |
Présence
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Personnes | entities | jusqu'à 6 personnes | |
| Téléphones | entities | jusqu'à 6 device_trackers | |
| Batteries des appareils | entities | jusqu'à 8 capteurs de batterie, les plus basses d'abord |
Véhicule
| Widget | Type | Réglages | Entités cherchées |
|---|---|---|---|
| Voiture électrique | ev | batterie nommée voiture / EV / noms de modèles, autonomie, puissance de la borne, capteur de branchement | |
| Borne de recharge | entities | jusqu'à 4 nommées borne / wallbox / evse |
- Ajouter un widget sous un panneau (ou dans une fiche, ou dans les panneaux d'une pièce) ouvre le dialogue des widgets : puces par catégorie, un champ de recherche (« co2 », « fuite », « serrure »… ; chaque mot doit correspondre, les noms d'abord), ← / → sur une tuile pour le panneau gauche ou droit.
- Créer un widget ouvre un atelier avec un aperçu en direct, et peut enregistrer le résultat dans Mes modèles avec des entités à choisir à chaque usage.
- Cliquez un widget pour le modifier ; glissez-le pour le réordonner ou le passer dans l'autre panneau.
