ScreenOrientation
Базовая версия 2023 *
Новое
С марта 2023 года эта функция работает на последних версиях устройств и браузеров. Возможно, эта функция не будет работать на более старых устройствах или браузерах.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Интерфейс ScreenOrientation API ориентации экрана предоставляет информацию о текущей ориентации документа.
Объект экземпляра ScreenOrientation можно получить, используя свойство screen.orientation.
Свойства экземпляра
-
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. |
25Всегда выбрасываетNotSupportedError. |
Нет | 38 |
79–97API существует, но возвращаетNS_ERROR_UNEXPECTED. |
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. |
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