4.7 KiB
type, title, sidebar_label, description, related
| type | title | sidebar_label | description | related | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| card | Tile card | Tile | The tile card gives you a quick overview of your entity. The card allows you to toggle the entity, show the more-info dialog, or custom actions. |
|
The tile card gives you a quick overview of your {% term entity %}. The card allows you to add tap actions, and features to control the entity. You can also select the {% term entity %} to open the more info dialog. A badge is shown for some {% term entities %} like the climate or person {% term entities %}.
The circular background behind an icon indicates that there is a tap action.
The "Downstairs" and "Upstairs" climate entities have a badge and a feature that is bottom-aligned.
{% include dashboard/edit_dashboard.md %}
{% configuration %}
type:
required: true
description: "tile"
type: string
entity:
required: true
description: Entity ID.
type: string
name:
required: false
description: Overwrites the entity name.
type: string
icon:
required: false
description: Overwrites the entity icon.
type: string
color:
required: false
description: Set the color when the entity is active. By default, the color is based on state, domain, and device_class of your entity. It accepts color token or hex color code.
type: string
default: state
show_entity_picture:
required: false
description: If your entity has a picture, it will replace the icon.
type: boolean
default: false
vertical:
required: false
description: Displays the icon above the name and state.
type: boolean
default: false
hide_state:
required: false
description: Hide the entity state.
type: boolean
default: false
state_content:
required: false
description: >
Content to display for the state. Can be state, last_changed, last_updated, or any attribute of the entity. Can be either a string with a single item, or a list of string items. Default depends on the entity domain.
type: [string, list]
tap_action:
required: false
description: Action taken on card tap. See action documentation. By default, it will show the "more-info" dialog.
type: map
hold_action:
required: false
description: Action taken on tap-and-hold. See action documentation.
type: map
double_tap_action:
required: false
description: Action taken on double tap. See action documentation.
type: map
icon_tap_action:
required: false
description: Action taken on icon card tap. See action documentation. By default, it will toggle the entity (if possible), otherwise, show the "more-info" dialog.
type: map
icon_hold_action:
required: false
description: Action taken on icon tap-and-hold. See action documentation.
type: map
icon_double_tap_action:
required: false
description: Action taken on icon double tap. See action documentation.
type: map
features:
required: false
description: Additional widgets to control your entity. See available features.
type: list
features_position:
required: false
description: Position of the features on the tile card. Can be bottom or inline. Only the first feature will be displayed when the option is set to inline. inline is not compatible with the vertical option.
type: string
default: bottom
{% endconfiguration %}
Examples
Alternatively, the card can be configured using 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: person.anne_therese
vertical: true
hide_state: true
type: tile
entity: light.living_room
state_content:
- state
- brightness
- last-changed
type: tile
entity: vacuum.ground_floor
features:
- type: vacuum-commands
commands:
- start_pause
- return_home
Available colors
You want to colorize the tile card? Choose one of the following colors: 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.