磁贴卡片
磁贴卡片让你可以快速查看实体概览。该卡片允许你添加点击操作和控制实体的功能。你还可以选择实体以打开更多信息对话框。对于某些实体,如气候或人员实体,会显示一个徽章。
图标后面的圆形背景表示有点击操作。"楼下"和"楼上"气候实体有一个徽章和一个底部对齐的功能。
要将磁贴卡片添加到你的用户界面:
-
在屏幕右上角,选择编辑按钮。
- 如果这是你首次编辑仪表板,会出现编辑仪表板对话框。
- 通过编辑仪表板,你将接管这个仪表板的控制权。
- 这意味着当新的仪表板元素可用时,它将不再自动更新。
- 一旦你接管控制权,你将无法让这个特定的仪表板恢复自动更新。不过,你可以创建一个新的默认仪表板。
- 要继续,在对话框中,选择三点菜单,然后选择接管控制。
- 如果这是你首次编辑仪表板,会出现编辑仪表板对话框。
-
添加卡片并自定义操作和功能到你的仪表板。
配置变量
type 字符串 必填
title
entity 字符串 必填
实体ID。
name 字符串 (可选,默认:实体名称)
覆盖实体名称。
icon 字符串 (可选)
覆盖实体图标。
color 字符串 (可选,默认:state)
设置实体激活时的颜色。默认情况下,颜色基于实体的state
、domain
和device_class
。它接受颜色令牌或十六进制颜色代码。
show_entity_picture 布尔值 (可选,默认:false)
如果你的实体有图片,它将替换图标。
vertical boolean (可选,默认:false)
在名称和状态上方显示图标。
hide_state boolean (可选,默认:false)
隐藏实体状态。
state_content string | list (可选)
要显示的状态内容。可以是state
、last_changed
、last_updated
或实体的任何属性。可以是包含单个项目的字符串,也可以是字符串项目列表。默认值取决于实体域。
tap_action map (可选)
点击卡片时执行的操作。参见操作文档。默认情况下,它将显示"更多信息"对话框。
hold_action map (可选)
点击并按住时执行的操作。参见操作文档。
double_tap_action map (可选)
双击时执行的操作。参见操作文档。
icon_hold_action map (可选)
点击并按住图标时执行的操作。参见操作文档。
icon_hold_action map (可选)
点击并按住图标时执行的操作。参见操作文档。
icon_double_tap_action map (可选)
双击图标时执行的操作。参见操作文档。
features list (可选)
控制实体的附加小部件。参见可用功能。仅支持气候相关功能。
features_position string (可选,默认:bottom)
磁贴卡片上功能的位置。可以是bottom
(底部)或inline
(内联)。当选项设置为inline
时,只会显示第一个功能。inline
与vertical
选项不兼容。
示例
或者,可以使用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
可用颜色
想要给磁贴卡片上色?选择以下颜色之一: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
(黑色)和white
(白色)。