HTMLVideoElement

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

<video> 元素實現,HTMLVideoElement 介面提供了用於操作影片物件的特殊屬性和方法。它還繼承了 HTMLMediaElementHTMLElement 的屬性和方法。

支援的 媒體格式 因瀏覽器而異。您應該提供一種所有相關瀏覽器都支援的單一格式的影片,或者提供多種格式的影片源,以覆蓋您需要支援的所有瀏覽器。

EventTarget Node Element HTMLElement HTMLMediaElement HTMLVideoElement

例項屬性

繼承自其父介面 HTMLMediaElementHTMLElement 的屬性。

HTMLVideoElement.disablePictureInPicture

指示使用者代理是否應向用戶建議畫中畫模式。

HTMLVideoElement.height

一個字串,反映了 height HTML 屬性,該屬性指定顯示區域的高度(以 CSS 畫素為單位)。

HTMLVideoElement.poster

一個字串,反映了 poster HTML 屬性,該屬性指定在沒有可用影片資料時顯示的影像。

HTMLVideoElement.videoHeight 只讀

返回一個無符號整數值,指示資源的固有高度(以 CSS 畫素為單位),如果尚無媒體可用,則為 0。

HTMLVideoElement.videoWidth 只讀

返回一個無符號整數值,指示資源的固有寬度(以 CSS 畫素為單位),如果尚無媒體可用,則為 0。

HTMLVideoElement.width

一個字串,反映了 width HTML 屬性,該屬性指定顯示區域的寬度(以 CSS 畫素為單位)。

Firefox 特有屬性

HTMLVideoElement.mozParsedFrames 非標準 只讀 已棄用

返回一個 unsigned long,表示從媒體資源解析出的影片幀計數。

HTMLVideoElement.mozDecodedFrames 非標準 只讀 已棄用

返回一個 unsigned long,表示已解碼為影像的已解析影片幀計數。

HTMLVideoElement.mozPresentedFrames 非標準 只讀 已棄用

返回一個 unsigned long,表示已解碼並提交到渲染管線以進行繪製的幀計數。

HTMLVideoElement.mozPaintedFrames 非標準 只讀 已棄用

返回一個 unsigned long,表示已在螢幕上繪製的已呈現幀計數。

HTMLVideoElement.mozFrameDelay 非標準 只讀 已棄用

返回一個 double,表示最後一個繪製的影片幀延遲的時間(以秒為單位)。

HTMLVideoElement.mozHasAudio 非標準 只讀 已棄用

返回一個布林值,指示影片是否有關聯的音訊。

例項方法

繼承自其父介面 HTMLMediaElementHTMLElement 的方法。

HTMLVideoElement.cancelVideoFrameCallback()

取消先前註冊的影片幀回撥(參見 requestVideoFrameCallback())。

HTMLVideoElement.getVideoPlaybackQuality()

返回一個 VideoPlaybackQuality 物件,其中包含當前的播放指標。這些資訊包括丟幀或損壞幀的數量以及總幀數。

HTMLVideoElement.requestPictureInPicture()

請求使用者代理將影片進入畫中畫模式。

HTMLVideoElement.requestVideoFrameCallback()

註冊一個回撥函式,當新的影片幀傳送到合成器時執行。這使開發人員能夠對每個影片幀執行高效的操作。

事件

繼承自其父介面 HTMLMediaElementHTMLElement 的事件。

使用 addEventListener() 監聽這些事件,或透過將事件監聽器分配給此介面的 oneventname 屬性。

enterpictureinpicture

HTMLVideoElement 成功進入畫中畫模式時觸發。

leavepictureinpicture

HTMLVideoElement 成功退出畫中畫模式時觸發。

resize

videoWidthvideoHeight 屬性中的一個或兩個剛剛更新時觸發。

規範

規範
HTML
# htmlvideoelement

瀏覽器相容性

另見