Lovelace-Mushroom卡片自定义secondary_info功能解析

概述

Lovelace-Mushroom项目中的卡片组件提供了丰富的自定义功能，其中secondary_info字段的灵活配置是用户高度关注的功能点。本文将深入探讨如何利用mushroom-template-card实现高度自定义的secondary_info显示效果。

核心功能需求

在实际智能家居场景中，用户经常需要在一个卡片上展示关联实体的多种状态信息。例如：

• 显示开关状态的同时展示定时器剩余时间
• 展示设备当前功率消耗
• 组合多个传感器的数据在一个卡片中显示

这些需求超出了基础mushroom-entity-card的能力范围，而mushroom-template-card则提供了完美的解决方案。

技术实现方案

mushroom-template-card通过支持Jinja2模板语法，允许用户在secondary_info字段中实现复杂的逻辑判断和数据组合。以下是几种典型应用场景的实现方法：

定时器状态显示

secondary: >-
  {% if states('number.boiler_timer_2') | int(0) > 0 %}
  {{timedelta(seconds=states('number.boiler_timer_2')|int) |
  regex_replace(':[0-9]{1,2}$','')}} para desligar
  {%- elif states('script.boiler_automatico_v2_script') == 'on' %} 
  Auto até 
  {{ states('input_datetime.boiler_desligar_as') |as_timestamp
  |timestamp_custom('%H:%M',True)}}
  {%- endif -%}

多状态条件显示

secondary: >-
  {{-states('sensor.sensor_temperatura_xiaomi_62_temperature')|float(0)}}ºC
  {%- if states('script.ar_quente_augusto_script') == 'on' %} 
  Desligar as 
  {{
  states('input_datetime.ar_augusto_automacao_quente_desligar_as')|as_timestamp
  |timestamp_custom('%H:%M',True) }}
  {%- endif -%}

动态图标与颜色

mushroom-template-card不仅支持secondary_info的自定义，还可以实现图标和颜色的动态变化：

icon_color: |-
  {% if states('climate.ar_condicionado_augusto') == 'heat' %} 
  red
  {% elif states('climate.ar_condicionado_augusto') == 'cool' %} 
  blue
  {% elif states('climate.ar_condicionado_augusto') == 'fan_only' %} 
  green
  {% elif states('climate.ar_condicionado_augusto') != 'off' %} 
  purple
  {% endif %} 

最佳实践建议

1. 多行显示：启用multiline_secondary: true可以让长文本更美观
2. 条件格式化：利用Jinja2的if-else语句实现不同状态下的不同显示
3. 时间格式化：使用timestamp_custom过滤器优化时间显示格式
4. 正则处理：regex_replace可以简化复杂字符串的显示
5. 类型转换：使用|int、|float确保数值比较的准确性

总结

mushroom-template-card通过强大的模板功能，完美解决了实体卡片信息展示的定制化需求。相比基础的mushroom-entity-card，它提供了更灵活的数据组合方式和更丰富的视觉呈现效果，是构建复杂智能家居仪表盘的理想选择。掌握其模板语法后，用户可以轻松实现各种个性化的信息展示需求。