CKTIS / JavaScript
Element.hasAttribute() a Element.scrollIntoView()
Zjisti, zda má prvek určitý atribut, a podle výsledku se rozhodni, zda k němu posunout zobrazení. Rozlišuj přítomnost atributu od jeho hodnoty a posun zobrazení od nastavení fokusu.
Verze: 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) vrací true, pokud prvek v okamžiku volání má pojmenovaný atribut, jinak false. Prázdný řetězec i řetězec "false" znamenají, že je atribut přítomen. Pomocí getAttribute(name) načteš hodnotu (null, pokud atribut chybí) a pomocí hasAttributeNS(namespace, localName) ověříš přítomnost podle jmenného prostoru a místního názvu. U booleovského atributu HTML, jako je disabled, znamená už samotná přítomnost pravdu; "false" není platná hodnota a atribut nevypne.
element.scrollIntoView() podle potřeby posune obsah posuvných nadřazených kontejnerů včetně oblasti zobrazení prohlížeče, aby se prvek dostal do viditelné části. Nenastavuje fokus ani nezobrazí prvek bez vykreslovacího boxu, například při display: none. Volání bez argumentu nebo s true odpovídá { block: "start", inline: "nearest" }; false změní block na "end".
V objektu voleb určují block a inline zarovnání na logické blokové a řádkové ose. Přijímají "start", "center", "end" nebo "nearest"; poslední možnost omezuje potřebný posun. behavior volí animaci ("smooth"), skok ("instant") nebo nastavení CSS scroll-behavior ("auto", výchozí hodnota). Výchozí container: "all" umožňuje posun všech posuvných nadřazených kontejnerů; container: "nearest" jej omezí na nejbližší z nich, pokud je volba podporována. To není totéž jako zarovnání "nearest".
Obě metody se volají na instanci Element. Patří k webové platformě, nikoli k ECMAScriptu 2024; před voláním ověř, že vyhledání prvku nevrátilo null. Podpora voleb i návratové hodnoty závisí na prohlížeči: scrollIntoView() může vrátit Promise, který se splní objektem s booleovskou vlastností interrupted. Pokud implementace vrací undefined, samotné await na konec posunu nečeká.
Pří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ýsledek
false true true
Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výpis v konzoli pro vývojáře. `spacer` nemá značku, zatímco `target` má `data-jump` s hodnotou `"false"`, takže posun vyvolá jen `target`. Třetí `true` znamená, že se `scrollTop` panelu zvýšil; nejde o návratovou hodnotu `scrollIntoView()`.
Související lekce
- JavaScript · Lekce 37 · Pokročilá · Verze: 4