Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLElement.style.scrollBehavior — régler le défilement fluide

Lisez, définissez ou supprimez la déclaration CSS en ligne `scroll-behavior` d’un élément, sans la confondre avec la valeur CSS résolue ni avec une option propre à un appel.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

element.style.scrollBehavior;
element.style.scrollBehavior = "smooth";
element.style.scrollBehavior = "auto";
element.style.scrollBehavior = "";

HTMLElement.style.scrollBehavior est une propriété du CSSOM sur l’objet style d’un élément HTML. Ce n’est ni une propriété statique du constructeur HTMLElement, ni une fonctionnalité d’ECMAScript. Utilisez element.style.scrollBehavior pour lire ou modifier la déclaration CSS en ligne de scroll-behavior.

En l’absence de déclaration en ligne, la lecture renvoie "", même si une feuille de style définit la propriété. Affecter "" supprime uniquement cette déclaration ; affecter "auto" la définit explicitement. Sur un élément rattaché au document, getComputedStyle(element).scrollBehavior permet de lire la valeur résolue après application de la cascade.

Définir cette propriété ne déclenche pas de défilement. Elle règle la façon dont un conteneur défile à la suite d’une navigation, par exemple via un lien vers un fragment de la page, ou d’un appel à une API de défilement du CSSOM. Elle ne modifie pas le défilement direct à la molette ou par geste. En CSS, auto est la valeur initiale et donne un défilement instantané ; smooth demande une animation dont le navigateur choisit la durée et la courbe de progression. La propriété n’est pas héritée par défaut, et le navigateur peut l’ignorer.

Pour régler le défilement de la zone d’affichage d’une page HTML, utilisez l’élément racine (document.documentElement) ; une déclaration sur document.body ne se propage pas à cette zone. Dans element.scrollTo({ top: 100, behavior: "auto" }), "auto" suit le CSS ; "smooth" et "instant" choisissent le comportement pour ce seul appel. "instant" n’est pas une valeur CSS valide pour scroll-behavior. Ne forcez pas le défilement fluide lorsque prefers-reduced-motion: reduce correspond aux préférences de l’utilisateur.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Inline scroll behavior</title>
</head>
<body>
  <script>
    const element = document.createElement("div");
    console.log(JSON.stringify(element.style.scrollBehavior));
    element.style.scrollBehavior = "smooth";
    console.log(JSON.stringify(element.style.getPropertyValue("scroll-behavior")));
    element.style.scrollBehavior = "";
    console.log(JSON.stringify(element.style.scrollBehavior));
  </script>
</body>
</html>

Résultat

""
"smooth"
""

L’exemple utilise un élément non rattaché au document pour lire, définir puis supprimer la déclaration sans faire défiler la page. `JSON.stringify()` affiche la chaîne vide sous la forme `""`.

Leçons associées

  • JavaScript · Leçon 37 · Avancé · Version : 4

Sources