Aller au contenu

Spark Badge ​

Le spark badge insère un uix-badge avant ou après un élément créé par Forge. Il utilise la base Web Awesome adaptée par Home Assistant et suit les couleurs du thème. UIX n'enregistre pas de composant global wa-badge.

Cette référence compacte est adaptée de la page originale de la version 8.4.0, sous CC BY 4.0, par Lint-Free-Technology/uix. D'autres exemples illustrés figurent dans la documentation anglaise.

Utilisation de base ​

yaml
type: custom:uix-forge
forge:
  mold: card
  sparks:
    - type: badge
      after: hui-tile-card $ ha-tile-icon
      content: 3
      variant: danger
      pill: true
element:
  type: tile
  entity: light.bed_light

Configuration ​

CléTypeValeur par défautDescription
typestring, obligatoire—badge
afterstringBlank Card : uix-forge-blank-card $ div.content, sinon ""Élément de référence ; insertion après. Fournir after ou before, sauf si la valeur Blank Card s'applique.
beforestring—Élément de référence ; insertion avant.
contentstring / number""Texte affiché, pas du HTML.
variantstringbrandbrand, neutral, success, warning, danger
appearancestringaccentaccent, filled, outlined, filled-outlined
pillbooleanfalseForme entièrement arrondie.
attentionstringnonenone, pulse, bounce. Pour pulse, accent/filled utilisent la couleur de remplissage, les autres apparences celle de la bordure.
placementstringAutomatique sur ha-button/ha-tile-icon : top-end ; sinon absentPosition sur l'élément ou son parent, voir ci-dessous.
start_icon / end_iconstring—Icône MDI avant/après le contenu.
styleobject—Table plate de propriétés CSS et valeurs texte ou numériques, appliquées directement au badge.

Seul le premier élément correspondant au sélecteur est utilisé. Dans une Tile Card, ciblez ha-tile-icon pour le coin ; ha-tile-info occupe le reste de la largeur de la ligne.

Placement ​

Le placement automatique concerne uniquement ha-button et ha-tile-icon, au coin supérieur de fin logique (top-end). Sur ha-button, le badge est inséré dans le bouton. Sur ha-tile-icon, il utilise le slot par défaut documenté et les décalages compacts de Home Assistant. Ici, after/before choisit la cible, pas l'ordre d'insertion.

UIX reconnaît le wrapper display: contents d'un spark Button et place le badge sur son ha-button. La Button Card intégrée hui-button-card ne contient pas de ha-button et n'a pas de placement automatique.

Pour les autres cibles, sans placement, le badge reste un élément voisin. Avec placement, il est placé au bord du parent. UIX ne mesure ni ne modifie la cible. Si plusieurs enfants sont visibles, la position se rapporte au parent entier.

Valeurs acceptées : top, top-start, top-end, bottom, bottom-start, bottom-end, left, left-start, left-end, right, right-start, right-end.

Un badge placé utilise par défaut var(--ha-font-size-xs) et un padding 0.25em 0.5em. Les décalages acceptent longueurs et pourcentages. Pour right, top-end ou bottom-end, --uix-badge-offset-x: -50% annule le chevauchement d'une demi-largeur ; pour left, top-start ou bottom-start, utilisez 50%. Des expressions comme calc(-50% - 20px) sont possibles.

Variables CSS ​

À définir sur le badge, un ancêtre ou dans sa table style. Ces variables fonctionnent aussi pour les badges Broker.

VariableValeur par défautEffet
--uix-badge-font-sizemax(var(--wa-font-size-3xs, var(--ha-font-size-xs)), 0.75em) ; placé : var(--ha-font-size-xs)Taille du texte.
--uix-badge-font-weightvar(--wa-font-weight-semibold)Graisse du texte/des icônes.
--uix-badge-padding0.375em 0.625em ; placé : 0.25em 0.5emEspacement intérieur.
--uix-badge-min-widthPlacé : calc(1.5em + 2px)Largeur minimale, bordure de 1 px de chaque côté comprise.
--uix-badge-max-widthnoneLargeur maximale.
--uix-badge-overflowvisibleDébordement ; avec largeur maximale, utiliser par exemple hidden ou clip.
--uix-badge-colorRemplissage Web AwesomeCouleur du fond.
--uix-badge-content-colorCouleur Web AwesomeCouleur du texte/des icônes.
--uix-badge-borderBordure Web AwesomeBordure CSS complète, par exemple 1px solid rgb(255 255 255 / 50%).
--uix-badge-border-colorCouleur de bordure Web AwesomeUtilise --uix-badge-color si cette variable est définie.
--uix-badge-box-shadownoneOmbre statique.
--uix-badge-attention-colorCouleur de remplissage ou de bordure de l'apparenceCouleur de l'anneau pulsant.
--uix-badge-color-hoverCouleur de fond normaleFond au survol.
--uix-badge-content-color-hoverCouleur de contenu normaleTexte/icônes au survol.
--uix-badge-border-color-hoverCouleur de bordure normaleBordure au survol.
--uix-badge-attention-color-hoverCouleur d'attention normaleAnneau au survol.
--uix-badge-pointer-eventsPlacé : autonone laisse passer les événements du pointeur et désactive le survol.
--uix-badge-z-indexauto ; placé : 1Ordre de superposition.
--uix-badge-offset-x0pxDécalage horizontal ; positif vers la droite.
--uix-badge-offset-y0pxDécalage vertical ; positif vers le bas.

Les variables de couleur acceptent les valeurs CSS transparentes rgba() ou rgb() modernes. Avec attention: pulse, l'ombre statique reste présente et UIX ajoute l'anneau expansif. Le survol d'un badge placé n'agit que lorsque le pointeur se trouve sur le badge lui-même.

Exemple : placement sur une Button Card ​

La Button Card remplit ici son parent. Le placement explicite positionne le badge sur ce conteneur sans modifier le DOM interne de la carte.

yaml
type: custom:uix-forge
forge:
  mold: card
  sparks:
    - type: badge
      after: hui-button-card
      content: 3
      variant: danger
      pill: true
      placement: top-end
      style:
        "--uix-badge-offset-x": -6px
        "--uix-badge-offset-y": 6px
        "--uix-badge-font-size": 24px
element:
  type: button
  entity: light.bed_light

Les autres exemples originaux présentent un badge d'état voisin de ha-tile-info avec flex: 1, une animation pilotée par template, un badge sur un spark Button et une Blank Card centrée.

Exemples originaux complétés ​

Décalage sur une icône Tile ​

Un décalage de deux pixels sur chaque axe déplace le badge vers l’intérieur.

yaml
type: custom:uix-forge
forge:
  mold: card
  sparks:
    - type: badge
      after: hui-tile-card $ ha-tile-icon
      content: 3
      variant: danger
      pill: true
      style:
        "--uix-badge-offset-x": -2px
        "--uix-badge-offset-y": -2px
element:
  type: tile
  entity: light.bed_light

Décalage sur une icône Tile

État à côté du titre ​

ha-tile-info reçoit flex: 1 afin de libérer la place nécessaire au badge voisin.

yaml
type: custom:uix-forge
forge:
  mold: card
  sparks:
    - type: badge
      after: hui-tile-card $ ha-tile-info
      content: Experimental
      variant: warning
      appearance: outlined
      start_icon: mdi:flask-outline
element:
  type: tile
  entity: light.bed_light
  uix:
    style: |
      ha-tile-info {
        flex: 1;
      }

État à côté du titre

Attention commandée par un modèle ​

Le contenu, la variante et la pulsation suivent l’état de la fenêtre.

yaml
type: custom:uix-forge
forge:
  mold: card
  sparks:
    - type: badge
      after: hui-tile-card $ ha-tile-icon
      content: |
        {{ '!' if is_state('cover.hall_window', 'open') else '⎷' }}
      variant: |
        {{ 'danger' if is_state('cover.hall_window', 'open') else 'success' }}
      pill: true
      attention: |
        {{ 'pulse' if is_state('cover.hall_window', 'open') else 'none' }}
element:
  type: tile
  entity: cover.hall_window

Attention commandée par un modèle

Badge sur un spark Button ​

Le wrapper utilise display: contents. UIX reconnaît son ha-button et lui attache le badge au lieu de le placer à côté du wrapper.

yaml
type: custom:uix-forge
forge:
  mold: card
  sparks:
    - type: button
      after: hui-tile-card $ ha-tile-icon
      label: Living Room
    - type: badge
      after: "hui-tile-card $ div[data-uix-forge-button-id]"
      content: 3
      variant: danger
      pill: true
element:
  type: tile
  entity: light.bed_light

Badge sur un spark Button

Badge dans une Blank Card ​

La Blank Card est affichée sans bordure ni arrière-plan de carte. Le style centre le badge horizontalement.

yaml
type: custom:uix-forge
forge:
  mold: card
  grid_options:
    columns: 3
  sparks:
    - type: badge
      after: uix-forge-blank-card $ div.content
      content: Badge Spark
      variant: brand
      start_icon: mdi:badge-account-horizontal-outline
  uix:
    style:
      .: |
        :host {
          --ha-card-border-width: 0px;
          --ha-card-background: none;
        }
      uix-forge-blank-card $: |
        ha-card {
          display: flex;
          justify-content: center;
        }

Badge dans une Blank Card