home-assistant.io/source/_lovelace/entities.markdown
akasma74 265ce9a8a4 Update entities.markdown (#8834)
clarify difference between entity and entity object
2019-03-06 08:56:19 +05:30

4.2 KiB

layout, title, sidebar_label, description, date, sidebar, comments, sharing, footer
layout title sidebar_label description date sidebar comments sharing footer
page Entities Card Entities Entities will be the most common type of card that will also be the most familiar to people using the standard interface. It groups items together very close to how groups used to do. 2018-07-01 10:28 +00:00 true false true true

Entities will be the most common type of card that will also be the most familiar to people using the standard interface. It groups items together very close to how groups used to do.

{% configuration %} type: required: true description: entities type: string entities: required: true description: "A list of entity IDs or entity objects, see below." type: list title: required: false description: The card title. type: string show_header_toggle: required: false description: Button to turn on/off all entities. type: boolean default: true theme: required: false description: Set to any theme within themes.yaml. type: string {% endconfiguration %}

{% linkable_title Options For Entities %}

If you define entities as objects instead of strings (by adding entity: before entity ID), you can add more customization and configuration:

{% configuration %} entity: required: true description: Home Assistant entity ID. type: string type: required: false description: "Sets a custom card type: custom:my-custom-card" type: string name: required: false description: Overwrites friendly name. type: string icon: required: false description: Overwrites icon or entity picture. type: string secondary_info: required: false description: "Show additional info. Values: entity-id, last-changed." type: string format: required: false description: "How the state should be formatted. Currently only used for timestamp sensors. Valid values are: relative, total, date, time and datetime." type: string {% endconfiguration %}

{% linkable_title Special Row Elements %}

{% linkable_title Call Service %}

{% configuration %} type: required: true description: call-service type: string name: required: true description: Main Label. type: string service: required: true description: "Service like media_player.media_play_pause" type: string icon: required: false description: "Icon to display (e.g., mdi:home)" type: string default: "mdi:remote" action_name: required: false description: Button label. type: string default: "Run" service_data: required: false description: The service data to use. type: object {% endconfiguration %}

{% linkable_title Divider %}

{% configuration %} type: required: true description: divider type: string style: required: false description: Style the element using CSS. type: object default: "height: 1px, background-color: var(--secondary-text-color)" {% endconfiguration %}

{% linkable_title Section %}

{% configuration %} type: required: true description: section type: string label: required: false description: Section label type: string {% endconfiguration %}

{% configuration %} type: required: true description: weblink type: string url: required: true description: "Website URL (or internal URL e.g. /hassio/dashboard or /panel_custom_name)" type: string name: required: false description: Link label type: string default: url path icon: required: false description: "Icon to display (e.g., mdi:home)" type: string default: "mdi:link" {% endconfiguration %}

{% linkable_title Example %}

Entity rows:

type: entities
title: Entities card sample
show_header_toggle: true
entities:
  - entity: alarm_control_panel.alarm
    name: Alarm Panel
  - device_tracker.demo_paulus
  - switch.decorative_lights
  - group.all_lights
  - group.all_locks

Special rows:

type: entities
title: Entities card sample
show_header_toggle: true
entities:
  - type: call-service
    icon: mdi:power
    name: Bed light
    action_name: Toggle light
    service: light.toggle
    service_data:
      entity_id: light.bed_light
  - type: divider
  - type: weblink
    name: Home Assistant
    url: https://www.home-assistant.io/
    icon: mdi:home-assistant