元素:fullscreenerror 事件

可用性有限

此功能不是基线功能,因为它在某些最广泛使用的浏览器中不起作用。

当浏览器无法切换到全屏模式时,会触发 fullscreenerror 事件。

fullscreenchange 事件 一样,会触发两个 fullscreenerror 事件;第一个事件发送到无法更改模式的 Element,第二个事件发送到拥有该元素的 Document

有关切换到全屏模式可能失败的一些原因,请参阅 全屏 API 指南

此事件不可取消。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("fullscreenchange", (event) => {});

onfullscreenchange = (event) => {};

事件类型

一个通用的 Event

示例

js
const requestor = document.querySelector("div");

function handleError(event) {
  console.error("an error occurred changing into fullscreen");
  console.log(event);
}

requestor.addEventListener("fullscreenerror", handleError);
// or
requestor.onfullscreenerror = handleError;

requestor.requestFullscreen();

规范

规范
全屏 API 标准
# handler-document-onfullscreenerror

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅