高级配置
本节介绍超出基本设置之外的额外配置选项。虽然基本设置提供了运行卡片所需的一切，但这些高级参数允许您深度自定义卡片的行为和外观。
使用这些设置，您可以调整布局尺寸以完美适应仪表板，配置辅助功能选项，管理特定 UI 元素的可见性，并完全覆盖默认的地图颜色。
全高（full_height)
由于地图可以完全平移和缩放，卡片被明确设计为在任何情况下都不会渲染得比屏幕更高。这确保整个地图视图始终适合视口，无需滚动页面。
如果您希望覆盖此设计，可以将此参数设置为 false。禁用时，卡片将始终按最大可用宽度缩放，即使其最终高度超过屏幕边界。
不推荐
通常不建议将此参数设置为 false。它可能会对仪表板的导航和整体用户体验产生负面影响，并可能导致地图平移功能的不必要锁定，除非在 locked 配置参数中另行配置。
纵横比(aspect_ratio)
这定义了地图显示区域的纵横比。例如，值为 1.5 意味着宽度是高度的 1.5 倍。根据楼层平面的形状，可以将其设置在 0.1 和 100 之间。
重要
除非将 full_height 设置为 true，否则无论提供的纵横比如何，卡片的显示高度都不会超过视图。
左手模式(left_handed)
将此参数设置为 true 会在卡片的左侧显示操作按钮及其相关菜单，而不是右侧，前提是卡片足够宽以使内容对齐到右侧。
禁用触觉反馈(disable_haptic)
将此参数设置为 true 会在具有触觉功能的移动设备上禁用卡片在 UI 交互过程中触发的触觉反馈震动。
重要
服务调用成功和失败的结果触觉反馈无法禁用。这确保了与标准 Home Assistant 行为的一致性，例如触发服务调用的开关和选择器等交互组件。
触摸锁定持续时间（touch_lock)
覆盖 卡片锁定模式 部分中 auto 和 only_touch 模式下使用的默认 100 毫秒触摸解锁保持持续时间。它接受 100 到 400 毫秒之间的值。
旧版开关（legacy_switches)
将此参数设置为 true 会将开关恢复为旧的 Material 切换设计，而不是使用 Home Assistant 2026.5 中引入的新切换设计。
警告
如果安装的 Home Assistant 版本低于 2026.5，将此参数设置为 true 没有任何效果，因为旧版开关设计已经是原生使用的。
脚本（scripts)
一个 Home Assistant 脚本 实体的列表，例如 - script.sweep_living_room，这些实体会直接添加到吸尘器的 快捷方式 列表的主屏幕上。
快捷方式列表会显示这些脚本及其实体名称，并附带一个 开始 () 按钮。它们会被插入到快捷方式列表的最顶端，保持配置中定义的准确顺序。这意味着自定义脚本会显示在机器人的原生快捷方式之前。
此外，如果吸尘器设备原生不支持快捷方式，在此处定义脚本会强制快捷方式操作按钮在主屏幕上可见。这样，即便是对于不支持的设备，这个卡片也可以通过 Home Assistant 提供类似的快捷方式功能。
YAML 示例
yaml
type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
aspect_ratio: 1.5
full_height: true
touch_lock: 200
disable_haptic: true
left_handed: true
legacy_switches: true
scripts:
- script.sweep_living_room
- script.mop_kitchen