Règle CSSRègles @

@starting-style

Décrit le style à partir duquel démarre une transition quand un élément apparaît dans la page. Les nouveaux éléments peuvent ainsi entrer en douceur.

Sur cette page

Exemple

#
CSS
.modal[open] {
  opacity: 1;
  scale: 1;
  transition: opacity 0.3s, scale 0.3s;
}

@starting-style {
  .modal[open] {
    opacity: 0;
    scale: 0.9;
  }
}

.modal::backdrop {
  background: rgb(0 0 0 / 0.6);
}
Aperçu

Cliquez sur « Récupérer la récompense ». La fenêtre apparaît en douceur, car @starting-style fournit l’état initial. Elle se ferme tout de suite : une fermeture en douceur demande en plus display avec allow-discrete dans la transition, comme dans l’exemple ci-dessous.

Définition et utilisation

#

Une transition (transition) a besoin de deux états : l’état précédent et le nouveau. Un élément qui vient d’arriver dans la page ou qui a cessé d’avoir display: none n’a pas d’état précédent, le navigateur l’affiche donc immédiatement dans son apparence finale. La règle @starting-style fournit l’état manquant : la transition démarre à partir de ces styles lors du premier affichage de l’élément.

L’écriture est simple. Vous donnez à l’élément ses styles cibles et sa transition, et dans @starting-style vous répétez le sélecteur avec les valeurs de départ, par ex. opacity: 0 et translate: 0 20px. La règle peut s’écrire séparément ou être imbriquée dans le sélecteur. Les styles de départ n’ont pas une spécificité plus élevée, placez donc le bloc @starting-style après la règle cible.

On la combine le plus souvent avec transition-behavior: allow-discrete pour la propriété display. L’élément alors non seulement apparaît en douceur, mais disparaît aussi en douceur, car display: none ne s’active qu’à la fin de la transition. C’est ainsi qu’on anime les fenêtres <dialog> et les éléments avec l’attribut popover.

La règle ne concerne que les transitions. Les animations @keyframes démarrent d’elles-mêmes quand un élément apparaît, elles n’ont donc pas besoin d’état initial. Un navigateur qui ne connaît pas @starting-style affichera simplement l’élément tout de suite, sans aucune erreur.

Syntaxe

#
Syntaxe
sélecteur {
  transition: opacity 0.3s;
}

@starting-style {
  sélecteur { opacity: 0; }
}

Effets d’entrée

#
  • opacity: 0

    apparition en fondu

    L’élément réapparaît sans cesse et repart à chaque fois de la transparence totale. Il disparaît instantanément, car la sortie n’est pas animée.
  • translate: 0 24px

    entrée par le bas

    Départ 24 px plus bas et transparent. L’élément glisse à sa place, comme une notification.
  • scale: 0.3

    surgissement avec effet ressort

    L’élément démarre réduit, et une courbe cubic-bezier avec une valeur supérieure à 1 donne un léger dépassement, comme avec un ressort.
  • filter: blur(8px)

    mise au point, écriture imbriquée

    La règle peut être imbriquée dans le sélecteur de l’élément. Les déclarations à l’intérieur concernent alors le même élément, et l’ordre est correct de lui-même.
  • sans @starting-style

    pas d’animation

    transition seule ne suffit pas. L’élément n’a pas d’état précédent, la transition n’a donc aucun point de départ et l’élément apparaît tout de suite.
  • display + allow-discrete

    entrée et sortie

    Avec allow-discrete sur display, le navigateur attend la fin de la transition pour masquer l’élément. L’élément apparaît en douceur et disparaît en douceur.
  • [popover]

    une fenêtre popover

    Cliquez sur le bouton. Un popover ouvert correspond à :popover-open, et @starting-style le fait entrer par le bas. Vous le fermez en cliquant à côté ou avec la touche Échap.

Effets d’entrée en pratique

#

opacity: 0

L’élément réapparaît sans cesse et repart à chaque fois de la transparence totale. Il disparaît instantanément, car la sortie n’est pas animée.
.demo { transition: opacity 0.6s; }

@starting-style {
  .demo { opacity: 0; }
}

translate: 0 24px

Départ 24 px plus bas et transparent. L’élément glisse à sa place, comme une notification.
.demo {
  transition: opacity 0.6s, translate 0.6s;
}

@starting-style {
  .demo { opacity: 0; translate: 0 24px; }
}

scale: 0.3

L’élément démarre réduit, et une courbe cubic-bezier avec une valeur supérieure à 1 donne un léger dépassement, comme avec un ressort.
.demo {
  transition: scale 0.5s cubic-bezier(0.3, 1.6, 0.6, 1);
}

@starting-style {
  .demo { scale: 0.3; }
}

filter: blur(8px)

La règle peut être imbriquée dans le sélecteur de l’élément. Les déclarations à l’intérieur concernent alors le même élément, et l’ordre est correct de lui-même.
.demo {
  transition: opacity 0.6s, filter 0.6s;

  @starting-style {
    opacity: 0;
    filter: blur(8px);
  }
}

sans @starting-style

transition seule ne suffit pas. L’élément n’a pas d’état précédent, la transition n’a donc aucun point de départ et l’élément apparaît tout de suite.
.demo { transition: opacity 0.6s; }

display + allow-discrete

Avec allow-discrete sur display, le navigateur attend la fin de la transition pour masquer l’élément. L’élément apparaît en douceur et disparaît en douceur.
.demo {
  transition: opacity 0.6s,
    display 0.6s allow-discrete;
}
.demo.hidden { opacity: 0; }

@starting-style {
  .demo { opacity: 0; }
}

[popover]

Cliquez sur le bouton. Un popover ouvert correspond à :popover-open, et @starting-style le fait entrer par le bas. Vous le fermez en cliquant à côté ou avec la touche Échap.
[popover]:popover-open {
  transition: opacity 0.3s, translate 0.3s;
}

@starting-style {
  [popover]:popover-open {
    opacity: 0;
    translate: 0 16px;
  }
}

Plus d’exemples

#
Une fenêtre qui s’ouvre et se ferme en douceur
CSS
.modal {
  opacity: 0;
  translate: 0 24px;
  transition:
    opacity 0.3s,
    translate 0.3s,
    display 0.3s allow-discrete,
    overlay 0.3s allow-discrete;
}

.modal[open] {
  opacity: 1;
  translate: 0;
}

@starting-style {
  .modal[open] {
    opacity: 0;
    translate: 0 24px;
  }
}
Aperçu

La fenêtre entre par le bas et disparaît de la même façon. display avec allow-discrete attend la fin de la transition pour la masquer, et overlay, là où le navigateur le prend en charge, maintient la fenêtre qui se ferme au-dessus de la page jusqu’à la fin de l’animation.

Compatibilité des navigateurs

#

Nouveau dans les navigateurs · depuis 2024

Fonctionne dans les versions actuelles de tous les grands navigateurs. Les anciennes versions peuvent ne pas le prendre en charge.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Placez le bloc @starting-style après la règle que vous animez, ou imbriquez-le dedans. Les styles de départ n’ont pas une spécificité plus élevée, une règle écrite plus tard les écraserait donc.
  • Pour une disparition en douceur, ajoutez à la transition display avec allow-discrete, et pour les boîtes de dialogue et les popovers aussi overlay. @starting-style seul ne gère que l’entrée.
  • Les transitions de survol ordinaires n’ont pas besoin de cette règle. Ne l’utilisez que lorsqu’un élément apparaît dans la page ou sort de display: none.

Entrées associées

#

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