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

CKTIS / JavaScript

Document.hidden — zjištění viditelnosti dokumentu

Document.hidden je vlastnost pouze pro čtení, která udává, zda prohlížeč považuje dokument za skrytý. Změny lze sledovat pomocí visibilitychange.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

document.hidden

Document.hidden, čtené jako document.hidden, vrací true, když platí document.visibilityState === "hidden"; jinak vrací false. Samotné čtení stránku neskryje.

Viditelnost určuje prohlížeč a zohledňuje přitom mimo jiné kartu na pozadí nebo minimalizované okno. Nezaměňuj tuto vlastnost za HTMLElement.hidden, která řídí skrytý stav prvku.

Na objektu document naslouchej události visibilitychange a vlastnost znovu přečti. Příklad zobrazí počáteční stav viditelnosti aktuální stránky v odstavci status a při každé změně viditelnosti tento odstavec aktualizuje. Do konzole vypíše pouze hodnotu hidden samostatně vytvořeného dokumentu, který není připojen k aktuální stránce. Jde o webové API popsané v HTML Standard, nikoli o funkci ECMAScript; přítomnost Node 24 nedokládá jeho dostupnost.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.hidden</title>
</head>
<body>
  <h1>Document visibility</h1>
  <p id="status" role="status"></p>
  <script>
    const detached = document.implementation.createHTMLDocument('Detached example');
    console.log('Detached document.hidden: ' + detached.hidden);

    const status = document.getElementById('status');
    function showVisibility() {
      status.textContent = document.hidden ? 'This page is hidden.' : 'This page is visible.';
    }
    document.addEventListener('visibilitychange', showVisibility);
    showVisibility();
  </script>
</body>
</html>

Výsledek

Detached document.hidden: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje