Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Element.hasAttribute() a Element.scrollIntoView()

Zisti, či má prvok určitý atribút, a podľa výsledku rozhodni, či k nemu posunieš zobrazenie. Rozlišuj prítomnosť atribútu od jeho hodnoty a posúvanie od nastavenia fokusu.

Verzia: 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) vráti true, ak je pomenovaný atribút prítomný v okamihu volania, inak false. Prázdny reťazec aj reťazec "false" znamenajú, že atribút je prítomný. Na čítanie hodnoty použi getAttribute(name) (null, ak atribút chýba); na overenie podľa priestoru názvov a lokálneho názvu použi hasAttributeNS(namespace, localName). Pri booleovskom atribúte HTML, napríklad disabled, znamená už samotná prítomnosť pravdu; "false" nie je platná hodnota a atribút nevypne.

element.scrollIntoView() podľa potreby posunie obsah posúvateľných nadradených kontajnerov vrátane zobrazovacej oblasti prehliadača, aby sa prvok dostal do viditeľnej časti. Nenastaví fokus ani nezobrazí prvok bez vykresľovacieho boxu, napríklad pri display: none. Volanie bez argumentu alebo s true zodpovedá { block: "start", inline: "nearest" }; false zmení block na "end".

V objekte možností určujú block a inline zarovnanie na logickej blokovej a riadkovej osi. Prijímajú "start", "center", "end" alebo "nearest"; posledná možnosť obmedzuje potrebný posun. behavior vyberá animáciu ("smooth"), skok ("instant") alebo nastavenie CSS scroll-behavior ("auto", predvolená hodnota). Predvolené container: "all" umožňuje posun všetkých posúvateľných nadradených kontajnerov; container: "nearest" ho obmedzí na najbližší, ak je táto možnosť podporovaná. Nie je to to isté ako zarovnanie "nearest".

Obe metódy sa volajú na inštancii Element. Patria k webovej platforme, nie k ECMAScriptu 2024; pred volaním over, že vyhľadanie prvku nevrátilo null. Podpora možností a návratovej hodnoty závisí od prehliadača: scrollIntoView() môže vrátiť Promise, ktorá sa splní objektom s booleovskou vlastnosťou interrupted. Ak implementácia vráti undefined, samotné await nečaká na skončenie posúvania.

Príklady

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

Výsledok

false
true
true

Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výpis vo vývojárskej konzole. `spacer` nemá značku, zatiaľ čo `target` má `data-jump` s hodnotou `"false"`, takže posun vyvolá len `target`. Tretie `true` znamená, že `scrollTop` panela sa zväčšil; nejde o návratovú hodnotu `scrollIntoView()`.

Súvisiace lekcie

  • JavaScript · Lekcia 37 · Pokročilá · Verzia: 4

Zdroje