Règle CSSRègles @

@supports

N’active des styles que dans les navigateurs qui gèrent une propriété, une valeur ou un sélecteur donné, pour utiliser les nouveautés sans risque.

Sur cette page

Exemple

#
CSS
.header {
  background: rgb(24 24 27 / 0.95);
}

@supports (backdrop-filter: blur(8px)) {
  .header {
    background: rgb(24 24 27 / 0.55);
    backdrop-filter: blur(8px);
  }
}
Aperçu

La barre est semi-transparente et floute les tuiles situées dessous uniquement là où backdrop-filter fonctionne. Un navigateur sans cette fonctionnalité affichera une barre presque opaque, le texte restera donc lisible de toute façon.

Définition et utilisation

#

La règle @supports demande au navigateur s’il comprend une syntaxe donnée. Entre parenthèses, vous indiquez une déclaration, par ex. (display: grid), et le navigateur vérifie s’il connaît à la fois la propriété et cette valeur. Si oui, les styles du bloc s’appliquent. Sinon, tout le bloc est ignoré.

Un schéma typique est l’amélioration progressive. En dehors de la règle, vous écrivez un style simple qui fonctionne partout, et dans @supports vous ajoutez la version plus récente. La variante inverse, @supports not (…), contient une solution de repli uniquement pour les navigateurs qui ne connaissent pas la fonctionnalité.

Vous combinez les conditions avec and et or, et chacune doit être entre ses propres parenthèses. La fonction selector() vérifie la prise en charge d’un sélecteur, par ex. selector(:has(img)). C’est important, car un seul sélecteur inconnu dans une liste invalide toute la règle, et dans @supports vous pouvez préparer un remplacement.

N’oubliez pas que @supports vérifie seulement si le navigateur reconnaît la syntaxe, et non si la fonctionnalité marche sans défaut dans le moindre détail. Vous n’en avez pas non plus besoin pour chaque nouveauté : le navigateur ignore de toute façon silencieusement une déclaration inconnue. La règle ne devient utile que lorsque d’autres styles dépendent de cette prise en charge.

Syntaxe

#
Syntaxe
@supports (<propriété>: <valeur>) {
  sélecteur { propriété: valeur; }
}

@supports not (<condition>) { … }
@supports (<condition>) and (<condition>) { … }
@supports (<condition>) or (<condition>) { … }
@supports selector(<sélecteur>) { … }

Types de conditions

#
  • (display: grid)

    une propriété et une valeur

    Tout navigateur moderne connaît la grille, le bloc s’applique donc et les tuiles s’alignent sur trois colonnes. Sans lui, elles resteraient les unes sous les autres.
  • not (display: grid)

    absence de prise en charge

    Le bloc ne s’applique que là où la grille manque, c’est-à-dire dans de très vieux navigateurs. Ici il ne s’active pas, les tuiles restent donc les unes sous les autres, comme dans le style de base.
  • selector(:has(*))

    la prise en charge d’un sélecteur

    Vérifie un sélecteur au lieu d’une déclaration. Survolez une tuile : les autres s’estompent. La règle avec :has() ne fonctionne que dans les navigateurs qui connaissent ce sélecteur.
  • (…) and (…)

    les deux conditions à la fois

    Le bloc ne s’applique que si le navigateur prend en charge la grille et aspect-ratio. Les tuiles s’alignent sur une ligne et deviennent carrées.
  • (…) or (…)

    au moins une condition

    Une seule condition remplie suffit. C’est ainsi qu’on vérifie les propriétés préfixées : le verre floute les tuiles situées dessous si le navigateur connaît backdrop-filter dans l’une ou l’autre version.

Types de conditions en pratique

#

(display: grid)

Tout navigateur moderne connaît la grille, le bloc s’applique donc et les tuiles s’alignent sur trois colonnes. Sans lui, elles resteraient les unes sous les autres.
@supports (display: grid) {
  .demo {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
  }
}

not (display: grid)

Le bloc ne s’applique que là où la grille manque, c’est-à-dire dans de très vieux navigateurs. Ici il ne s’active pas, les tuiles restent donc les unes sous les autres, comme dans le style de base.
@supports not (display: grid) {
  .demo { flex-direction: row; }
}

selector(:has(*))

Vérifie un sélecteur au lieu d’une déclaration. Survolez une tuile : les autres s’estompent. La règle avec :has() ne fonctionne que dans les navigateurs qui connaissent ce sélecteur.
@supports selector(:has(*)) {
  .demo:has(.box:hover) .box:not(:hover) {
    opacity: 0.3;
  }
}

(…) and (…)

Le bloc ne s’applique que si le navigateur prend en charge la grille et aspect-ratio. Les tuiles s’alignent sur une ligne et deviennent carrées.
@supports (display: grid) and (aspect-ratio: 1) {
  .demo {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
  }
  .demo .box { aspect-ratio: 1; }
}

(…) or (…)

Une seule condition remplie suffit. C’est ainsi qu’on vérifie les propriétés préfixées : le verre floute les tuiles situées dessous si le navigateur connaît backdrop-filter dans l’une ou l’autre version.
@supports (backdrop-filter: blur(6px))
  or (-webkit-backdrop-filter: blur(6px)) {
  .glass {
    background: rgb(255 255 255 / 0.12);
    -webkit-backdrop-filter: blur(6px);
    backdrop-filter: blur(6px);
  }
}

Plus d’exemples

#
Requêtes de conteneur avec solution de repli
CSS
.card {
  display: grid;
  gap: 10px;
}

@supports (container-type: inline-size) {
  .slot {
    container-type: inline-size;
  }

  @container (width >= 300px) {
    .card {
      grid-template-columns: 80px 1fr;
      align-items: center;
    }
  }
}
Aperçu

Le plus simple pour vérifier la prise en charge des requêtes de conteneur est la propriété container-type, apparue en même temps qu’elles. Un navigateur sans cette fonctionnalité affichera simplement une carte verticale.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Écrivez le style de base en dehors de la règle, et ne mettez dans @supports que ce qui exige la nouvelle fonctionnalité. Un navigateur plus ancien obtiendra un rendu plus simple, mais fonctionnel.
  • Vous pouvez vérifier la prise en charge d’une règle @ au moyen de la propriété qui est arrivée avec elle, par ex. @supports (container-type: inline-size) avant d’utiliser @container.
  • Pour les propriétés préfixées, vérifiez les deux versions avec or, par ex. (backdrop-filter: blur(4px)) or (-webkit-backdrop-filter: blur(4px)).

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.