标题卡片
标题卡片通过提供标题、图标和导航来组织您的仪表盘。此卡片支持动作。
带有实体徽章和按钮徽章的标题卡片截图。
type:
required: true
description: "heading"
type: string
heading:
required: false
description: 标题文字。
type: string
heading_style:
required: false
description: 标题样式。可选值为 title 或 subtitle。
type: string
default: title
icon:
required: false
description: 显示在标题文字前的图标。
type: string
tap_action:
required: false
description: 点击卡片时执行的动作。请参阅动作文档。默认不执行任何操作。如果配置了动作,标题文字旁会显示一个箭头。
type: map
badges:
required: false
description: 用于显示实体信息的额外小徽章。请参阅标题徽章。
type: list
标题徽章
除了标题文字外,每张标题卡片还可以显示小徽章。它们比普通徽章更小,且没有背景。标题徽章可以用紧凑、简洁的方式显示传感器信息或动作按钮。标题徽章也支持动作。
标题卡片可使用以下徽章类型:
实体徽章
实体徽章可让您在标题卡片中显示实体的状态。
type:
required: true
description: "entity"
type: string
entity:
required: true
description: 实体 ID。
type: string
name:
required: false
description: 覆盖实体名称。仅当 state_content 包含 name 标记时才会显示名称。
type: string
icon:
required: false
description: 覆盖实体图标。
type: string
color:
required: false
description: 当实体处于活动状态时设置颜色。默认不着色。也可以设置为特殊标记 state,根据实体的 state、domain 和 device_class 动态为图标着色。还支持颜色令牌或十六进制颜色代码。
type: string
default: none
show_icon:
required: false
description: 显示图标。
type: boolean
default: "true"
show_state:
required: false
description: 显示状态。
type: boolean
default: "false"
state_content:
required: false
description: >
要显示的状态内容。可以是 state、name、last_changed、last_updated,或实体的任意属性。可以是单个字符串,也可以是字符串列表。默认值取决于实体域。
type: [string, list]
tap_action:
required: false
description: 点击卡片时执行的动作。请参阅动作文档。默认不执行任何操作。
type: map
hold_action:
required: false
description: 长按卡片时执行的动作。请参阅动作文档。默认不执行任何操作。
type: map
double_tap_action:
required: false
description: 双击卡片时执行的动作。请参阅动作文档。默认不执行任何操作。
type: map
按钮徽章
按钮徽章可让您显示一个可自定义的按钮,支持图标和文字,或仅显示其中之一。这适合执行快速操作,比如关闭灯光、触发自动化,或打开仪表盘。
您也可以创建仅图标按钮或仅文字按钮:
type:
required: true
description: "button"
type: string
icon:
required: false
description: 要显示的图标。
type: string
text:
required: false
description: 要显示在按钮上的文字标签。
type: string
color:
required: false
description: 徽章颜色。支持颜色令牌或十六进制颜色代码。
type: string
tap_action:
required: false
description: 点击卡片时执行的动作。请参阅动作文档。默认不执行任何操作。
type: map
hold_action:
required: false
description: 长按卡片时执行的动作。请参阅动作文档。默认不执行任何操作。
type: map
double_tap_action:
required: false
description: 双击卡片时执行的动作。请参阅动作文档。默认不执行任何操作。
type: map

