Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Vyhledání prvku podle ID a změna stavu `hidden`

Vyhledejte prvek HTML podle přesného identifikátoru, ošetřete chybějící výsledek a pomocí `hidden` změňte atribut, aniž byste prvek odebrali z DOM.

Verze: Current web platform; runtime support varies

Syntaxe

// 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) vyhledává ve stromu dokumentu. Předejte přímo hodnotu identifikátoru bez předpony # používané v selektorech CSS; záleží na velikosti písmen. Metoda vrací první odpovídající Element v pořadí stromu, nebo null. Identifikátory mají být jedinečné. Dosud nevložený prvek metoda nenajde, skrytý prvek však ano.

Před přístupem k .hidden výsledek zkontrolujte: čtení nebo zápis vlastnosti na null vyvolá TypeError. Výsledkem může být i jiný než HTML prvek, například prvek SVG; instanceof HTMLElement ověřuje typ ve stejném globálním prostředí. Jde o API webové platformy, nikoli o funkce ECMAScriptu 2024. Samostatná vlastnost document.hidden je jen pro čtení a vypovídá o viditelnosti dokumentu, nikoli prvku.

HTMLElement.hidden odráží atribut HTML hidden daného prvku. Přiřazením true nastavíte atribut s prázdnou hodnotou, přiřazením false ho odstraníte. Čtení vrací false, pokud atribut chybí, a true v běžném skrytém stavu; i setAttribute("hidden", "false") prvek skryje. Pokud je podporováno "until-found", můžete tento řetězec přiřadit i přečíst. Obsah pak může odhalit vyhledávání na stránce nebo přechod na fragment.

hidden neodebírá uzel a nechrání citlivá data. Odebrání atributu nezaručuje viditelnost: prvek může stále skrývat CSS nebo skrytý předek a vlastnost CSS display může běžné skrytí také přepsat.

Příklady

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

Výsledek

true
true true true
false false

Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a zkontrolujte výstup v konzoli pro vývojáře. Samostatný dokument odděluje příklad od aktuální stránky. Tři řádky ukazují, že před vložením není žádný výsledek, že i po skrytí lze najít stejný prvek a že přiřazení `false` odebere atribut.

Související lekce

  • JavaScript · Lekce 35 · Pokročilá · Verze: 4

Zdroje