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

CKTIS / JavaScript

Element.hasAttribute() et Element.scrollIntoView()

Vérifiez si un élément possède un attribut donné avant de faire défiler la page ou un conteneur jusqu’à lui. Distinguez la présence de la valeur de l’attribut, et le défilement de la prise de focus.

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

Syntaxe

element.hasAttribute(name)
element.scrollIntoView()
element.scrollIntoView(alignToTop)
element.scrollIntoView(options)

element.hasAttribute(name) renvoie true si l’attribut nommé est présent au moment de l’appel, et false sinon. Une chaîne vide et la chaîne "false" comptent toutes deux comme une présence. Utilisez getAttribute(name) pour lire la valeur (null si l’attribut est absent), et hasAttributeNS(namespace, localName) pour vérifier la présence par espace de noms et nom local. Un attribut booléen HTML comme disabled vaut vrai par sa seule présence ; "false" n’est pas une valeur valide pour cet attribut et ne le désactive pas.

element.scrollIntoView() fait défiler au besoin les conteneurs ancêtres défilables, y compris la zone d’affichage, pour amener l’élément dans la partie visible. La méthode ne donne pas le focus et ne rend pas un élément dépourvu de boîte de mise en page, par exemple avec display: none. Sans argument ou avec true, l’appel correspond à { block: "start", inline: "nearest" } ; false remplace block par "end".

Dans l’objet d’options, block et inline règlent l’alignement sur les axes logiques de bloc et en ligne. Ces options acceptent "start", "center", "end" ou "nearest" ; la dernière limite le déplacement nécessaire. behavior choisit une animation ("smooth"), un saut ("instant") ou le réglage CSS scroll-behavior ("auto", par défaut). Par défaut, container: "all" autorise le défilement de tous les ancêtres défilables ; container: "nearest" le limite au plus proche si l’option est prise en charge. Ce choix est distinct de l’alignement "nearest".

Les deux méthodes s’appellent sur une instance d’Element. Elles relèvent de la plateforme web, et non d’ECMAScript 2024 ; vérifiez que la recherche de l’élément n’a pas renvoyé null avant l’appel. La prise en charge des options et de la valeur de retour dépend du navigateur : scrollIntoView() peut renvoyer une Promise qui se résout avec un objet contenant le booléen interrupted. Si l’implémentation renvoie undefined, await seul n’attend pas la fin du défilement.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Conditional scrolling</title>
</head>
<body>
<script>
(() => {
  const panel = document.createElement("div");
  panel.style.cssText = "position:fixed;top:12px;left:12px;width:220px;height:96px;overflow:auto;border:1px solid;padding:0;writing-mode:horizontal-tb";

  const spacer = document.createElement("div");
  spacer.style.height = "240px";
  const target = document.createElement("div");
  target.style.height = "32px";
  target.textContent = "Target";
  target.setAttribute("data-jump", "false");
  panel.append(spacer, target);
  document.body.append(panel);

  const before = panel.scrollTop;
  for (const element of [spacer, target]) {
    const marked = element.hasAttribute("data-jump");
    console.log(String(marked));
    if (marked) {
      element.scrollIntoView({ behavior: "instant", block: "end", inline: "nearest" });
    }
  }
  requestAnimationFrame(() => console.log(String(panel.scrollTop > before)));
})();
</script>
</body>
</html>

Résultat

false
true
true

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console de développement. `spacer` n’a pas de marqueur, tandis que `target` possède `data-jump` avec la valeur `"false"` : seul `target` déclenche un défilement. Le troisième `true` indique que le `scrollTop` du panneau a augmenté ; ce n’est pas la valeur renvoyée par `scrollIntoView()`.

Leçons associées

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

Sources