Назад в Центр знаний
Отпечатки

Screen Orientation API и адаптивные интерфейсы

Используйте смену ориентации как состояние адаптивной верстки, сохраняя доступность, выбор пользователя и приватность.

BotBrowser Team

Документация

Нужна структурированная документация по теме Отпечатки?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

Спецификация W3C Screen Orientation и MDN описывают данные, которые браузер может предоставить; BotBrowser может подавать управляемые входы ориентации для поддерживаемых профилей, но не гарантирует физический поворот или блокировку на каждом хосте. Сопоставьте матрицу с проверками доступности событий указателя и валидацией свойств viewport, чтобы оценивать восстановление задачи, а не метку устройства.

Смена ориентации меняет макет, сохраняя фокус, элементы управления и восстановление.

Кратко

  • Для перестройки используйте CSS и container queries; lock() могут отклонить.
  • Сохраняйте фокус, данные, порядок чтения и восстановление.
  • Проверяйте масштаб, клавиатуру, специальные возможности и промежуточную ширину.

Содержание

Считайте ориентацию состоянием макета

screen.orientation.type описывает категории portrait-primary и landscape-primary, а angle показывает угол относительно естественной ориентации. Во время поворота оба значения могут измениться, а порядок событий зависит от браузера и ОС. Дождитесь стабилизации области просмотра вместо предположения, что одно событие описывает весь переход.

Большинство решений о макете относится к CSS. Медиазапрос (orientation: portrait) может сменить сетку, а container queries позволяют компоненту реагировать на собственную ширину в разделённом окне или встроенном документе. JavaScript может использовать matchMedia или объект ориентации для конкретного поведения, например изменения размера canvas. Условие должно быть связано с видимым результатом, а не с каталогом устройств.

Ориентация не говорит, используется ли телефон, планшет, компьютер или удалённый сеанс. Панели браузера, управление окнами, масштаб, специальные возможности и виртуальная клавиатура меняют фактическое место. Узкое окно на компьютере остаётся допустимым состоянием. Не выводите из ориентации личность, местоположение, возраст или возможности человека. Смежный сигнал разобран в материале API раскладки клавиатуры, локаль и конфиденциальность.

Сохраняйте задачу при повороте

Поворот происходит во время чтения, редактирования или заполнения формы. Сохраняйте введённые данные, полезную позицию прокрутки, выбранную вкладку и фокус. Не пересоздавайте страницу и не переходите на другой экран из-за поворота. Если компонент всё же нужно пересоздать, явно восстановите фокус и объявляйте только важное изменение.

Используйте гибкие колонки, переносимые подписи, адаптивные изображения и точки перехода, выбранные содержимым. Двухколоночная форма может стать одноколоночной; широкая таблица может показать приоритетные столбцы и доступный с клавиатуры просмотр остальных. Скрытый в портретном режиме элемент должен иметь равнозначное действие. Критическая операция не должна зависеть от жеста в одном направлении.

Виртуальная клавиатура, панель браузера или разделитель окна могут закрыть содержимое. Держите активное поле видимым, не размещайте основную кнопку под перекрытием и заново размещайте диалог при изменении визуальной области. Спецификация CSSOM View задаёт понятия геометрии, но за рабочий результат отвечает приложение.

Запрашивайте ориентацию только по необходимости

screen.orientation.lock() является запросом, а не универсальной командой. Видимость документа, контекст, активация пользователя, полноэкранный режим и политика платформы задают ограничения. Обещание может быть отклонено. Страница должна работать и без блокировки.

Игре, предпросмотру камеры или презентации иногда нужен стабильный формат. До запроса объясните эффект, дайте заметный выход и снимите блокировку после завершения. Не блокируйте ориентацию ради упрощения настольного макета, классификации посетителя или запрета адаптации.

Режим, меняющий весь экран, должен начинаться с явного действия пользователя. Открытая по ссылке страница не должна неожиданно поворачиваться или запирать человека. При отказе браузера покажите обычный адаптивный макет и сохраните задачу. Отказ является результатом совместимости, а не сведением об устройстве.

Обрабатывайте события без гонок

Объект ориентации предоставляет событие change. Обработчик читает текущее состояние, меняет только нужный компонент и терпит повторные уведомления. При зависимости от фактического места добавляйте resize или наблюдение визуальной области; это связанные, но разные изменения.

Избегайте дорогой синхронной работы. Планируйте ограниченное обновление, отменяйте устаревшую работу и сохраняйте отзывчивость ввода. Для медиа, карты или canvas сохраняйте смысловое содержимое, меняя размеры отображения. Ошибка перерисовки должна оставить рабочую альтернативу, а не пустую область.

Защищайте необязательное поведение проверкой возможностей, проверяйте нужный метод и перехватывайте отклонение lock(). CSS-медиазапросы и resize подходят для отката. Не начинайте скрытый сбор ориентации, угла, viewport и экрана при отсутствии API.

Сохраняйте доступность и контроль

Адаптивная перестройка должна сохранять семантические заголовки, области, подписи и порядок чтения. После поворота проверяйте клавиатуру и фокус, включая край визуальной области. Скринридеру нужен полезный статус, когда элементы действительно переместились, а не необработанный угол каждого поворота.

Учитывайте масштаб, увеличение текста, уменьшение движения, высокий контраст и принудительные цвета. Макет, работающий при обычном масштабе, может сломаться при увеличенном тексте или открытой клавиатуре. Сохраняйте размеры целей, контраст и сообщения ошибок. WCAG 2.2 помогает проверять результат; сама ориентация не определяет соответствие.

У режима, зависящего от ориентации, должен быть видимый выход, доступный с клавиатуры и не стирающий работу. Объясняйте, когда вращением управляет браузер или ОС, а приложение лишь просит предпочтение. Отказ не следует выдавать за ошибочную настройку пользователя.

Проверяйте поведение, а не типы устройств

Составьте матрицу для портретного и альбомного режима, узких и широких окон, увеличенного текста, виртуальной клавиатуры, клавиатурного и сенсорного ввода, уменьшения движения и браузера без API. Проверяйте чтение, основное действие, восстановление после ошибки и выход из заблокированного режима. Добавьте промежуточную ширину, где чаще всего ломается перенос, например 360, 768 и 1024 CSS-пикселя.

Записывайте версию браузера, viewport, ориентацию и настройки как конфигурацию теста. Снимок экрана доказывает только эту конфигурацию, а не постоянное свойство человека. Используйте синтетические данные и не отправляйте историю ориентации в аналитику. При необходимости телеметрии выбирайте агрегированный результат, а не набор углов, размеров и времени. Храните window.orientation, screen.orientation.type и innerWidth/innerHeight в журнале прогона, а не в записи о пользователе.

При изменении поддержки браузера или запроса блокировки выполняйте проверку совместимости. Сверьтесь с публичной спецификацией и актуальными заметками MDN, затем проверьте путь отката в браузере, где метод отсутствует или отклоняется. Оставляйте функцию необязательной и указывайте, какое действие её запускает. В справке для посетителей описывайте видимое поведение и диапазон поддержки, не обещая одинаковый порядок событий на всех платформах. Отказ screen.orientation.lock('landscape') с NotSupportedError является обычным результатом на настольных системах, и страница обязана по-прежнему отображаться и оставаться рабочей.

Определите приватный адаптивный контракт

До чтения свойства запишите поддерживаемое решение, например размещение предпросмотра рядом с элементами управления при достаточной ширине компонента. Предпочитайте CSS и локальный matchMedia, как в matchMedia('(min-width: 768px)').matches. Если сервису действительно нужен результат для улучшения продукта, укажите цель, срок хранения, доступ и выбор пользователя, удалив лишние поля.

Ориентация вместе с другими значениями может участвовать в отпечатке, но адаптивной верстке не нужен такой профиль. Не используйте портретный или альбомный результат как сигнал аккаунта, риска или права доступа. Общий компьютер, повёрнутый монитор, эмулятор и изменённое окно дадут одинаковое значение. Отсутствующее или грубое значение нормально. Когда приходит событие поворота, читайте screen.orientation.angle только в том обработчике, которому оно нужно, и не кэшируйте его в долгоживущем объекте сессии.

Сделайте контракт явным для всех языков и продуктов: браузер может предоставить ориентацию, приложение может изменить подачу, а блокировка может быть недоступна или отклонена. Это разные утверждения. Не превращайте условную возможность в гарантию в документации, интерфейсе или переводе. Когда человек выбирает режим, записывайте это как продуктовое предпочтение, а не как выведенные аппаратные данные.

Визуальную область проверяйте отдельно от ориентации. Поворот меняет область макета, а затем панель браузера или клавиатура могут уменьшить видимую площадь. Отмерьте место, нужное сфокусированному элементу, и выведите его в видимую область, не меняя смысл документа. Фиксированный подвал, который помещается после поворота, может скрыться при открытии клавиатуры. Добавьте фиксированному элементу env(safe-area-inset-bottom) и задайте контейнеру прокрутки 100dvh вместо 100vh, чтобы изменения панели и клавиатуры не выталкивали элементы за экран. Безопасные отступы и временные перекрытия относятся к рендеру, а не к постоянным свойствам устройства; это же верно для складных экранов, разделённых окон, удалённых сессий и окон, изменённых без физического поворота.

Для каждого состояния определите результат, например открытие и закрытие меню с сохранением фокуса или доступность субтитров и основной кнопки после изменения размера предпросмотра. Такие результаты лучше списка моделей, помогают пересматривать совместимость и описывают сбои, не собирая подробный профиль окружения. Когда браузер меняет деталь реализации, прогоните матрицу результатов заново и правьте описание поддержки в справке только при изменении видимого поведения.

В аналитике и экспериментах измеряйте результат задачи, а не профиль из угла, размеров и времени. Назначение эксперимента должно быть независимо от запроса блокировки, чтобы отказ не лишал базового интерфейса.

При добавлении функции, зависящей от ориентации, пересмотрите контракт, удалите свойства без видимого решения и сохраните условные формулировки и доступный откат во всех переводах.

Доступный откат является частью функции, а не экраном ошибки: сохраняйте те же заголовки, подписи и данные задачи, чтобы человек мог продолжить в портретном режиме после запроса альбомного или в изменённом окне после выхода из полноэкранного режима. Для встроенных инструментов это тоже критерий приёмки: компонент должен показывать свои элементы управления, даже когда контейнер не даёт ожидаемого соотношения сторон. Оставляйте в откате восстановление после ошибки, сообщение о состоянии, сохранённый черновик и следующий шаг, чтобы NotSupportedError от запроса блокировки не превращался в тупик, и объявляйте изменение через aria-live="polite", не перемещая фокус.

Выбор ориентации должен быть обратимым. Храните явное предпочтение отдельно от наблюдений браузера, дайте сброс и не превращайте выбор в вывод об устройстве. При следующем визите заново оцените доступное пространство и позвольте сменить подачу, не теряя место в задаче.

Практический список

  • Для обычной перестройки используйте CSS или container queries, а JavaScript оставляйте для ограниченного поведения.
  • При повороте сохраняйте значения форм, фокус, порядок чтения и восстановление.
  • Запрашивайте блокировку после действия пользователя и обрабатывайте отказ адаптивным откатом.
  • Проверяйте масштаб, клавиатуру, специальные возможности и промежуточные ширины в обоих направлениях.
  • Оставляйте измерения локальными, если нет документированного добровольного решения продукта.

Планируйте переходы и восстановление

Поворот может совпасть с навигацией, запросом или ошибкой проверки. Держите состояния раздельно и не отправляйте форму дважды. Медиа, canvas и встроенные компоненты должны сохранять содержимое, субтитры и фокус; при нехватке места нужна читаемая альтернатива. URL и история не должны меняться из-за ориентации. Серверный рендер может начать с консервативного макета, а клиент уточнить viewport без удаления текста. Для панелей и iframe используйте container queries. Анимации должны прерываться и уважать настройку уменьшения движения. Документируйте проверенные браузеры и откат, не обещая одинаковый порядок событий. При диагностике записывайте видимый результат и конфигурацию, а не постоянный список экрана.

BotBrowser позволяет задавать ориентацию мобильных профилей для API ориентации и CSS media queries; профили Android также предоставляют события движения и ориентации. BotBrowser не гарантирует блокировку ориентации или физический поворот на всех хостах.

Источники

Для интерфейса на нескольких экранах границы Window Management API отделяют разрешение и топологию от ориентации и сохраняют путь одного окна.

Практический итог

Считайте ориентацию временным состоянием, запрашивайте блокировку после действия и делайте отказ безопасным. BotBrowser задаёт ориентацию профиля для тестов; приложение отвечает за доступность и приватность.

Часто задаваемые вопросы

Является ли ориентация идентификатором устройства?

Нет; её меняют окно, масштаб, разделение и поворот.

Нужно ли каждой странице блокировать ориентацию?

Нет; только задачам со стабильным форматом и с доступным выходом.

Что проверять после поворота?

Читаемость, фокус, основное действие, данные и выход из режима.

#Screen Orientation API#Адаптивный Дизайн#Доступность#Мобильный Веб

Эта статья входит в руководство: Что такое отпечаток браузера?

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.