Экран
Базовая поддержка Широко поддерживается *
Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Интерфейс Screen представляет экран, обычно тот, на котором отображается текущее окно, и его можно получить с помощью window.screen.
Обратите внимание, что браузеры определяют, какой экран следует отправить как текущий, обнаруживая, на каком экране находится центр окна браузера.
Свойства экземпляра
Также наследует свойства от своего родителя EventTarget.
Screen.availHeight-
Указывает высоту экрана в пикселях, за вычетом постоянных или полупостоянных элементов пользовательского интерфейса, отображаемых операционной системой, таких как панель задач в Windows.
Screen.availWidth-
Возвращает количество доступного горизонтального пространства в пикселях для окна.
Screen.colorDepth-
Возвращает глубину цвета экрана.
Screen.height-
Возвращает высоту экрана в пикселях.
-
Screen.isExtendedЭкспериментальный Безопасный контекст -
Возвращает
trueесли у устройства пользователя несколько экранов, иfalseесли нет. Screen.orientation-
Возвращает экземпляр
ScreenOrientation, связанный с этим экраном. Screen.pixelDepth-
Получает глубину бита экрана.
Screen.width-
Возвращает ширину экрана.
-
Screen.mozEnabledНестандартный Устаревший -
Булево значение. Установка в значение false выключит экран устройства.
-
Screen.mozBrightnessНестандартный Устаревший -
Управляет яркостью экрана устройства. Ожидается значение типа double в диапазоне от 0 до 1.0.
Нестандартные свойства
Следующие свойства определены как часть API управления окнами, что делает их доступными для интерфейса ScreenDetailed; здесь мы выбрали их документировать. Однако нестандартные версии этих свойств доступны для интерфейса Screen в браузерах, которые не поддерживают этот API. Подробности о нестандартной поддержке см. в таблице «Совместимость браузеров» на этой странице.
-
Screen.availLeftТолько чтение Нестандартный Безопасный контекст -
Число, представляющее координату x (левый край) доступной области экрана.
-
Screen.availTopТолько чтение Нестандартный Безопасный контекст -
Число, представляющее координату y (верхний край) доступной области экрана.
-
Screen.leftТолько чтение Нестандартный Безопасный контекст -
Число, представляющее координату x (левый край) всей области экрана.
-
Screen.topТолько чтение Нестандартный Устаревший Безопасный контекст -
Число, представляющее координату y (верхний край) всей области экрана.
Методы экземпляра
Также наследует методы от своего родителя EventTarget.
-
Screen.lockOrientationУстаревший -
Заблокировать ориентацию экрана (работает только в полноэкранном режиме или для установленных приложений)
-
Screen.unlockOrientationУстаревший -
Разблокировать ориентацию экрана (работает только в полноэкранном режиме или для установленных приложений)
События
-
changeЭкспериментальный Безопасный контекст -
Срабатывает на определенном экране при изменении его свойств — ширины или высоты, доступной ширины или высоты, глубины цвета или ориентации.
-
orientationchangeУстаревший Нестандартный -
Срабатывает при изменении ориентации экрана.
Примеры
if (screen.colorDepth < 8) {
// use low-color version of page
} else {
// use regular, colorful page
}
Спецификации
| Спецификация |
|---|
| CSSOM View Модуль # the-screen-interface |
Совместимость браузеров
| Настольные | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
Screen |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
availHeight |
1 | 12Всегда отражает главный экран. |
1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
availLeft |
1 | 79 | 1 | 15 | 1 | 18 | 4 | 14 | 1 | 1.0 | 4.4 |
availTop |
1 | 79 | 1 | 15 | 1 | 18 | 4 | 14 | 1 | 1.0 | 4.4 |
availWidth |
1 | 12Всегда отражает главный экран. |
1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
change_event |
100 | 100 | Нет | 86 | Нет | 100 | Нет | 69 | Нет | 19.0 | 100 |
colorDepth |
1Начиная с версии 59 это свойство больше не обязано всегда возвращать 24. |
12 | 1 | ≤12.1 | 1 | 18Начиная с версии 59 это свойство больше не обязано всегда возвращать 24. |
4 | ≤12.1 | 1 | 1.0Начиная с Samsung Internet 7.0 это свойство больше не обязано всегда возвращать 24. |
4.4Начиная с версии 59 это свойство больше не обязано всегда возвращать 24. |
height |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
isExtended |
100 | 100 | Нет | 86 | Нет | 100 | Нет | 69 | Нет | 19.0 | 100 |
left |
Нет | Нет | 1 | Нет | Нет | Нет | 4 | Нет | Нет | Нет | Нет |
lockOrientation |
Нет | 12–79 | 14 | Нет | Нет | Нет | 14 | Нет | Нет | Нет | Нет |
mozBrightness |
Нет | Нет | 12 | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
mozEnabled |
Нет | Нет | 12 | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
orientation |
38 | 7912Edge не возвращает объектOrientation; вместо этого он возвращает тип ориентации как строку. |
4314 | 25 | 16.4 | 39 | 4314 | 26 | 16.4 | 4.0 | 39 |
orientationchange_event |
Нет | 12–79 | Нет | Нет | Нет | Нет | 14 | Нет | Нет | Нет | Нет |
pixelDepth |
1Начиная с версии 59 это свойство больше не обязано всегда возвращать 24. |
12 | 1 | ≤12.1 | 1 | 18Начиная с версии 59 это свойство больше не обязано всегда возвращать 24. |
4 | ≤12.1 | 1 | 1.0Начиная с Samsung Internet 7.0 это свойство больше не обязано всегда возвращать 24. |
4.4Начиная с версии 59 это свойство больше не обязано всегда возвращать 24. |
top |
Нет | Нет | 1 | Нет | Нет | Нет | 4 | Нет | Нет | Нет | Нет |
unlockOrientation |
Нет | 12–79 | 14 | Нет | Нет | Нет | 14 | Нет | Нет | Нет | Нет |
width |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
© 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/Screen
