Что такое «Полноэкранный режим»

Пользователь включает полноэкранный режим сам — клавишей F11 в настольном браузере или кнопкой разворота у видеоплеера. Сайт тоже может попросить об этом через Fullscreen API, но только в ответ на действие человека: клик или нажатие клавиши. Вызов из таймера или сразу при загрузке браузер отклонит. Так он защищается от страниц, которые пытаются закрыть собой интерфейс системы и выдать поддельное окно за настоящее.

Fullscreen API: пример на JavaScript

const gallery = document.querySelector('.gallery');
const button = document.querySelector('.gallery__expand');

button.addEventListener('click', () => {
  if (document.fullscreenElement) {
    document.exitFullscreen();
  } else {
    gallery.requestFullscreen().catch(() => { /* браузер отказал */ });
  }
});

Метод requestFullscreen() возвращает промис, который отклоняется, если браузер отказал. Свойство document.fullscreenElement показывает, какой элемент сейчас развёрнут, а событие fullscreenchange срабатывает при входе и выходе — в том числе когда пользователь нажал Escape.

Оформление в CSS

Развёрнутый элемент стилизуют псевдоклассом :fullscreen — например, убирают скругления и растягивают фото по высоте экрана. Под ним браузер рисует подложку ::backdrop, обычно чёрную. Элемент получает размеры всего экрана, поэтому вёрстка внутри должна быть готова к любым пропорциям — от вытянутого телефона до широкого монитора.

Ограничения, о которых стоит знать

  • Выход всегда за пользователем. Escape или системный жест закрывает режим, перехватить это нельзя. Логику строят на событии fullscreenchange, а не на собственной кнопке.
  • iPhone. В Safari на iPhone поддержка ограничена: надёжно на весь экран разворачивается видео во встроенном плеере, а произвольные элементы — нет. Для галерей проще имитировать режим блоком с position: fixed на весь экран.
  • Фреймы. Плеер во встроенном iframe развернётся, только если у фрейма есть разрешение — атрибут allow="fullscreen" или старый allowfullscreen.
  • Веб-приложения. Для PWA запуск без интерфейса браузера задают в манифесте значением "display": "fullscreen".

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «Frontend» ↗