徽章

徽章是位于面板顶部、所有卡片上方的小部件。

徽章 位于面板顶部的徽章。

向仪表板添加徽章

  1. 转到 设置 > 仪表板

  2. 如果您有多个视图,打开您想要添加徽章的视图。

  3. 在屏幕右上角,选择编辑 按钮。

  4. 要添加徽章,选择加号 按钮。

    显示如何添加徽章的截图

  5. 选择您想要显示徽章的实体。

  6. 配置您的徽章。

    • 可用选项取决于实体。
    • 添加您想要查看的状态。
    • 如果需要,可以添加名称

    显示如何配置徽章的截图

  7. 交互下,您可以定义点击行为。

  8. 如果您希望此徽章仅对特定用户或在某些条件下可见,请打开可见性标签页以定义这些条件

  9. 选择保存

显示如何向仪表板添加徽章的屏幕录像 向仪表板添加徽章。

实体徽章

实体徽章允许您在徽章上显示实体的状态。此徽章支持动作

type: entity
entity: light.living_room

Configuration Variables

type string Required

entity

entity string Required

实体ID。

name string (Optional)

覆盖实体名称。

icon string (Optional)

覆盖实体图标。

color string (Optional, default: state)

设置实体激活时的颜色。默认情况下,颜色基于实体的statedomaindevice_class。接受颜色标记或十六进制颜色代码。

show_entity_picture boolean (Optional, default: false)

如果您的实体有图片,它将替代图标。

show_name boolean (Optional, default: false)

显示名称。

show_icon boolean (Optional, default: true)

显示图标。

show_state boolean (Optional, default: true)

显示状态。

state_content string | list (Optional)

显示状态的内容。可以是statelast_changedlast_updated或实体的任何属性。可以是包含单个项目的字符串,也可以是字符串项目的列表。默认值取决于实体域。

tap_action map (Optional)

点击卡片时执行的动作。请参阅动作文档。默认情况下,它将显示“更多信息”对话框。

hold_action map (Optional)

点击并按住时执行的动作。请参阅动作文档

double_tap_action map (Optional)

双击时执行的动作。请参阅动作文档

实体过滤徽章

此徽章允许您定义一个实体列表,仅在某种状态下进行跟踪。非常适合显示您忘记关闭的灯光或仅在家时显示人员列表。

Configuration Variables

type string Required

entity-filter

entities list Required

实体ID或entity对象的列表,请参阅下文。

conditions list (Optional)

要检查的条件列表。请参阅可用条件。*

state_filter list (Optional)

(遗留)表示状态或过滤器的字符串列表以进行检查。请参阅可用遗留过滤器。*

*需要一个(conditionsstate_filter

实体选项

如果您将实体定义为对象而不是字符串(通过在实体ID之前添加entity:),则可以添加更多自定义和配置:

Configuration Variables

type string (Optional)

设置自定义徽章类型:custom:my-custom-badge

entity string Required

实体ID。

name string (Optional)

覆盖友好名称。

icon string (Optional)

覆盖图标或实体图片。您可以使用Material Design Icons中的任何图标。图标名称前缀为mdi:,例如mdi:home

conditions list (Optional)

要检查的条件列表。请参阅可用条件。*

state_filter list (Optional)

(遗留)表示状态或过滤器的字符串列表以进行检查。请参阅可用遗留过滤器。*

*仅应用一个过滤器:如果不存在conditions,则应用state_filter

您还可以向实体添加任何其他配置选项,这些选项由所选徽章类型(如果未选择类型,则为“实体”徽章类型)支持。

条件选项

您可以指定多个conditions,在这种情况下,如果实体符合所有条件,则会显示该实体。

状态

测试实体是否具有指定状态。

type: entity-filter
entities:
  - climate.thermostat_living_room
  - climate.thermostat_bed_room
conditions:
  - condition: state
    state: heat
type: entity-filter
entities:
  - climate.thermostat_living_room
  - climate.thermostat_bed_room
conditions:
  - condition: state
    state_not: "off"
type: entity-filter
entities:
  - sensor.gas_station_1
  - sensor.gas_station_2
  - sensor.gas_station_3
conditions:
  - condition: state
    state: sensor.gas_station_lowest_price

Configuration Variables

condition string Required

state

state list | string (Optional)

实体状态或ID等于此值。可以包含状态数组。*

state_not list | string (Optional)

实体状态或ID不等于此值。可以包含状态数组。*

*需要一个(statestate_not

数值状态

测试实体状态是否符合阈值。

type: entity-filter
entities:
  - sensor.outside_temperature
  - sensor.living_room_temperature
  - sensor.bed_room_temperature
conditions:
  - condition: numeric_state
    above: 10
    below: 20

Configuration Variables

condition string Required

numeric_state

above string (Optional)

实体状态或ID高于此值。*

below string (Optional)

实体状态或ID低于此值。*

*至少需要一个(abovebelow),也可以同时使用以表示介于两者之间的值。

屏幕

根据屏幕大小指定实体的可见性。UI中提供了一些屏幕大小预设,但您可以在YAML中使用任何CSS媒体查询。

type: entity-filter
entities:
  - sensor.outside_temperature
  - sensor.living_room_temperature
  - sensor.bed_room_temperature
conditions:
  - condition: screen
    media_query: "(min-width: 1280px)"

Configuration Variables

condition string Required

screen

media_query string Required

要检查的媒体查询,以确定允许显示实体的屏幕大小。

用户

根据用户指定实体的可见性。

type: entity-filter
entities:
  - sensor.outside_temperature
  - sensor.living_room_temperature
  - sensor.bed_room_temperature
conditions:
  - condition: user
    users:
      - 581fca7fdc014b8b894519cc531f9a04

Configuration Variables

condition string Required

user

users list Required

可以看到实体的用户ID(在用户配置页面上找到的唯一十六进制值)。

指定必须满足两个条件。

type: entity-filter
entities:
  - sensor.outside_temperature
  - sensor.living_room_temperature
  - sensor.bed_room_temperature
conditions:
  - condition: and
    conditions:
      - condition: numeric_state
        above: 0
      - condition: user
        users:
          - 581fca7fdc014b8b894519cc531f9a04

Configuration Variables

condition string Required

and

conditions list (Optional)

要检查的条件列表。请参阅可用条件

指定必须满足至少一个条件。

type: entity-filter
entities:
  - sensor.outside_temperature
  - sensor.living_room_temperature
  - sensor.bed_room_temperature
conditions:
  - condition: or
    conditions:
      - condition: numeric_state
        above: 0
      - condition: user
        users:
          - 581fca7fdc014b8b894519cc531f9a04

Configuration Variables

condition string Required

or

conditions list (Optional)

要检查的条件列表。请参阅可用条件

遗留状态过滤器

字符串过滤器

仅显示房屋中处于活动状态的开关或灯光。

type: entity-filter
entities:
  - entity: light.bed_light
    name: Bed
  - light.kitchen_lights
  - light.ceiling_lights
state_filter:
  - "on"

您还可以指定多个state_filter条件,在这种情况下,如果实体符合任何条件,则会显示该实体。

如果您将state_filter定义为对象而不是字符串,则可以为过滤器添加更多自定义内容,如下所述。

操作符过滤器

测试实体状态是否符合应用的operator

Configuration Variables

value string Required

表示状态的字符串。

operator string Required

用于比较的操作符。可以是==<=<>=>!=innot inregex

attribute string (Optional)

用于替代状态的实体属性。

示例

显示在家或在工作中的所有人。

type: entity-filter
entities:
  - device_tracker.demo_paulus
  - device_tracker.demo_anne_therese
  - device_tracker.demo_home_boy
state_filter:
  - operator: "=="
    value: home
  - operator: "=="
    value: work

为单个实体指定过滤器。

type: entity-filter
state_filter:
  - "on"
  - operator: ">"
    value: 90
entities:
  - sensor.water_leak
  - sensor.outside_temp
  - entity: sensor.humidity_and_temp
    state_filter:
      - operator: ">"
        value: 50
        attribute: humidity

对实体属性使用正则表达式过滤器。下面的正则表达式过滤器查找长度为1位且数字在0到7之间的表达式(因此显示今天或未来7天的假期),并将这些假期显示为实体过滤徽章中的实体。

type: entity-filter
state_filter:
  - operator: regex
    value: "^([0-7]{1})$"
    attribute: eta
entities:
  - entity: sensor.upcoming_ical_holidays_0
  - entity: sensor.upcoming_ical_holidays_1
  - entity: sensor.upcoming_ical_holidays_2
  - entity: sensor.upcoming_ical_holidays_3
  - entity: sensor.upcoming_ical_holidays_4
show_empty: false