diff --git a/source/_dashboards/tile.markdown b/source/_dashboards/tile.markdown index 16aa7a632b9..06fd1756391 100644 --- a/source/_dashboards/tile.markdown +++ b/source/_dashboards/tile.markdown @@ -49,25 +49,142 @@ icon_tap_action: required: false description: Action taken on icon card tap. See [action documentation](/dashboards/actions/#tap-action). By default, it will `toggle` the entity (if possible), otherwise, show the "more-info" dialog. type: map +features: + required: false + description: Additional widgets to control your entity. See [available features](/dashboards/tile/#tile-features). + type: list {% endconfiguration %} - -## Example +## Examples Alternatively, the card can be configured using YAML: ```yaml -- type: tile - entity: cover.kitchen_window -- type: tile - entity: light.bedroom - icon: mdi:lamp - color: yellow -- type: tile - entity: person.anne_therese - show_entity_picture: true +type: tile +entity: cover.kitchen_window +``` + +```yaml +type: tile +entity: light.bedroom +icon: mdi:lamp +color: yellow +``` + +```yaml +type: tile +entity: person.anne_therese +show_entity_picture: true +``` + +```yaml +type: tile +entity: vacuum.ground_floor +features: + - type: vacuum-commands + commands: + - start_pause + - return_home ``` ## Available color tokens Some color tokens are available to colorize the tile card : `primary`, `accent`, `disabled`, `red`, `pink`, `purple`, `deep-purple`, `indigo`, `blue`, `light-blue`, `cyan`, `teal`, `green`, `light-green`, `lime`, `yellow`, `amber`, `orange`, `deep-orange`, `brown`, `grey`, `blue-grey`, `black` and `white`. + +## Tile features + +Some entities have support for "features". These widgets add quick controls to the tile card. + +### Cover open/close + +Widget that display buttons to open, close or stop a [cover](/integrations/cover). + +

+ Screenshot of the tile card with open/close feature + Screenshot of the tile card with cover open/close feature +

+ +```yaml +features: + - type: "cover-open-close" +``` + +{% configuration %} +type: + required: true + description: "`cover-open-close`" + type: string +{% endconfiguration %} + +### Cover tilt + +Widget that display buttons to open, close or stop a [cover](/integrations/cover). + +

+ Screenshot of the tile card with tilt feature + Screenshot of the tile card with cover tilt feature +

+ +```yaml +features: + - type: "cover-tilt" +``` + +{% configuration %} +type: + required: true + description: "`cover-tilt`" + type: string +{% endconfiguration %} + +### Light brightness + +Widget that display a slider to select the brightness for a [light](/integrations/light). + +

+ Screenshot of the tile card with light brightness feature + Screenshot of the tile card with light brightness feature +

+ +```yaml +features: + - type: "light-brightness" +``` + +{% configuration %} +type: + required: true + description: "`light-brightness`" + type: string +{% endconfiguration %} + +### Vacuum commands + +Widget that display buttons to control a [vacuum](/integrations/vacuum). + +

+ Screenshot of the tile card with vacuum commands feature + Screenshot of the tile card with vacuum commands feature +

+ +```yaml +features: + - type: "vacuum-commands" + commands: + - start_pause + - stop + - clean_spot + - locate + - return_home +``` + +{% configuration %} +type: + required: true + description: "`vacuum-commands`" + type: string +commands: + required: true + description: List of commands to show on the card. The list can contain `start_pause`, `stop`, `clean_spot`, `locate` and `return_home`. + type: list +{% endconfiguration %} \ No newline at end of file diff --git a/source/images/dashboards/tile-features/cover_open_close.png b/source/images/dashboards/tile-features/cover_open_close.png new file mode 100644 index 00000000000..16324037376 Binary files /dev/null and b/source/images/dashboards/tile-features/cover_open_close.png differ diff --git a/source/images/dashboards/tile-features/cover_tilt.png b/source/images/dashboards/tile-features/cover_tilt.png new file mode 100644 index 00000000000..29284fb8a96 Binary files /dev/null and b/source/images/dashboards/tile-features/cover_tilt.png differ diff --git a/source/images/dashboards/tile-features/light_brightness.png b/source/images/dashboards/tile-features/light_brightness.png new file mode 100644 index 00000000000..a048dd952b9 Binary files /dev/null and b/source/images/dashboards/tile-features/light_brightness.png differ diff --git a/source/images/dashboards/tile-features/vacuum_commands.png b/source/images/dashboards/tile-features/vacuum_commands.png new file mode 100644 index 00000000000..551b0cc9bba Binary files /dev/null and b/source/images/dashboards/tile-features/vacuum_commands.png differ