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

CKTIS / CSS

:fullscreen — element v celozaslonskem stanju

Psevdorazred :fullscreen izbere elemente, ki so v celozaslonskem stanju. Omogoča spreminjanje njihovega videza med celozaslonskim prikazom, vendar tega načina ne vklopi sam.

Različica: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaksa

:fullscreen { /* declarations */ }
E:fullscreen { /* declarations */ }

:fullscreen je psevdorazred brez argumentov. E:fullscreen izbere element vrste E v celozaslonskem stanju; samostojni :fullscreen vrste elementa ne omejuje. Pravilo CSS se odziva na stanje — celozaslonskega načina ne vklopi.

Fullscreen API določa ujemanje na podlagi nastavljene zastavice za celozaslonski način. Ujema se lahko tudi gostitelj Shadow DOM, če preusmeritev celozaslonskega cilja glede na tega gostitelja vrne samega gostitelja. Zato se lahko z :fullscreen hkrati ujema več elementov, medtem ko document.fullscreenElement označuje najvišji celozaslonski element, izpostavljen v tem kontekstu.

To ni preverjanje velikosti: zapolnitev okna s CSS ne nastavi zastavice za celozaslonski način. Potomci se ne ujemajo samodejno zgolj zato, ker so znotraj elementa, ki se ujema. #panel:fullscreen oblikuje ploščo, #panel:fullscreen p pa v tem stanju oblikuje njene odstavke.

Primer po kliku pokliče requestFullscreen(), obravnava zavrnitev in po dogodku fullscreenchange posodobi rezultat. Za prehod v celozaslonski način je potrebno dovoljenje za uporabo funkcije. Pogoj za aktivacijo je izpolnjen, če je začasna aktivacija uporabnika še veljavna ali če algoritem sproži sprememba usmerjenosti, ki jo povzroči uporabnik. Okolje lahko zahtevo zavrne. Pričakovani rezultat opisuje uspešen vstop in izhod, ne pa zagotovljene razpoložljivosti API-ja.

Primeri

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:fullscreen demo</title>
<style>
  #panel { padding: 24px; background: white; color: black; }
  #panel:fullscreen { background: navy; color: white; }
</style>
<section id="panel">
  <button id="toggle" type="button">Toggle fullscreen</button>
  <p id="status" role="status">fullscreen: false</p>
</section>
<script>
  const panel = document.querySelector('#panel');
  const status = document.querySelector('#status');
  document.querySelector('#toggle').addEventListener('click', async () => {
    try {
      if (document.fullscreenElement) {
        await document.exitFullscreen();
      } else {
        await panel.requestFullscreen();
      }
    } catch {
      status.textContent = 'Fullscreen request failed';
    }
  });
  document.addEventListener('fullscreenchange', () => {
    status.textContent = `fullscreen: ${panel.matches(':fullscreen')}`;
  });
</script>
</html>

Rezultat

Initially: fullscreen: false
After successful entry: fullscreen: true; navy background and white text.
After exit: fullscreen: false; white background and black text.
If a request is rejected: Fullscreen request failed

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

Viri