前端（Vue）全屏 screenfull 通用办理方案及原理分析

全屏 API

  
原理

对于 screenfull 而言，浏览器本身已经提供了对用的 API，点击这里即可查看，这个 API 中，主要提供了两个方法：

• [Document.exitFullscreen()](https://developer.mozilla.org/zh-CN/docs/Web/API/Document/exitFullscreen)：该方法用于哀求从全屏模式切换到窗口模式
  
• [Element.requestFullscreen()](https://developer.mozilla.org/zh-CN/docs/Web/API/Element/requestFullScreen)：该方法用于哀求浏览器（user agent）将特定元素（甚至延伸到它的后代元素）置为全屏模式
  
  
  • 好比我们可以通过 document.getElementById('app').requestFullscreen() 在获取 id=app 的 DOM 之后，把该地区置为全屏
    
  
  

原生方法存在问题

尝试了一个网页，（整个） 地区背景颜色为玄色

以是通常情况下我们不会直接使用该 API 来去实现全屏效果，而是会使用它的包装库 screenfull

方案

方案实现分为两步：

• 封装 screenfull 组件
  
  
  • 展示切换按钮
    
  • 基于 screenfull （第三方库）实现切换功能
    
  
  
• 在 navbar 中引入该组件
  

实现 screenfull 组件

封装 **screenfull** 组件：

• 下来依赖包  screenfull
  

1. npm i screenfull@5.1.0

复制代码

• 创建 Screenfull 组件
  

icon是一个变化的值：必要监听全屏的变化然后切换图标
非全屏模式展示：

全屏模式展示：

1. <template>
2.   <div>
3.     <svg-icon
4.       :icon="isFullscreen ? 'exit-fullscreen' : 'fullscreen'"
5.       @click="onToggle"
6.     />
7.   </div>
8. </template>
10. <script setup>
11. import { ref, onMounted, onUnmounted } from 'vue'
12. import screenfull from 'screenfull'
14. // ref 对象，用于存储当前是否为全屏状态，初始值为 false。
15. const isFullscreen = ref(false)
17. // 监听screenfull的变化
18. const change = () => {
19.   isFullscreen.value = screenfull.isFullscreen
20. }
22. // 切换事件
23. const onToggle = () => {
24.   // 切换全屏模式
25.   screenfull.toggle()
26. }
28. // 设置侦听器
29. onMounted(() => {
30.   // on：绑定监听
31.   screenfull.on('change', change)
32. })
34. // 删除侦听器
35. onUnmounted(() => {
36.   // off：取消监听
37.   screenfull.off('change', change)
38. })
39. </script>
41. <style lang="scss" scoped></style>

复制代码

引入该组件：

1. <screenfull class="right-menu-item hover-effect" />
2. import Screenfull from '@/components/Screenfull'

复制代码

总结

• 功能: 该组件答应用户通过点击图标在全屏和窗口模式之间切换。图标会根据当前状态主动切换表现 “进入全屏” 或 “退出全屏” 图标。
  
• 核心逻辑: 使用 screenfull 库来处置惩罚全屏切换，并使用 Vue 的 ref 和生命周期钩子 onMounted、onUnmounted 来管理全屏状态的监听与更新。
  
• 用户体验: 用户点击图标时，界面会根据全屏状态主动更新图标和界面表现，确保全屏功能的顺畅利用。
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。