Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Document.hidden — preverjanje vidnosti dokumenta

Document.hidden je lastnost samo za branje, ki pove, ali brskalnik dokument obravnava kot skrit. Spremembe spremljaj z dogodkom visibilitychange.

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

Sintaksa

document.hidden

Document.hidden, prebran kot document.hidden, vrne true, kadar velja document.visibilityState === "hidden"; sicer vrne false. Branje te lastnosti strani ne skrije.

Vidnost določi brskalnik, pri čemer med drugim upošteva zavihek v ozadju ali pomanjšano okno. Te lastnosti ne zamenjuj z HTMLElement.hidden, ki upravlja skrito stanje elementa.

Na objektu document poslušaj dogodek visibilitychange in lastnost znova preberi. Primer prikaže začetno stanje vidnosti trenutne strani v odstavku status in ta odstavek posodobi ob vsaki spremembi vidnosti. V konzolo izpiše samo vrednost hidden ločeno ustvarjenega dokumenta, ki ni povezan s trenutno stranjo. To je spletni API, opisan v HTML Standard, ne funkcija ECMAScript; prisotnost Node 24 ne potrjuje njegove razpoložljivosti.

Primeri

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

Rezultat

Detached document.hidden: true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri