前端(Vue)全屏 screenfull 通用解决方案及原理分析

文章目录

全屏 API

原理

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

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

原生方法存在问题

尝试了一个网页,(整个) 区域背景颜色为黑色

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

方案

方案实现分为两步:

  1. 封装 screenfull 组件
    1. 展示切换按钮
    2. 基于 screenfull (第三方库)实现切换功能
  2. navbar 中引入该组件

实现 screenfull 组件

封装 **screenfull** 组件:

  1. 下来依赖包 screenfull
bash 复制代码
npm i screenfull@5.1.0
  1. 创建 Screenfull 组件

icon是一个变化的值:需要监听全屏的变化然后切换图标

非全屏模式展示:

全屏模式展示:

html 复制代码
<template>
  <div>
    <svg-icon
      :icon="isFullscreen ? 'exit-fullscreen' : 'fullscreen'"
      @click="onToggle"
    />
  </div>
</template>

<script setup>
import { ref, onMounted, onUnmounted } from 'vue'
import screenfull from 'screenfull'

// ref 对象,用于存储当前是否为全屏状态,初始值为 false。
const isFullscreen = ref(false)

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

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

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

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

<style lang="scss" scoped></style>

引入该组件:

html 复制代码
<screenfull class="right-menu-item hover-effect" />
import Screenfull from '@/components/Screenfull'

总结

  • 功能: 该组件允许用户通过点击图标在全屏和窗口模式之间切换。图标会根据当前状态自动切换显示 "进入全屏" 或 "退出全屏" 图标。
  • 核心逻辑 : 使用 screenfull 库来处理全屏切换,并使用 Vue 的 ref 和生命周期钩子 onMountedonUnmounted 来管理全屏状态的监听与更新。
  • 用户体验: 用户点击图标时,界面会根据全屏状态自动更新图标和界面显示,确保全屏功能的顺畅操作。
相关推荐
别拿曾经看以后~16 分钟前
【el-form】记一例好用的el-input输入框回车调接口和el-button按钮防重点击
javascript·vue.js·elementui
我要洋人死19 分钟前
导航栏及下拉菜单的实现
前端·css·css3
川石课堂软件测试22 分钟前
性能测试|docker容器下搭建JMeter+Grafana+Influxdb监控可视化平台
运维·javascript·深度学习·jmeter·docker·容器·grafana
科技探秘人31 分钟前
Chrome与火狐哪个浏览器的隐私追踪功能更好
前端·chrome
科技探秘人31 分钟前
Chrome与傲游浏览器性能与功能的深度对比
前端·chrome
JerryXZR37 分钟前
前端开发中ES6的技术细节二
前端·javascript·es6
七星静香39 分钟前
laravel chunkById 分块查询 使用时的问题
java·前端·laravel
q24985969341 分钟前
前端预览word、excel、ppt
前端·word·excel
小华同学ai1 小时前
wflow-web:开源啦 ,高仿钉钉、飞书、企业微信的审批流程设计器,轻松打造属于你的工作流设计器
前端·钉钉·飞书
problc1 小时前
Flutter中文字体设置指南:打造个性化的应用体验
android·javascript·flutter