CKTIS / JavaScript
Element.hasAttribute() и Element.scrollIntoView()
Провери дали даден елемент има определен атрибут и реши дали да превъртиш до него. Разграничи наличието на атрибута от стойността му, а превъртането — от задаването на фокус.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
element.hasAttribute(name)
element.scrollIntoView()
element.scrollIntoView(alignToTop)
element.scrollIntoView(options)element.hasAttribute(name) връща true, ако посоченият атрибут е налице в момента на извикването, и false в противен случай. И празният низ, и низът "false" означават, че атрибутът е налице. Използвай getAttribute(name), за да прочетеш стойността (null, ако атрибутът липсва), и hasAttributeNS(namespace, localName) за проверка по пространство от имена и локално име. При булев атрибут на HTML като disabled самото наличие означава истина; "false" не е допустима стойност и не го изключва.
element.scrollIntoView() при нужда превърта подлежащите на превъртане контейнери предшественици, включително видимата област на браузъра, за да покаже елемента. Методът не задава фокус и не кара елемент без кутия в оформлението, например с display: none, да се визуализира. Извикването без аргумент или с true съответства на { block: "start", inline: "nearest" }; false променя block на "end".
В обекта с настройки block и inline определят подравняването по логическата блокова ос и оста по реда. Приемат "start", "center", "end" или "nearest"; последната настройка ограничава необходимото преместване. behavior избира анимация ("smooth"), незабавен скок ("instant") или настройката на CSS scroll-behavior ("auto", по подразбиране). Настройката по подразбиране container: "all" позволява превъртане на всички подходящи предшественици; container: "nearest" го ограничава до най-близкия, ако се поддържа. Това е различно от подравняването "nearest".
Двата метода се извикват върху екземпляр на Element. Те са част от уеб платформата, а не от ECMAScript 2024. Преди извикване провери дали търсенето на елемента не е върнало null. Поддръжката на настройките и връщаната стойност зависи от браузъра: scrollIntoView() може да върне Promise, който се изпълнява с обект с булево свойство interrupted. Ако реализацията връща undefined, само await не изчаква края на превъртането.
Примери
<!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>Резултат
false true true
Запази примера като HTML файл, отвори го в браузър и провери изведените стойности в конзолата за разработчици. `spacer` няма маркер, а `target` има `data-jump` със стойност `"false"`, така че само `target` задейства превъртане. Третото `true` показва, че `scrollTop` на панела се е увеличило; това не е стойността, върната от `scrollIntoView()`.
Свързани уроци
- JavaScript · Урок 37 · Напреднало · Версия: 4