Spec-Zone.ru › Web APIs

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

Spec-Zone.ru

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