Fullscreen API
fullscreenerror 事件在浏览器不能切换全屏模式时触发。
与 fullscreenchange 事件一样,会触发两个 fullscreenerror 事件;第一个事件会发送给未能更改模式的 Element,第二个事件会发送给拥有该元素的 Document。
有关切换到全屏模式可能失败的原因,请参阅全屏 API 指南。
该事件不可取消。
语法
在类似于 EventTarget.addEventListener 的方法中使用事件名称,或设置事件处理器属性。
addEventListener("fullscreenerror", (event) => {});
onfullscreenerror = (event) => {};
事件类型
通用的 Event。
示例
const requestor = document.querySelector("div");
function handleError(event) {
console.error("切换至全屏模式时发生错误");
console.log(event);
}
document.addEventListener("fullscreenerror", handleError);
// 或
document.onfullscreenerror = handleError;
requestor.requestFullscreen();
规范
浏览器兼容性
参见
- Document/fullscreenchange_event
- Element:Element/fullscreenerror_event 事件
- 全屏 API
- 全屏 API 使用指南
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
