HTML怎么检测全屏状态_HTML fullscreenchange事件监听【说明】

陌枫酱_2535

陌枫酱_2535

2026-03-22

557人浏览

原创

监听HTML全屏状态变化应绑定fullscreenchange事件到document,注意其不冒泡、大小写敏感;判断状态优先用document.fullscreenElement!==null,再降级检查webkit/ms前缀属性;requestFullscreen()须由用户手势触发且元素需可见。

html怎么检测全屏状态_html fullscreenchange事件监听【说明】

怎么监听HTML全屏状态变化

直接用 fullscreenchange 事件,但必须注意它不冒泡、不触发在 document 上(旧版浏览器可能挂载在 document.documentElement),而且事件名大小写敏感——不是 fullScreenChange 或 fullscreenChanged。

常见错误是绑定到 window 或随便一个元素上,结果一直收不到回调。它只在 document 级别触发,且只有当前全屏元素的祖先链上的 document 才会派发。

  • 始终监听 document,不是 document.body 或其他节点
  • 加个兼容性兜底:检查 document.fullscreenElement(标准)和 document.webkitFullscreenElement(Safari)、document.msFullscreenElement(IE11)
  • 事件回调里别直接操作 DOM 节点,因为全屏切换是异步的,刚进回调时 fullscreenElement 可能还没更新,建议用 setTimeout(() => {}, 0) 延迟读取(尤其 Safari)

如何判断当前是否处于全屏状态

不能只看事件,得靠状态属性实时判断。最可靠的是 document.fullscreenElement —— 它非 null 表示有元素处于全屏,null 表示退出全屏。

但这个值在不同浏览器行为不一致:Chrome/Firefox 返回被全屏的元素本身;Safari 返回 ;IE11 返回 null 即使已全屏(得靠 document.msFullscreenElement)。所以判断逻辑要分层。

  • 优先用 document.fullscreenElement !== null
  • 降级检查 document.webkitFullscreenElement 和 document.msFullscreenElement
  • 避免用 document.fullscreenEnabled 判断“当前状态”,它只表示浏览器是否支持全屏 API,跟是否正在全屏无关

requestFullscreen() 失败的常见原因

调用 element.requestFullscreen() 后没反应,大概率是被浏览器静默拒绝了——这不是 bug,而是策略限制。

DeepBI DHTML 页面生成器
DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur

下载

主要触发条件:必须由用户手势(如 click、keydown)触发;不能在 iframe 里调用(除非 allow="fullscreen");目标元素不能是 display: none 或 visibility: hidden;移动端多数浏览器根本不支持(iOS Safari 完全禁用)。

  • 确保调用栈可追溯到用户事件处理器,不要在 setTimeout 或 fetch 回调里直接调
  • 检查控制台是否有类似 Failed to execute 'requestFullscreen' on 'Element': API can only be initiated by a user gesture 的错误
  • 移动端想“模拟全屏”?老老实实用 CSS + viewport 缩放,别硬刚 API

退出全屏后样式错乱怎么办

全屏退出时,有些浏览器(尤其是 Safari)不会自动恢复元素的原始尺寸或定位,导致布局塌陷或滚动条异常。根本原因是全屏模式下浏览器会给 :fullscreen 伪类加强制样式(比如 width: 100vw; height: 100vh),退出后这些样式残留或未重绘。

不是所有情况都出问题,但一旦涉及 flex/grid 布局、transform 动画、或 fixed 定位元素,就容易露馅。

  • 监听 fullscreenchange 后手动触发一次 element.style.width = '' 等清空内联样式(如果之前设过)
  • 更稳妥的做法:给全屏容器加 class(如 .is-fullscreen),所有全屏相关样式写在该 class 下,退出时移除 class 而非依赖浏览器还原
  • 别忘了 :fullscreen 是 CSS 伪类,它在退出后立即失效,但 JS 修改过的样式不会自动回退

全屏 API 表面简单,实际每个环节都卡在浏览器实现差异和安全策略上,尤其跨端时,状态判断和错误处理比调用本身更重要。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

html

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3949

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2528

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1480

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1418

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1476

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2478

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

4200

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

20255

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

569

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 244人学习