Vue使用ScreenFull插件实现全屏切换

YUELEI1182025-03-13 20:33

1. 安装

javascript 复制代码

pnpm add screenfull

2. 使用

javascript 复制代码

<template>
  <!-- 如果浏览器不支持全屏，则不显示这个图标 -->
  <div class="screen-full" @click="changeScreenFull()" v-if="isScreenEnable">
    <!-- 全屏和非全屏的图标 -->
    <SvgIcon
      :name="isScreenFull ? 'fullscreen-exit' : 'fullscreen'"
      color="#515151"
      width="30px"
      height="30px"
    ></SvgIcon>
  </div>
</template>

<script setup lang="ts">
import { ref, onMounted, onUnmounted } from 'vue'
import { ElMessage } from 'element-plus'
import screenfull from 'screenfull'
// 是否支持全屏
const isScreenEnable = ref(screenfull.isEnabled)
// 用于控制图片状态
const isScreenFull = ref(false)
// 切换全屏
const changeScreenFull = () => {
  // 检查全屏功能是否可用
  if (!isScreenEnable.value) {
    ElMessage.error('浏览器不支持全屏')
    return
  }
  // 根据当前全屏状态进行切换
  if (screenfull.isFullscreen) {
    screenfull.exit()
    isScreenFull.value = false
  } else {
    screenfull.toggle()
    isScreenFull.value = true
  }
}
// 监听全屏状态, 当全屏状态改变时, 会触发change事件
onMounted(() => {
  screenfull.on('change', () => {})
})
// 停止监听
onUnmounted(() => {
  screenfull.off('change', () => {})
})
</script>

3. 方法

引入

javascript 复制代码

import screenfull from 'screenfull'

是否可以全屏（属性）（浏览器的支持）

javascript 复制代码

// 返回值是boolean类型
screenfull.isEnabled

开启全屏状态（方法）

javascript 复制代码

screenfull.toggle()

退出全屏状态

javascript 复制代码

screenfull.exit()

监听全屏状态发生改变时，可以执行回调

javascript 复制代码

screenfull.on('change', () => {})

停止监听的回调

javascript 复制代码

screenfull.off('change', () => {})