父页面 document.fullscreenelement 为 null 是因为 iframe 全屏状态归属子文档，不提升至父文档；需通过 postmessage 协同管理状态并手动控制滚动锁定。
iframe 全屏时 parent.document.fullscreenElement 为什么是 null
父页面调用 document.documentElement.requestFullscreen() 后，若 iframe 内容被设为全屏（比如子页主动触发），父页面的 document.fullscreenElement 会返回 null，而不是指向该 iframe 元素。这是因为全屏状态属于“当前激活文档”，而 iframe 是独立的 browsing context —— 它的全屏行为不提升到父文档层级。
浏览器严格按规范隔离 fullscreen 权限：只有直接触发全屏的 document 才拥有 fullscreenElement，父页面无法通过 DOM 引用“接管”子 iframe 的全屏状态。
- 子页面调用
document.documentElement.requestFullscreen()→ 全屏状态归属子 document，父页面document.fullscreenElement始终为null - 父页面想感知子 iframe 进入全屏，必须依赖子页主动通知（如
window.postMessage） - 父页面不能用
iframeElm.requestFullscreen()让整个 iframe 元素全屏 —— 这个 API 只对<video></video>、<canvas></canvas>等特定元素有效，对<iframe></iframe>无效
子页面 requestFullscreen 失败的常见原因和绕过方式
子页面调用 requestFullscreen() 报错 DOMException: Document not active 或静默失败，通常不是代码写错了，而是权限链断裂：
- iframe 必须显式声明
allow="fullscreen"属性，否则 Chrome/Firefox 直接拒绝全屏请求 - 若 iframe src 是跨域页面，即使加了
allow="fullscreen"，也需目标页面自身调用（不能由父页 proxy 调用） - 用户手势缺失：全屏必须由用户主动操作（如 click、keydown）触发，不能在 onload 或定时器中调用
- 某些安卓 WebView 或旧版 Safari 不支持 iframe 内部全屏，会 fallback 到缩放视口而非真正全屏
正确写法示例：<iframe src="child.html" allow="fullscreen" id="myFrame"></iframe>
父子页面如何协同管理全屏状态（含跨域）
全屏状态无法自动同步，必须靠显式通信。推荐用 window.postMessage + 监听 fullscreenchange 事件组合实现：
- 子页面监听自身
document.addEventListener('fullscreenchange', () => { ... })，进入/退出时向父页发消息：window.parent.postMessage({ type: 'fullscreen-enter' }, '*') - 父页面监听
window.addEventListener('message', e => { ... })，根据e.data.type更新 UI 或记录状态 - 跨域时，父页发消息给子页必须指定 targetOrigin（不能用
'*'），子页也应校验e.origin防止伪造 - 不要依赖
window.parent.document.fullscreenElement === iframeElm做判断 —— 这永远为 false
iframe 全屏后父页面 scroll 锁定失效的隐藏问题
当子页面进入全屏，父页面本应冻结滚动（常见于弹层遮罩场景），但实际中常发现父页仍可滚动。这不是 bug，而是浏览器行为：
- 全屏仅影响视觉层和焦点，不自动禁用父文档的
overflow或scroll - 父页需手动在收到子页
fullscreen-enter消息后，设置document.body.style.overflow = 'hidden' - 退出全屏时，子页发
fullscreen-exit消息，父页再恢复overflow；否则可能残留锁死状态 - 注意：iOS Safari 在 iframe 全屏时可能忽略
overflow: hidden，需额外加touch-action: none和position: fixed补丁
真正的难点不在 API 调用本身，而在状态同步的时机和边界条件 —— 比如子页快速进出全屏、用户按 ESC 退出、或多个 iframe 并存时的状态混淆。这些都得靠 message 事件 + 显式状态标记来兜底，没有捷径。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
