vue3： screenfull(全屏) 原理及方案分析

最新推荐文章于 2025-11-07 00:18:18 发布

原创最新推荐文章于 2025-11-07 00:18:18 发布 · 4k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#vue.js #前端 #javascript

vue3 专栏收录该内容

1 篇文章

订阅专栏

本文介绍了Vue3中利用screenfull库实现全屏切换的原理和步骤。首先，浏览器提供了原生的全屏API，但直接使用可能会遇到问题。为了解决这些问题，开发者通常会借助screenfull.js这个封装库。文章详细展示了如何安装screenfull库，创建一个全屏切换组件，并通过事件监听来实时更新全屏状态。在组件中，当用户点击图标时，调用screenfull.toggle()方法来切换全屏。同时，还讲解了在组件挂载和卸载时如何正确添加和移除事件监听器，确保全屏状态的准确跟踪。

vue3： screenfull 原理及方案分析

原理

对于screenfull而言，浏览器本身提供了对应的api：

1.Document.exitFullscreen() ：用于请求从全屏模式切换到窗口模式

2.Element.requestFullscreen() : 用于请求浏览器将特定元素(甚至延伸到它的后代元素)置为全屏模式

ex: 我们可以通过 document.getElementById('app').requestFullscreen()在获取 id=app的 DOM之后，把该区域置为全屏，但该方法存在一些小的问题，比如 appmin区域背景色改变

所以通常我们不会直接使用该 API来实现全屏，而是使用它的包装库 screenfull

方案

1.下载依赖 screenfull

npm i screenfull

2.创建组件 Screenfull.vue

<template>
  <div>
    <svg-icon
      :icon="isFullscreen ? 'exit-fullscreen' : 'fullscreen'"
      @click="onToggle"
    />
  </div>
</template>

<script setup>
import { onMounted, onUnmounted, ref } from 'vue'
import screenfull from 'screenfull'
// 是否全屏
const isFullscreen = ref(false)

// 监听变化
const change = () => {
  isFullscreen.value = screenfull.isFullscreen
}

// 切换事件
const onToggle = () => {
  screenfull.toggle()
}

// 设置监听器
onMounted(() => {
  screenfull.on('change', change)
})

// 删除监听器
onUnmounted(() => {
  screenfull.off('change', change)
})
</script>