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