Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła