HTMLVideoElement: свойство videoHeight
Базовая Широко поддерживается
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Только для чтения свойство интерфейса HTMLVideoElement указывает на внутреннюю высоту видео, выраженную в пикселях CSS. Проще говоря, это высота медиа в его естественном размере.
Значение
Целочисленное значение, определяющее внутреннюю высоту видео в пикселях CSS. Если состояние элемента readyState равно HTMLMediaElement.HAVE_NOTHING, то значение этого свойства равно 0, поскольку информация о размерах ни видео, ни кадра-плаката еще недоступна.
О внутренней ширине и высоте
Пользовательский агент (user agent) рассчитывает внутреннюю ширину и высоту медиа элемента, начиная с исходной ширины и высоты пикселей медиа, затем учитывая такие факторы, как:
- Соотношение сторон медиа (aspect ratio).
- Чистая область медиа (подпрямоугольник, расположенный по центру медиа, который соответствует целевому соотношению сторон).
- Разрешение целевого устройства.
- Другие факторы, необходимые для формата медиа.
Если в данный момент отображается не отрендеренное видео, а кадр-плакат, то внутренние размеры кадра-плаката рассматриваются как размеры <video> элемента.
Если в любой момент внутренние размеры медиа меняются, а состояние элемента readyState не HAVE_NOTHING, то событие resize будет отправлено элементу <video>. Это может произойти при переключении с отображения кадра-плаката на отображение видео или при изменении отображаемой дорожки видео.
Примеры
Этот пример создаёт обработчик события resize, который изменяет размеры элемента <video> для соответствия внутренним размерам его содержимого.
let v = document.getElementById("myVideo");
v.addEventListener(
"resize",
(ev) => {
let w = v.videoWidth;
let h = v.videoHeight;
if (w && h) {
v.style.width = w;
v.style.height = h;
}
},
false,
);
Обратите внимание, что это изменение применяется только если и ширина, и высота videoWidth и videoHeight не равны нулю. Это предотвращает применение неверных изменений, когда точная информация о размерах ещё не доступна.
Спецификации
| Спецификация |
|---|
| HTML # dom-video-videoheight-dev |
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
videoHeight |
3 | 12 | 3.5 | 10.5 | 3.1 | 18 | 4 | 11 | 3 | 1.0 | ≤37 |
© 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/HTMLVideoElement/videoHeight