Spec-Zone.ru › Web APIs

Свойство экрана: availHeight

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

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

Только для чтения Screen интерфейса availHeight свойство возвращает высоту, в пикселях CSS, доступного пространства для веб-контента на экране. Поскольку Screen экспонируется в свойстве Window интерфейса window.screen, вы получаете доступ к availHeight используя window.screen.availHeight.

Аналогично, вы можете использовать Screen.availWidth, чтобы получить количество пикселей, горизонтально доступных браузеру.

Значение

Числовое значение, указывающее высоту доступного пространства экрана в пикселях CSS. Оно не может быть больше значения window.screen.height и будет меньше, если устройство или пользовательский агент зарезервируют вертикальное пространство для себя.

Например, на Mac, у которого панель Dock расположена внизу экрана (по умолчанию), значение availHeight приблизительно равно значению height (общая высота экрана в пикселях CSS) минус высоты панели Dock и строки меню, как показано на диаграмме ниже. Они занимают availHeight только если всегда отображаются: если страница в полноэкранном режиме или панель Dock настроена на автоматическое скрытие/отображение, то они не учитываются в availHeight.

Diagram showing how Screen.availHeight relates to Screen.height and the screen's contents

Примеры

Если вашему веб-приложению нужно открыть новое окно, например, панель инструментов, содержащую несколько панелей, и вы хотите расположить его так, чтобы оно занимало всё доступное вертикальное пространство, вы можете сделать это с помощью кода, подобного представленному здесь.

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

const paletteWindow = window.open(
  "panels.html",
  "Panels",
  "left=0, top=0, width=200",
);

HTML окна панелей, в panels.html, содержит собственный JavaScript-код, который выполняется сразу после создания окна. Ему даже не нужно ждать какого-либо события (или вообще никакого события). Этот код обрабатывает изменение размера окна в соответствии с доступным пространством:

window.outerHeight = window.screen.availHeight;

Результат примерно такой. Обратите внимание, что окно Панелей занимает всё доступное вертикальное пространство слева на экране.

Screenshot of the example for Screen.availHeight

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

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

Спецификация
Модуль CSSOM View
# dom-screen-availheight

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
availHeight 1
12Всегда отражает основной экран.
1 ≤12.1 1 18 4 ≤12.1 1 1.0 4.4

См. также

  • Window
  • Screen
  • Screen.availWidth
  • Window.innerHeight

© 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/availHeight

Spec-Zone.ru

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