HTMLMediaElement: load() 方法
HTMLMediaElement 的 load() 方法會將媒體元素重置到初始狀態,並開始選擇媒體源並載入媒體的過程,以便從開頭開始播放。
預取的媒體資料量由元素的 preload 屬性的值決定。
此方法通常僅在您對媒體元素的可用源集進行了動態更改時才有用,這些更改可能是透過更改元素的 src 屬性或新增或刪除巢狀在媒體元素本身中的 <source> 元素來完成的。load() 會重置元素並重新掃描可用的源,從而使更改生效。
語法
js
load()
引數
無。
返回值
無(undefined)。
用法說明
呼叫 load() 會中止與此媒體元素相關的所有正在進行的操作,然後根據 <audio> 或 <video> 元素及其 src 屬性或子 <source> 元素中指定的選項,開始選擇和載入合適的媒體資源的過程。這在 HTML 影片和音訊頁面中有更詳細的描述。
中止任何正在進行的活動的過程將導致由 play() 返回的所有待定 Promise 根據其在載入新媒體開始之前的狀態被相應地fulfilled 或 rejected。待定的 play Promise 會被一個 "AbortError" DOMException 中止。
隨著載入過程的進行,將向媒體元素本身傳送適當的事件。
- 如果元素已在載入媒體的過程中,則該載入過程將被中止,併發送
abort事件。 - 如果元素已與媒體初始化,則會發送
emptied事件。 - 如果將播放位置重置到媒體的開頭確實改變了播放位置(即,它尚未位於開頭),則會發送
timeupdate事件。 - 一旦選擇了媒體並且已準備好開始載入,就會分發
loadstart事件。 - 從這一點開始,事件的傳送方式與任何媒體載入一樣。
示例
此示例在文件中查詢一個 <video> 元素,並透過呼叫 load() 來重置它。
js
const mediaElem = document.querySelector("video");
mediaElem.load();
規範
| 規範 |
|---|
| HTML # dom-media-load-dev |
瀏覽器相容性
載入中…