home-assistant.io/source/_lovelace/picture-entity.markdown
2019-02-14 13:09:06 +01:00

3.5 KiB

layout, title, sidebar_label, description, date, sidebar, comments, sharing, footer
layout title sidebar_label description date sidebar comments sharing footer
page Picture Entity Card Picture Entity Displays the entity in form of an image. Instead of images from URL it can also show the picture of `camera` entities. 2018-07-01 10:28 +00:00 true false true true

Displays the entity in form of an image. Instead of images from URL it can also show the picture of camera entities.

Picture entity card Background changes according to the entity state.

{% configuration %} type: required: true description: picture-entity type: string entity: required: true description: "An entity_id used for the picture." type: string camera_image: required: false description: "Camera entity_id to use. (not required if entity is already a camera-entity)." type: string image: required: false description: URL of an image. type: string state_image: required: false description: "Map entity states to images (state: image URL, check the example below)." type: object aspect_ratio: required: false description: "Forces the height of the image to be a ratio of the width. You may enter a value such as: 16x9, 16:9, 1.78." type: string name: required: false description: Overwrite entity name. type: string show_name: required: false description: Shows name in footer. type: boolean default: true show_state: required: false description: Shows state in footer. type: boolean default: true tap_action: required: false description: Action to take on tap type: object keys: action: required: true description: "Action to perform (more-info, toggle, call-service, navigate, none)" type: string default: "more-info" navigation_path: required: false description: "Path to navigate to (e.g. /lovelace/0/) when action defined as navigate" type: string default: none service: required: false description: "Service to call (e.g. media_player.media_play_pause) when action defined as call-service" type: string default: none service_data: required: false description: "Service data to include (e.g. entity_id: media_player.bedroom) when action defined as call-service" type: string default: none hold_action: required: false description: Action to take on tap-and-hold type: object keys: action: required: true description: "Action to perform (more-info, toggle, call-service, navigate, none)" type: string default: "more-info" navigation_path: required: false description: "Path to navigate to (e.g. /lovelace/0/) when action defined as navigate" type: string default: none service: required: false description: "Service to call (e.g. media_player.media_play_pause) when action defined as call-service" type: string default: none service_data: required: false description: "Service data to include (e.g. entity_id: media_player.bedroom) when action defined as call-service" type: string default: none {% endconfiguration %}

{% linkable_title Examples %}

Basic example:

type: picture-entity
entity: light.bed_light
image: /local/bed_light.png

Different images for each state:

type: picture-entity
entity: light.bed_light
state_image:
  "on": /local/bed_light_on.png
  "off": /local/bed_light_off.png