База знанияИзпитен център
BGБългарски
Избери език13

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

Източници