Document: phương thức exitPictureInPicture()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức exitPictureInPicture() của giao diện Document yêu cầu một video chứa trong tài liệu này, hiện đang nổi, được đưa ra khỏi chế độ hình trong hình, khôi phục trạng thái trước đó của màn hình. Điều này thường đảo ngược hiệu ứng của một lệnh gọi trước đó đến HTMLVideoElement.requestPictureInPicture().
Cú pháp
exitPictureInPicture()
Tham số
Không có.
Giá trị trả về
Một Promise, sẽ được phân giải một khi user agent hoàn tất việc thoát khỏi chế độ hình trong hình. Nếu xảy ra lỗi khi cố thoát khỏi chế độ toàn màn hình, trình xử lý catch() của promise sẽ được gọi.
Ngoại lệ
InvalidStateErrorDOMException-
Được ném ra nếu
document.pictureInPictureElementlànull.
Ví dụ
Ví dụ này khiến tài liệu hiện tại thoát khỏi chế độ hình trong hình bất cứ khi nào nhấp chuột trong đó.
document.onclick = (event) => {
if (document.pictureInPictureElement) {
document
.exitPictureInPicture()
.then(() => console.log("Tài liệu đã thoát khỏi chế độ hình trong hình"))
.catch((err) => console.error(err));
} else {
video.requestPictureInPicture();
}
};
Lưu ý rằng nếu bạn muốn theo dõi video nào trên trang của bạn hiện đang phát ở chế độ hình trong hình, bạn nên lắng nghe các sự kiện enterpictureinpicture và exitpictureinpicture trên (các) phần tử HTMLVideoElement liên quan. Ngoài ra, bạn có thể kiểm tra xem Document.pictureInPictureElement có tham chiếu đến phần tử HTMLVideoElement hiện tại không.
Đặc tả kỹ thuật
| Specification |
|---|
| Picture-in-Picture # dom-document-exitpictureinpicture |