WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.hasAttribute() und Element.scrollIntoView()

Prüfe, ob ein Element ein bestimmtes Attribut besitzt, und entscheide damit, ob zu ihm gescrollt werden soll. Unterscheide das Vorhandensein vom Attributwert und das Scrollen vom Fokussieren.

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

Syntax

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

element.hasAttribute(name) gibt true zurück, wenn das benannte Attribut zum Zeitpunkt des Aufrufs vorhanden ist, sonst false. Sowohl eine leere Zeichenfolge als auch "false" zählen als vorhanden. Mit getAttribute(name) liest du den Wert (null, wenn das Attribut fehlt); mit hasAttributeNS(namespace, localName) prüfst du nach Namensraum und lokalem Namen. Ein boolesches HTML-Attribut wie disabled ist durch seine Anwesenheit wahr; "false" ist dafür kein gültiger Wert und schaltet es nicht aus.

element.scrollIntoView() scrollt bei Bedarf die scrollbaren Vorfahren einschließlich des Viewports, um das Element in den sichtbaren Bereich zu bringen. Die Methode setzt keinen Fokus und macht ein Element ohne Layoutbox, etwa bei display: none, nicht sichtbar. Ein Aufruf ohne Argument oder mit true entspricht { block: "start", inline: "nearest" }; false ändert block zu "end".

Im Optionsobjekt steuern block und inline die Ausrichtung entlang der logischen Block- bzw. Inline-Achse. Beide akzeptieren "start", "center", "end" oder "nearest"; Letzteres begrenzt die nötige Bewegung. behavior wählt eine Animation ("smooth"), einen Sprung ("instant") oder die CSS-Einstellung scroll-behavior ("auto", Standard). Der Standard container: "all" erlaubt das Scrollen aller scrollbaren Vorfahren; container: "nearest" beschränkt es bei entsprechender Unterstützung auf den nächsten. Das ist etwas anderes als die Ausrichtung "nearest".

Beide Methoden werden auf einer Element-Instanz aufgerufen. Sie gehören zur Webplattform, nicht zu ECMAScript 2024. Prüfe vor dem Aufruf, ob die Suche nach dem Element null ergeben hat. Die Unterstützung für Optionen und Rückgabewert hängt vom Browser ab: scrollIntoView() kann ein Promise zurückgeben, das mit einem Objekt mit dem booleschen Feld interrupted erfüllt wird. Gibt die Implementierung undefined zurück, wartet await allein nicht auf das Ende des Scrollens.

Beispiele

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

Ergebnis

false
true
true

Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgaben in der Entwicklerkonsole. `spacer` hat keine Markierung, `target` dagegen hat `data-jump` mit dem Wert `"false"`. Nur `target` löst das Scrollen aus. Das dritte `true` zeigt, dass `scrollTop` des Panels gestiegen ist; es ist nicht der Rückgabewert von `scrollIntoView()`.

Zugehörige Lektionen

  • JavaScript · Lektion 37 · Fortgeschritten · Version: 4

Quellen