HTMLMediaElement: phương thức load()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức HTMLMediaElement
load() đặt lại phần tử phương tiện về trạng thái ban đầu và
bắt đầu quá trình chọn nguồn phương tiện và tải phương tiện để chuẩn bị
để bắt đầu phát lại từ đầu.
Lượng dữ liệu truyền thông được
tìm nạp trước được xác định bởi giá trị thuộc tính preload của phần tử.
Phương pháp này thường chỉ hữu ích khi bạn thực hiện các thay đổi động đối với tập hợp
các nguồn có sẵn cho phần tử phương tiện, bằng cách thay đổi thuộc tính của phần tử
thuộc tính src hoặc bằng cách thêm hoặc xóa
Các phần tử <source> được lồng trong chính phần tử phương tiện đó.
load() sẽ thiết lập lại phần tử và quét lại các nguồn có sẵn, từ đó
làm cho những thay đổi có hiệu lực.
Cú pháp
load()
Tham số
Không có.
Giá trị trả về
Không có (undefined).
Ghi chú sử dụng
Việc gọi load() sẽ hủy bỏ tất cả các hoạt động đang diễn ra liên quan đến thành phần phương tiện này,
sau đó bắt đầu quá trình lựa chọn và tải tài nguyên phương tiện thích hợp dựa trên
các tùy chọn được chỉ định trong phần tử <audio> hoặc <video>
và thuộc tính src hoặc thuộc tính con <source> của nó
(các) phần tử. Điều này được mô tả chi tiết hơn trong
trang HTML video and audio.
Quá trình hủy bỏ mọi hoạt động đang diễn ra sẽ gây ra bất kỳ khoản nợ đọng nào
Promises được trả về bởi play()
được đáp ứng hoặc bị từ chối tùy theo tình trạng của chúng trước khi nạp hàng mới
phương tiện truyền thông có thể bắt đầu. Lời hứa chơi đang chờ xử lý bị hủy bỏ bằng "AbortError"
DOMException.
Các sự kiện phù hợp sẽ được gửi đến chính phần tử phương tiện dưới dạng quá trình tải tiền thu được:
- Nếu phần tử đang trong quá trình tải phương tiện thì quá trình tải đó là
bị hủy bỏ và sự kiện
abortđược gửi đi. - Nếu phần tử đã được khởi tạo bằng phương tiện, thì
emptiedsự kiện được gửi. - Nếu việc đặt lại vị trí phát lại về đầu media thực sự thay đổi
vị trí phát lại (nghĩa là nó chưa ở đầu), a
timeupdatesự kiện được gửi. - Khi phương tiện đã được chọn và quá trình tải sẵn sàng bắt đầu,
Sự kiện
loadstartđã được thực hiện. - Từ thời điểm này trở đi, các sự kiện sẽ được gửi giống như bất kỳ lượt tải phương tiện nào.
Ví dụ
Ví dụ này tìm thấy phần tử <video> trong tài liệu và đặt lại nó bằng cách
đang gọi load().
const mediaElem = document.querySelector("video");
mediaElem.load();
Đặc tả kỹ thuật
| Specification |
|---|
| HTML # dom-media-load-dev |