Spec-Zone.ru › Web APIs

ScreenOrientation

Базовая версия 2023 *
Новое

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

* Некоторые части этой функции могут иметь различный уровень поддержки.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Интерфейс ScreenOrientation API ориентации экрана предоставляет информацию о текущей ориентации документа.

Объект экземпляра ScreenOrientation можно получить, используя свойство screen.orientation.

EventTarget ScreenOrientation

Свойства экземпляра

ScreenOrientation.type Только для чтения

Возвращает текущий тип ориентации документа, один из portrait-primary, portrait-secondary, landscape-primary, или landscape-secondary.

ScreenOrientation.angle Только для чтения

Возвращает текущий угол ориентации документа.

Методы экземпляра

ScreenOrientation.lock()

Запирает ориентацию содержащего документа на его значение по умолчанию и возвращает Promise.

ScreenOrientation.unlock()

Разблокирует ориентацию содержащего документа от его значения по умолчанию.

События

Прослушивайте эти события, используя addEventListener() или назначив обработчик событий свойству oneventname этого интерфейса.

change

Вызывается всякий раз, когда ориентация экрана изменяется.

Пример

В следующем примере мы прослушиваем событие изменения ориентации change и регистрируем новый тип ориентации экрана тип ориентации экрана и угол.

screen.orientation.addEventListener("change", (event) => {
  const type = event.target.type;
  const angle = event.target.angle;
  console.log(`ScreenOrientation change: ${type}, ${angle} degrees.`);
});

Спецификации

Спецификация
Ориентация экрана
# screenorientation-interface

Совместимость браузеров

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
ScreenOrientation 38 79 43 25 16.4 38 43 25 16.4 3.0 38
angle 38 79 43 25 16.4 38 43 25 16.4 3.0 38
change_event 38 79 43 25 16.4 38 43 25 16.4 3.0 38
lock
38Всегда выбрасывает NotSupportedError.
79Всегда выбрасывает NotSupportedError.
превью
43Всегда выбрасывает NotSupportedError.
97
25Всегда выбрасывает NotSupportedError.
Нет 38
79–97API существует, но возвращает NS_ERROR_UNEXPECTED.
43–79
25 Нет 3.0 38
type 38 79 43 25 16.4 38 43 25 16.4 3.0 38
unlock
38Всегда выбрасывает NotSupportedError.
79Всегда выбрасывает NotSupportedError.
43Всегда выбрасывает NotSupportedError.
25Всегда выбрасывает NotSupportedError.
Нет 38
79–97API существует, но возвращает NS_ERROR_UNEXPECTED.
43–79
25 Нет 3.0 38

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ScreenOrientation

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API