Komponentenreferenz
Gemeinsame Felder
Jedes Widget benötigt eine im Dashboard eindeutige id und einen type. Stateful Widgets verwenden entity oder entity_id. Gemeinsam verfügbar sind title, icon, theme/theme_override, condition/visibility/show_if, row, col, rowspan/row_span, colspan/col_span, cell_width/column_width, cell_height/row_height, cell_aspect_ratio, min_height, gap, margin.
Typen und Aliase
| Familie | Kanonische Typen und Aliase |
|---|---|
| Steuerung | button, switch, light, cover, fan, climate, thermostat, select, entity_select, textfield |
| Information | label, clock, datetime, calendar, history_graph, sensor_graph, graph, mini_graph_card, horizon_card, weather_chart |
| Medien | media_player, media, picture, image, camera, video, immich_slideshow, immich_clock |
| Layout | grid, blank, tabbed_card, auto_entities, flex_table |
| Sprache | assist_button, voice_assistant_button, push_to_talk |
Kebab- und Lovelace-Aliase wie custom:mini-graph-card, custom:horizon-card, custom:weather-chart-card, custom:auto-entities, custom:flex-table-card, custom:tabbed-card, photo_frame und photo_clock bleiben unterstützt.
Aktionen und Sicherheit
Ein Widget sendet keine beliebigen HA-Serviceaufrufe. Die Integration erlaubt nur typisierte Operationen für die konfigurierte Entity-Domain: button.press; light/switch Ein/Aus/Toggle; Coverposition; Fan-, Climate- und Select-Funktionen; Media-Steuerung. Unbekannte Typen bleiben im visuellen Editor erhalten, erscheinen in der App aber als Hinweis, bis ein nativer Renderer vorhanden ist.