Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.hasAttribute() e Element.scrollIntoView()

Verifica se un elemento ha un certo attributo e usa il risultato per decidere se scorrere fino a quell’elemento. Distingui la presenza dal valore dell’attributo e lo scorrimento dal focus.

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

Sintassi

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

element.hasAttribute(name) restituisce true se l’attributo indicato è presente al momento della chiamata, altrimenti false. Sia una stringa vuota sia la stringa "false" contano come presenza. Usa getAttribute(name) per leggere il valore (null se l’attributo manca) e hasAttributeNS(namespace, localName) per controllare in base allo spazio dei nomi e al nome locale. Un attributo booleano HTML come disabled è vero per il solo fatto di essere presente: "false" non è un valore valido e non lo disattiva.

element.scrollIntoView() fa scorrere, se necessario, i contenitori antenati scorrevoli, incluso il viewport, per portare l’elemento nell’area visibile. Non assegna il focus e non fa visualizzare un elemento privo di box di layout, per esempio con display: none. Senza argomenti o con true, la chiamata equivale a { block: "start", inline: "nearest" }; false cambia block in "end".

Nell’oggetto delle opzioni, block e inline regolano l’allineamento sugli assi logici di blocco e in linea. Accettano "start", "center", "end" o "nearest"; quest’ultima opzione limita lo spostamento necessario. behavior sceglie un’animazione ("smooth"), un salto ("instant") o l’impostazione CSS scroll-behavior ("auto", predefinita). L’impostazione predefinita container: "all" consente lo scorrimento di tutti gli antenati scorrevoli; container: "nearest" lo limita al più vicino, dove supportato. Non è lo stesso dell’allineamento "nearest".

Entrambi i metodi si chiamano su un’istanza di Element. Fanno parte della piattaforma web, non di ECMAScript 2024; prima di chiamarli, controlla che la ricerca dell’elemento non abbia restituito null. Il supporto delle opzioni e del valore restituito varia: scrollIntoView() può restituire una Promise che si risolve con un oggetto contenente il booleano interrupted. Se l’implementazione restituisce undefined, await da solo non attende la fine dello scorrimento.

Esempi

<!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>

Risultato

false
true
true

Salva l’esempio come file HTML, aprilo in un browser e controlla la console di sviluppo. `spacer` non ha il marcatore, mentre `target` ha `data-jump` con valore `"false"`, quindi solo `target` avvia lo scorrimento. Il terzo `true` indica che `scrollTop` del pannello è aumentato; non è il valore restituito da `scrollIntoView()`.

Lezioni correlate

  • JavaScript · Lezione 37 · Avanzato · Versione: 4

Fonti