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 задаёт ориентацию профиля для тестов; приложение отвечает за доступность и приватность.
Часто задаваемые вопросы
Является ли ориентация идентификатором устройства?
Нет; её меняют окно, масштаб, разделение и поворот.
Нужно ли каждой странице блокировать ориентацию?
Нет; только задачам со стабильным форматом и с доступным выходом.
Что проверять после поворота?
Читаемость, фокус, основное действие, данные и выход из режима.
Эта статья входит в руководство: Что такое отпечаток браузера?
Похожие статьи
Свойства экрана и viewport для адаптивного дизайна
ОтпечаткиСобытия viewport на мобильных: порядок, объединение, разметка
ПлатформаСобытия указателя и доступный ввод: мышь, сенсорный экран и перо
ОтпечаткиОтпечаток экрана и окна: свойства отображения
ОтпечаткиKeyboard Layout API, локаль и конфиденциальность
ПлатформаWindow Management API: границы нескольких экранов
Выполните ту же проверку в BotBrowser
Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.