Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.hasAttribute() i Element.scrollIntoView()

Sprawdź, czy element ma dany atrybut, i użyj wyniku, aby zdecydować o przewinięciu do elementu. Odróżnij obecność atrybutu od jego wartości, a przewijanie od ustawiania fokusu.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

element.hasAttribute(name)
element.scrollIntoView()
element.scrollIntoView(alignToTop)
element.scrollIntoView(options)

element.hasAttribute(name) zwraca true, jeśli element w chwili wywołania ma atrybut o podanej nazwie, a w przeciwnym razie false. Zarówno pusty ciąg, jak i ciąg "false" oznaczają, że atrybut jest obecny. Użyj getAttribute(name), aby odczytać wartość (lub otrzymać null, gdy atrybutu nie ma), a hasAttributeNS(namespace, localName), aby sprawdzić obecność według przestrzeni nazw i nazwy lokalnej. Atrybut logiczny HTML, np. disabled, oznacza prawdę przez samą obecność; "false" nie jest dla niego poprawną wartością i go nie wyłącza.

element.scrollIntoView() przewija w razie potrzeby przewijalne kontenery nadrzędne, w tym obszar widoku przeglądarki, aby pokazać element. Nie ustawia fokusu ani nie sprawia, że element bez ramki układu, np. z display: none, zaczyna się wyświetlać. Bez argumentu oraz z true wywołanie odpowiada opcjom { block: "start", inline: "nearest" }; false zmienia block na "end".

W obiekcie opcji block i inline określają wyrównanie na logicznej osi blokowej i tekstowej. Przyjmują "start", "center", "end" lub "nearest"; ostatnia opcja ogranicza potrzebne przesunięcie. behavior wybiera animację ("smooth"), skok ("instant") lub zachowanie wynikające z CSS scroll-behavior ("auto", domyślnie). Domyślne container: "all" dopuszcza przewijanie wszystkich przewijalnych kontenerów nadrzędnych; container: "nearest" ogranicza je do najbliższego, jeśli przeglądarka obsługuje tę opcję. To nie to samo co wyrównanie "nearest".

Obie metody wywołuje się na instancji Element. Należą one do platformy webowej, a nie do ECMAScript 2024; przed wywołaniem sprawdź, czy wyszukiwanie elementu nie zwróciło null. Obsługa opcji i wartości zwracanej zależy od przeglądarki: scrollIntoView() może zwrócić Promise rozwiązywany do obiektu z logicznym polem interrupted. W implementacjach zwracających undefined samo await nie czeka na koniec przewijania.

Przykłady

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

Wynik

false
true
true

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź komunikaty w konsoli. `spacer` nie ma znacznika, a `target` ma `data-jump` o wartości `"false"`, więc tylko `target` wywołuje przewijanie. Trzecie `true` oznacza wzrost `scrollTop` panelu, a nie wynik `scrollIntoView()`.

Powiązane lekcje

  • JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4

Źródła