HTML5全屏需满足用户交互触发、DOM已插入、权限允许等条件；标准方法为Element.requestFullscreen()，兼容处理、iframe需allow="fullscreen"，并监听fullscreenchange事件响应状态变化。
如果您尝试让网页中的HTML5元素（如<video></video>或<canvas></canvas>）进入全屏显示，但页面未响应或触发失败，则可能是由于浏览器限制、元素未正确绑定事件或未满足全屏API调用条件。以下是开启HTML5全屏模式的具体方法：
一、使用Element.requestFullscreen()方法
该方法是现代浏览器推荐的标准全屏API，需在用户交互（如点击）上下文中调用，且目标元素必须已插入DOM。浏览器会检查该元素是否允许全屏（例如，iframe需设置allowfullscreen属性）。
1、确保目标元素具有唯一ID，例如：<video id="myVideo" controls><source src="demo.mp4"></source></video>。
2、为该元素绑定点击事件，在事件处理函数中调用requestFullscreen()：
立即学习“前端免费学习笔记（深入）”；
3、添加兼容性前缀以支持旧版Chrome、Firefox和Safari：
4、在调用前检测方法是否存在，并捕获可能的拒绝错误（如用户未授权或策略阻止）：
二、通过document.documentElement触发页面级全屏
此方式将整个页面内容（包括所有子元素）置入全屏，适用于需要覆盖全部视口的场景，但可能影响布局结构与交互焦点，且部分浏览器（如iOS Safari）不支持页面级全屏。
1、获取文档根元素：const docEl = document.documentElement;。
2、直接调用docEl.requestFullscreen()，无需指定特定子元素。
3、注意：调用后页面滚动条将消失，必须确保页面无固定定位遮罩层覆盖全屏控件，否则用户无法退出全屏。
三、为iframe启用HTML5全屏支持
若目标视频或画布嵌套在iframe中，父页面默认禁止其发起全屏请求；需显式授予权限，否则调用requestFullscreen()将静默失败。
1、在iframe标签中添加allow="fullscreen"属性：
2、若iframe来自跨域源，还需确认对方页面已调用requestFullscreen()且未被CSP策略拦截。
3、缺少allow="fullscreen"属性时，即使JavaScript调用成功，浏览器也不会真正进入全屏状态。
四、监听全屏状态变化并响应退出
用户可通过ESC键或浏览器UI退出全屏，此时需监听fullscreenchange事件更新界面状态（如切换按钮图标），避免逻辑错位。
1、为document添加事件监听器：document.addEventListener('fullscreenchange', handleFullscreenChange);。
2、在回调函数中判断document.fullscreenElement是否为null来区分进入/退出状态。
3、该事件不会冒泡，且仅在document上触发，不可绑定到其他任意元素。
五、检查浏览器兼容性与权限策略
HTML5全屏API受浏览器版本及安全策略严格约束，例如Chrome 71+要求全屏请求必须发生在用户手势之后，而Firefox对<iframe></iframe>内嵌内容有更严苛的沙箱限制。
1、验证当前浏览器是否支持：if (document.documentElement.requestFullscreen) { ... }。
2、检查页面是否处于HTTPS环境——HTTP协议下多数现代浏览器禁用全屏API。
3、查看控制台是否有类似“Fullscreen request denied”或“Failed to execute 'requestFullscreen' on 'Element'”的报错信息。
