原理
对于 screenfull 而言,浏览器本身提供了对应的api:
- Document.exitFullscreen() :用于请求从全屏模式切换到窗口模式
- Element.requestFullscreen() : 用于请求浏览器将特定元素(甚至延伸到它的后代元素)置为全屏模式
ex: 我们可以通过 document.getElementById('app').requestFullscreen()在获取 id=app的 DOM之后,把该区域置为全屏,但该方法存在一些小的问题,比如 appmin区域背景色改变;
所以通常我们不会直接使用该 API来实现全屏,而是使用它的包装库 screenfull;
Api
request(ele) 全屏
.exit() 退出全屏
.toggle() 切换全屏
.on(event, function) : event为 ‘change’ | ‘error’ 注册事件
.off(event, function) : 移除前面已经注册的事件
.element: 返回一个全屏的dom节点,如果没有就为 null
.isFullscreen : 是否是全屏状态
.isEnabled : 判断是否支持全屏
使用案例
1.下载依赖 screenfull
npm i screenfull --save
2.创建组件 Screenfull.vue
vue3中使用:
<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>
vue2中使用
<template>
<div>
<svg-icon :icon-class="isFullscreen?'exit-fullscreen':'fullscreen'" @click="onToggle" />
</div>
</template>
<script>
import screenfull from 'screenfull'
export default {
name: 'Screenfull',
data() {
return {
isFullscreen: false
}
},
mounted() {
this.init()
},
beforeDestroy() {
this.destroy()
},
methods: {
//点击事件
onToggle() {
if (!screenfull.enabled) {
this.$message({
message: '你的浏览器不支持',
type: 'warning'
})
return false
}
screenfull.toggle()
},
change() {
this.isFullscreen = screenfull.isFullscreen
},
init() {
if (screenfull.enabled) {
screenfull.on('change', this.change)
}
},
//销毁
destroy() {
if (screenfull.enabled) {
screenfull.off('change', this.change)
}
}
}
}
</script>
<style scoped>
.screenfull-svg {
display: inline-block;
cursor: pointer;
fill: #5a5e66;;
width: 20px;
height: 20px;
vertical-align: 10px;
}
</style>