控件介绍

仪表盘由多个独立控件组成。添加控件前，先根据用途选择合适的类型；控件类型决定了右侧属性面板中可以配置的内容。位置、尺寸、缩放和旋转等通用设置则适用于所有控件。

本页保留旧版说明。完整控件清单见认识控件及实体配置；「户型图自动导图」的生成流程及本轮楼层选择更新见自动导图教程。

图片控件

用于展示背景、户型图、灯组开灯图、设备图片或其他装饰素材。选择图片后，可以设置透明度和图片布局：「自由」适合保留原图比例，「铺满」适合作为区域背景。图片控件默认只负责显示内容，如需点击后执行操作，再单独配置动作。

图标按钮

适合制作轻量的设备快捷按钮。可以绑定实体，也可以作为不绑定实体的纯导航或操作入口；常用设置包括图标、标题、状态文字、开启/关闭颜色、大小、位置以及点击、双击和长按动作。

设备按钮

用于显示设备状态并执行设备控制，适合灯光、开关、窗帘和其他需要状态反馈的实体。设备按钮支持控制按钮层和出现效果层，能够分别设置按钮本体、文字、图标、状态填充和动态效果。详细设置见「控件编辑」中的设备按钮属性说明。

图标按钮（效果）

在图标按钮的基础上增加独立的效果图片层，适合制作带光晕、流光或其他视觉反馈的快捷按钮。可以分别设置图标、文字、效果图片、布局、透明度、位置和动画参数；效果层只负责视觉呈现，不会替代控件本身的点击动作。

标题按钮

适合制作页面标题、区域标题或带装饰的入口。可以设置主标题、副标题、图标、边框和光效，并通过动作配置点击后的行为。标题按钮更偏向信息展示和页面入口，不需要绑定 Home Assistant 实体。

导航按钮

用于在侧边栏或页面之间跳转。选择目标页面后，可以设置主标题、副标题、图标、边框、光效以及选中和未选中状态的透明度。导航按钮的目标是页面，不是 Home Assistant 实体。

空调 / 浴霸

用于控制空调或浴霸等温控设备。绑定实体后，可选择自动识别、空调或浴霸模式，并配置图标、标题、状态文字和气流效果；气流效果支持静态或动态显示。若实体同时存在 climate 和 fan 特征，请按实际设备类型选择模式。

本轮待发布的横向按钮、溢出下拉及中文模式说明，见空调 / 浴霸显示规则。

摄像头实时预览

用于在仪表盘中显示 Home Assistant 摄像头实体的实时画面。可设置画面是否显示、图片填充方式、边框、圆角、透明度以及控件位置和尺寸；点击动作可用于打开当前摄像头的详细信息。

扫地机器人实时地图

用于显示扫地机器人实体提供的实时地图。绑定地图实体后，可以调整地图透明度、位置、缩放和旋转；它主要负责地图展示，设备控制可通过设备按钮或弹窗完成。

时间

用于显示当前时间。可以选择 12 小时或 24 小时制、是否显示秒，并设置文字颜色、字号、粗细、字间距和位置。时间控件不需要绑定 Home Assistant 实体。

日期

用于显示当前日期。可以按需要显示星期和农历，并设置日期文字的颜色、字号、粗细、字间距和位置。日期控件同样不需要绑定实体。

天气

用于显示天气实体的图标、温度、天气状态和湿度。每一项都可以单独显示或隐藏，并可分别设置文字大小、颜色、字间距和行间距。使用前需要先绑定 Home Assistant 的天气实体。

折线图

用于展示传感器的历史变化趋势。绑定传感器后，可以设置刷新间隔、历史范围、是否显示当前数值、曲线圆角和阈值颜色，让温度、湿度或功率等数据更直观。

底图框

用于制作页面或区域的装饰性底图框。可以设置中英文标题、边框、圆角、柔光、透明度和位置尺寸，适合为一组控件提供统一的视觉区域；它本身不绑定实体。