高度な設定
このセクションでは、基本設定を超えた追加の構成オプションを説明します。基本設定はカードを動作させるために必要なすべてを提供しますが、これらの高度なパラメータを使用すると、カードの動作および外観を詳細にカスタマイズできます。
これらの設定を使用すると、ダッシュボードに完璧にフィットするようにレイアウトの寸法を調整したり、アクセシビリティオプションを設定したり、特定の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 ms タッチ解除保持時間を上書きします。値は 100 から 400 ms の間で指定できます。
従来のスイッチ (legacy_switches)
このパラメータを true に設定すると、スイッチは Home Assistant 2026.5 で導入された新しいトグルデザインではなく、古い Material トグルデザインに戻ります。
警告
インストールされている Home Assistant のバージョンが 2026.5 より古い場合、このパラメータを true に設定しても効果はありません。従来のスイッチデザインはすでにネイティブで使用されているためです。
スクリプト (scripts)
ホーム画面の掃除機のショートカットリストに直接追加される、- script.sweep_living_roomなどのHome Assistant スクリプトエンティティのリスト。
ショートカットリストには、これらのスクリプトがエンティティ名とともに開始 ()ボタン付きで表示されます。これらはショートカットリストの最上部に挿入され、設定で定義された正確な順序が維持されます。つまり、カスタムスクリプトはロボットのネイティブショートカットよりも先に表示されます。
さらに、掃除機がネイティブでショートカットをサポートしていない場合でも、ここでスクリプトを定義すると、ホーム画面でショートカットアクションボタンが表示されるようになります。これにより、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