Entity 카드


엔티티는 표준 인터페이스를 사용하는 사람들에게 가장 친숙한 가장 일반적인 유형의 카드입니다. 그룹(group)이 사용했던 방식과 매우 유사하게 항목을 그룹화합니다.

Configuration Variables

type

(string)(Required)

entities

entities

(list)(Required)

엔터티 ID 또는 entity 개체 목록은 아래를 참조

title

(string)(Optional)

카드 제목.

icon

(string)(Optional)

제목 왼쪽에 표시되는 아이콘

show_header_toggle

(boolean)(Optional)

모든 엔티티를 켜거나 끄는 버튼.

Default value:

true

theme

(string)(Optional)

themes.yaml에서 내 테마로 설정.

엔티티 옵션 (Options For Entities)

엔터티를 문자열 대신 개체로 정의(엔티티 ID 앞에 entity:를 추가)하면 사용자 지정 및 설정을 더 추가할 수 있습니다.

Configuration Variables

entity

(string)(Required)

홈어시스턴트 엔티티 ID.

type

(string)(Optional)

custom card 유형을 설정: custom:my-custom-card

name

(string)(Optional)

친숙한 이름을 덮어씁니다.

icon

(string)(Optional)

아이콘 또는 엔터티 picture를 덮어씁니다.

image

(string)(Optional)

엔터티 picture를 덮어씁니다.

secondary_info

(string)(Optional)

추가 정보를 표시. 값: entity-id, last-changed, last-triggered (자동화와 스크립트만 적용).

format

(string)(Optional)

상태의 형식을 지정하는 방법. 현재 타임 스탬프 센서에만 사용. 유효한 값: relative, total, date, time, datetime.

header

(map)(Optional)

렌더링할 머릿글 위젯. header documentation 참조.

footer

(map)(Optional)

렌더링할 바닥글 위젯. footer documentation 참조.

tap_action

(map)(Optional)

탭할 시 액션

action

(string)(Required)

액션 수행 (more-info, toggle, call-service, navigate, url, none)

Default value:

toggle

navigation_path

(string)(Optional)

actionnavigate로 정의된 경우 탐색할 경로 (예: /lovelace/0/)

Default value:

none

url_path

(string)(Optional)

actionurl로 정의된 경우 (예: https://www.home-assistant.io)

Default value:

none

service

(string)(Optional)

actioncall-service 로 정의된 경우 호출할 서비스 (예 :media_player.media_play_pause)

Default value:

none

service_data

(string)(Optional)

actioncall-service 로 정의된 경우 포함할 서비스 데이터 (예: entity_id: media_player.bedroom)

Default value:

none

hold_action

(map)(Optional)

길게 눌렀을 때의 액션

action

(string)(Required)

액션 수행 (more-info, toggle, call-service, navigate, url, none)

Default value:

more-info

navigation_path

(string)(Optional)

actionnavigate로 정의된 경우 탐색할 경로 (예: /lovelace/0/)

Default value:

none

url_path

(string)(Optional)

actionurl 로 정의된 경우 (예: https://www.home-assistant.io)

Default value:

none

service

(string)(Optional)

actioncall-service로 정의된 경우 호출할 서비스 (예: media_player.media_play_pause)

Default value:

none

service_data

(string)(Optional)

actioncall-service로 정의된 경우 포함할 서비스 데이터 (예: entity_id: media_player.bedroom)

Default value:

none

double_tap_action

(map)(Optional)

더블탭을 눌렀을때의 액션

action

(string)(Required)

액션 수행 (more-info, toggle, call-service, navigate, url, none)

Default value:

more-info

navigation_path

(string)(Optional)

actionnavigate로 정의된 경우 탐색할 경로 (예: /lovelace/0/)

Default value:

none

url_path

(string)(Optional)

actionurl로 정의된 경우 (예: https://www.home-assistant.io)

Default value:

none

service

(string)(Optional)

actioncall-service로 정의된 경우 호출할 서비스 (예: media_player.media_play_pause

Default value:

none

service_data

(string)(Optional)

actioncall-service로 정의된 경우 포함할 서비스 데이터 (예: entity_id: media_player.bedroom

Default value:

none

특수 행 요소 (Special Row Elements)

Call Service

Configuration Variables

type

(string)(Required)

call-service

name

(string)(Required)

메인 라벨.

service

(string)(Required)

media_player.media_play_pause같은 서비스

icon

(string)(Optional)

보여줄 아이콘 (예: mdi:home)

Default value:

mdi:remote

action_name

(string)(Optional)

버튼 라벨.

Default value:

Run

service_data

(map)(Optional)

사용할 서비스 데이터.

Cast

홈어시스턴트 캐스트를 시작하기위한 특별한 행(row).

Configuration Variables

type

(string)(Required)

cast

view

(string)(Required)

표시해야하는 View의 경로.

name

(string)(Optional)

행에 표시할 이름

Default value:

Home Assistant Cast

icon

(string)(Optional)

사용할 아이콘

Default value:

hass:television

hide_if_unavailable

(boolean)(Optional)

브라우저에서 전송을 사용할 수 없는 경우이 행을 숨김.

Default value:

false

구분선 (Divider)

Configuration Variables

type

(string)(Required)

divider

style

(string)(Optional)

CSS를 사용하여 요소(elements)의 스타일을 지정.

Default value:

height: 1px, background-color: var(–secondary-text-color)

섹션 (Section)

Configuration Variables

type

(string)(Required)

section

label

(string)(Optional)

섹션 라벨

웹링크 (Weblink)

Configuration Variables

type

(string)(Required)

weblink

url

(string)(Required)

웹사이트 URL (또는 내부 URL 예: /hassio/dashboard 혹은 /panel_custom_name)

name

(string)(Optional)

링크 라벨

Default value:

url path

icon

(string)(Optional)

보여줄 아이콘 (예: mdi:home)

Default value:

mdi:link

사례

엔티티 행 :

type: entities
title: Entities card sample
show_header_toggle: true
header:
  image: 'https://www.home-assistant.io/images/lovelace/header-footer/balloons-header.png'
  type: picture
entities:
  - entity: alarm_control_panel.alarm
    name: Alarm Panel
  - device_tracker.demo_paulus
  - switch.decorative_lights
  - group.all_lights
  - group.all_locks

특별한 행 :

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
엔티티 유형 구분선(divider)과 웹링크(Weblink)는 아직 구성 코드 편집기에서 지원되지 않으며 `Expected a value of type...` 에 대한 경고가 표시됩니다. 경고를 무시하고 편집 내용을 저장하여 확인할 수 있습니다.