3.4 KiB
type, title, sidebar_label, description, related
| type | title | sidebar_label | description | related | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| card | Heading card | Heading | The Heading card structures your dashboard by providing title, icon, navigation and badges. |
|
The Heading card structures your dashboard by providing title, icon and navigation. This card supports actions.
Screenshot of a heading card with a title, badges, and a subtitle.
type: heading
heading: Living room
icon: mdi:sofa
badges:
- type: entity
entity: sensor.living_room_sensor_temperature
color: red
- type: entity
entity: sensor.living_room_sensor_humidity
color: deep-purple
{% configuration entity %}
type:
required: true
description: "heading"
type: string
heading:
required: false
description: Heading text
type: string
heading_style:
required: false
description: Style of the heading. Can be either title or subtitle.
type: string
default: title
icon:
required: false
description: Icon displayed before the heading text.
type: string
tap_action:
required: false
description: Action taken on card tap. See action documentation. By default, it will do nothing. If an action is configured, a chevron will appear next to the heading text.
type: map
badges:
required: false
description: Additional small badges to display entity information. See heading badges.
type: list
{% endconfiguration %}
Heading badges
In addition to the heading text, each heading card can show small badges. They are smaller than regular badges and don't have a background. The heading badges can display sensor information in a compact and minimal style.
type: entity
entity: light.living_room
{% configuration entity %}
type:
required: true
description: "entity"
type: string
entity:
required: true
description: Entity ID.
type: string
name:
required: false
description: Overwrites the entity name. The name will be only displayed if state_content includes name token.
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, it will not be colored. It can be set to the state special token to dynamically color the icon based on state, domain, and device_class of your entity. It also accepts color token or hex color code.
type: string
default: none
show_icon:
required: false
description: Show the icon
type: boolean
default: "true"
show_state:
required: false
description: Show the state.
type: boolean
default: "false"
state_content:
required: false
description: >
Content to display for the state. Can be state, name, 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 do nothing.
type: map
{% endconfiguration %}