高級配置
本節涵蓋超出基本設定之外的其他配置選項。雖然基本設定已提供啟動卡片所需的一切,但這些進階參數可以讓您深入自訂其行為和外觀。


使用這些設定,您可以調整版面尺寸以完美符合儀表板,配置無障礙選項,管理特定 UI 元素的可見性,並完全覆蓋預設的地圖顏色。
全高(full_height)
由於地圖可以完全平移和縮放,卡片特別設計為在任何情況下都不會渲染超過螢幕高度。這確保整個地圖視圖始終適合於視窗範圍內,而無需捲動頁面。
如果您希望覆蓋此設計意圖,可以將此參數設為 false。禁用時,卡片將始終縮放以填滿最大可用寬度,即使其結果高度超過螢幕邊界。
不建議
一般不建議將此參數設置為 false。它可能對儀表板的導航和整體用戶體驗產生負面影響,並可能導致地圖平移功能的不必要鎖定,除非在 locked 配置參數中另行配置。
長寬比 (aspect_ratio)
此參數定義地圖顯示區域的長寬比。例如,值為 1.5 表示寬度是高度的 1.5 倍。根據平面圖的形狀,可以將其設置在 0.1 和 100 之間。
重要
除非將 full_height 設置為 true,否則無論提供的長寬比如何,卡片的高度都不會超過視圖。
左手模式 (left_handed)
將此參數設置為 true 時,操作按鈕及其相關菜單會顯示在卡片的左側,而不是右側,前提是卡片足夠寬以便內容對齊到右側。
禁用觸覺反饋 (disable_haptic)
將此參數設為 true 會停用具備觸覺功能的行動裝置在使用者介面互動時,卡片觸發的觸覺回饋振動。
重要
服務呼叫成功與失敗結果的觸覺回饋無法被停用。這確保了與 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