Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:fullscreen — element w trybie pełnoekranowym

Pseudoklasa :fullscreen wybiera elementy znajdujące się w stanie pełnoekranowym. Umożliwia zmianę ich wyglądu podczas prezentacji pełnoekranowej, ale sama nie uruchamia tego trybu.

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

Składnia

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

:fullscreen to pseudoklasa bez argumentów. Zapis E:fullscreen wybiera element typu E w stanie pełnoekranowym; samo :fullscreen nie ogranicza typu elementu. Reguła CSS reaguje na stan — nie włącza pełnego ekranu.

Fullscreen API definiuje dopasowanie przez ustawioną flagę pełnego ekranu. Dopasowany może być również gospodarz Shadow DOM, jeśli przekierowanie celu pełnoekranowego na tego gospodarza daje właśnie jego. Kilka elementów może więc jednocześnie pasować do :fullscreen, podczas gdy document.fullscreenElement wskazuje najwyższy element pełnoekranowy widoczny w danym kontekście.

Nie jest to test rozmiaru: wypełnienie okna za pomocą CSS nie ustawia flagi pełnego ekranu. Potomkowie nie pasują automatycznie tylko dlatego, że znajdują się wewnątrz dopasowanego elementu. #panel:fullscreen styluje panel, a #panel:fullscreen p — jego akapity w tym stanie.

Przykład wywołuje requestFullscreen() po kliknięciu, obsługuje odrzucenie żądania i aktualizuje wynik po fullscreenchange. Wejście w tryb pełnoekranowy wymaga zezwolenia na użycie tej funkcji. Warunek aktywacji jest spełniony, jeśli występuje przejściowa aktywacja użytkownika lub jeśli algorytm uruchamia zmiana orientacji spowodowana przez użytkownika. Środowisko może odrzucić żądanie. Oczekiwany wynik dotyczy udanego wejścia i wyjścia, a nie gwarancji dostępności API.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła