CKTIS / JavaScript
Wyszukiwanie elementu po identyfikatorze i zmiana jego stanu `hidden`
Znajdź element HTML według dokładnej wartości `id`, obsłuż brak wyniku i użyj `hidden`, aby zmienić stan atrybutu bez usuwania elementu z DOM.
Wersja: Current web platform; runtime support varies
Składnia
// These are web platform APIs, not ECMAScript 2024 features.
const element = document.getElementById(id);
if (element instanceof HTMLElement) {
element.hidden = true; // Set the hidden attribute.
element.hidden = false; // Remove the hidden attribute.
}
// Hidden Until Found depends on the browser's HTML implementation:
// element.hidden = "until-found";document.getElementById(id) wyszukuje element w drzewie dokumentu. Podaj samą wartość id, bez prefiksu # używanego w selektorach CSS; wielkość liter ma znaczenie. Metoda zwraca pierwszy pasujący Element w kolejności drzewa albo null. Identyfikatory powinny być unikatowe. Element jeszcze niewstawiony do dokumentu nie zostanie znaleziony, ale element ukryty nadal można znaleźć.
Przed dostępem do .hidden sprawdź wynik: odczyt lub przypisanie właściwości na null powoduje TypeError. Wynik może być elementem innym niż HTML, na przykład SVG; instanceof HTMLElement sprawdza typ w tym samym środowisku globalnym. Są to interfejsy platformy webowej, a nie funkcje ECMAScript 2024. document.hidden to inna właściwość, tylko do odczytu, informująca o widoczności dokumentu, a nie elementu.
HTMLElement.hidden odzwierciedla atrybut HTML hidden danego elementu. Przypisanie true ustawia atrybut z pustą wartością, a false go usuwa. Odczyt zwraca false, gdy atrybutu nie ma, i true w zwykłym stanie ukrycia; nawet setAttribute("hidden", "false") ukrywa element. W przeglądarkach obsługujących stan "until-found" tę wartość można przypisać i odczytać jako ciąg znaków; wyszukiwanie na stronie lub nawigacja do fragmentu mogą wtedy ujawnić treść.
hidden nie usuwa węzła ani nie chroni poufnych danych. Usunięcie atrybutu nie gwarantuje widoczności: element może nadal być ukryty przez CSS lub przodka, a reguła CSS display może też nadpisać zwykły efekt ukrycia.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>getElementById and hidden</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument();
const panel = doc.createElement("section");
panel.id = "notice";
console.log(doc.getElementById("notice") === null);
doc.body.appendChild(panel);
const match = doc.getElementById("notice");
if (!(match instanceof HTMLElement)) {
throw new Error("Expected an HTML element with id notice");
}
match.hidden = true;
console.log(`${match.hidden} ${match.hasAttribute("hidden")} ${doc.getElementById("notice") === match}`);
match.hidden = false;
console.log(`${match.hidden} ${match.hasAttribute("hidden")}`);
})();
</script>
</body>
</html>Wynik
true true true true false false
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź komunikaty w konsoli deweloperskiej. Osobny dokument izoluje przykład od bieżącej strony. Trzy wiersze pokazują brak wyniku przed wstawieniem, możliwość znalezienia tego samego elementu po ukryciu oraz usunięcie atrybutu po przypisaniu `false`.
Powiązane lekcje
- JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4