База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

:fullscreen — елемент в състояние на цял екран

Псевдокласът :fullscreen избира елементи, които са в състояние на цял екран. Той позволява да промените изгледа им при показване на цял екран, но сам не активира този режим.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

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

:fullscreen е псевдоклас без аргументи. E:fullscreen избира елемент от тип E в състояние на цял екран; самостоятелното :fullscreen не ограничава типа на елемента. CSS правилото реагира на състояние — не активира режима на цял екран.

Fullscreen API определя съвпадението чрез зададен флаг за цял екран. Може да съвпадне и хост на Shadow DOM, ако пренасочването на целта за цял екран спрямо този хост връща самия хост. Следователно няколко елемента могат едновременно да съвпадат с :fullscreen, докато document.fullscreenElement обозначава най-горния елемент на цял екран, достъпен в този контекст.

Това не е проверка на размера: запълването на прозореца с CSS не задава флага за цял екран. Наследниците не съвпадат автоматично само защото се намират вътре в съвпадащ елемент. #panel:fullscreen стилизира панела, а #panel:fullscreen p стилизира абзаците му в това състояние.

Примерът извиква requestFullscreen() след щракване, обработва отказ и актуализира резултата след fullscreenchange. За преминаване в режим на цял екран е необходимо разрешение за използване на функцията. Условието за активация е изпълнено, ако има временна потребителска активация или ако промяна в ориентацията, предизвикана от потребителя, задейства алгоритъма. Средата може да отхвърли заявката. Очакваният резултат описва успешно влизане и излизане, а не гарантирана наличност на API.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници