KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.hasAttribute() en Element.scrollIntoView()

Controleer of een element een bepaald attribuut heeft en beslis op basis daarvan of je ernaartoe scrolt. Onderscheid de aanwezigheid van de attribuutwaarde, en scrollen van focus instellen.

Versie: 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) geeft true terug als het genoemde attribuut op het moment van aanroepen aanwezig is, anders false. Zowel een lege tekenreeks als de tekenreeks "false" telt als aanwezig. Gebruik getAttribute(name) om de waarde te lezen (null als het attribuut ontbreekt) en hasAttributeNS(namespace, localName) om te controleren op naamruimte en lokale naam. Een booleaans HTML-attribuut zoals disabled betekent waar zodra het aanwezig is; "false" is geen geldige waarde en schakelt het niet uit.

element.scrollIntoView() scrolt zo nodig de scrollbare bovenliggende containers, inclusief de viewport, om het element in beeld te brengen. De methode stelt geen focus in en zorgt er niet voor dat een element zonder lay-outbox, bijvoorbeeld met display: none, wordt weergegeven. Zonder argument of met true komt de aanroep overeen met { block: "start", inline: "nearest" }; false verandert block in "end".

In het optieobject bepalen block en inline de uitlijning langs de logische blok- en inline-as. Ze accepteren "start", "center", "end" of "nearest"; de laatste optie beperkt de benodigde verplaatsing. behavior kiest een animatie ("smooth"), een sprong ("instant") of de CSS-instelling scroll-behavior ("auto", standaard). De standaard container: "all" laat alle scrollbare bovenliggende containers scrollen; container: "nearest" beperkt dit tot de dichtstbijzijnde, als die optie wordt ondersteund. Dat is iets anders dan de uitlijning "nearest".

Je roept beide methoden aan op een Element-instantie. Ze horen bij het webplatform, niet bij ECMAScript 2024; controleer vóór de aanroep of het opzoeken van het element niet null heeft opgeleverd. Ondersteuning voor opties en de retourwaarde verschilt per browser: scrollIntoView() kan een Promise teruggeven die wordt vervuld met een object met de booleaanse eigenschap interrupted. Als de implementatie undefined teruggeeft, wacht await op zichzelf niet tot het scrollen is afgelopen.

Voorbeelden

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

Resultaat

false
true
true

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de ontwikkelaarsconsole. `spacer` heeft geen markering, terwijl `target` het attribuut `data-jump` met de waarde `"false"` heeft. Alleen `target` veroorzaakt dus scrollen. De derde `true` geeft aan dat `scrollTop` van het paneel is toegenomen; het is niet de retourwaarde van `scrollIntoView()`.

Gerelateerde lessen

  • JavaScript · Les 37 · Gevorderd · Versie: 4

Bronnen