js实现页面全屏展示

最近做一个网页项目,用户要求可以全屏展示,进入系统后隐藏地址栏,于是乎,经过调研就选择了全屏API,即便如此还是遇到了一些问题,总结一下,写下此篇文章,以免以后再遇到相同的问题。

在JavaScript中,实现页面全屏展示主要依赖于HTML5的Fullscreen API,这是一个相对较新的技术,因此在旧版本的浏览器上可能不受支持,现代浏览器支出如下。

检查浏览器是否支持Fullscreen API

在尝试使用Fullscreen API之前,最好先检查浏览器是否支持它。虽然现代浏览器普遍支持,但检查总是好的做法。

javascript 复制代码
if (document.fullscreenEnabled ||
    document.mozFullScreenEnabled ||
    document.webkitFullscreenEnabled ||
    document.msFullscreenEnabled) {
    // 支持全屏
} else {
    // 不支持全屏
}

全屏模式

获取Element节点,然后使用requestFullscreen方法,可以使得这个节点全屏,全屏模式的具体实现可能因浏览器而异,所以要做不同浏览器处理。

javascript 复制代码
const openFullScreen = () => {
  const full = document.getElementById('fullscreen')
  if (full.RequestFullScreen) {
    full.RequestFullScreen()
  } else if (full.mozRequestFullScreen) {
    full.mozRequestFullScreen()
  } else if (full.webkitRequestFullScreen) {
    full.webkitRequestFullScreen()
  } else if (full.msRequestFullscreen) {
    full.msRequestFullscreen()
  }
}

退出全屏模式

退出全屏模式可以通过调用document.exitFullscreen()方法实现。这个方法会尝试让当前处于全屏模式的元素退出全屏。用户手动按下ESC键,也可以退出全屏键。

javascript 复制代码
const exitFullScreen = () => {
  if (document.exitFullScreen) {
    document.exitFullScreen();
  } else if (document.mozCancelFullScreen) {
    document.mozCancelFullScreen();
  } else if (document.webkitExitFullscreen) {
    document.webkitExitFullscreen();
  } else if (document.msExitFullscreen) {
    document.msExitFullscreen();
  }
}

获取全屏元素

document.fullscreenElement属性返回正处于全屏状态的Element节点,如果当前没有节点处于全屏状态,则返回null。可以通过此方法判断是否在全屏状态。

javascript 复制代码
const fullscreenElement =
  document.fullscreenElement ||
  document.mozFullScreenElement ||
  document.webkitFullscreenElement;

注意事项

💥 想要全屏的元素都应该在这个Element节点下面,否则的话全屏时不会展示。如下图的html结构,点击单开弹框依然无法在全屏模式下看到弹窗,推出全屏时会看到弹窗已经出现。如果想避免这种莫名的问题,可以把document.getElementById('fullscreen') 改成document.documentElement,让整个HTML全屏。

💥 requestFullscreen方法只能是用户主动触发才可以,如果想在页面加载时通过js调用方法或者是触发click事件触发,我劝你还是放弃吧,在控制台出现如下警告:

💥 刷新页面也会自动退出全屏模式;

💥 如果想改变全屏状态时的样式,首先可以在全屏时添加一个calss,此外也可以使用:full-screen伪类,大部分浏览器都支持,检查全屏时元素,也是有使用:full-screen伪类的。

相关推荐
Yannik21 分钟前
在 Apple Silicon Mac 上用 Jenkins + Fastlane 搭建 iOS CI:从自动打包到 MR 检查流水线的完整实践
前端
Nayana21 分钟前
《Web 到 HarmonyOS》-- 打包:Vite 产物 → HAP / HAR / HSP
前端
inksci28 分钟前
用飞帆做了个小网页
前端·javascript·css·html
去伪存真31 分钟前
被 pnpm 打包坑惨后,我彻底盘明白了硬链接与软链接
前端·electron
zhensherlock1 小时前
Protocol Launcher 系列:CodeHub 移动端 GitHub 协作利器
前端·javascript·typescript·node.js·自动化·github·js
tryCbest6 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai2737 小时前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
zhanlang02178 小时前
HTML 零基础入门到企业实战【第八章 8.5】画布 canvas、SVG 矢量图形基础入门
前端·html
星云_byto9 小时前
CSS面试题
前端·css
zhanlang02179 小时前
HTML 零基础入门到企业实战全套教程【连载 8.4】HTML5 新增表单属性与表单控件
前端·html·html5