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

原理

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

  1. Document.exitFullscreen() :用于请求从全屏模式切换到窗口模式
  2. 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>
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 最近一个项目有页面全屏的的需求,搜索了下有HTML5的全屏API可用,不过各浏览器的支持不一样。 MDN Full...
    后除阅读 3,005评论 1 6
  • 最近需求中遇到关于全屏展示的需求,于是深入了解了一下demo如下所示?MDN介绍: 使用提供的API,让一个元素与...
    Marting424阅读 2,008评论 0 0
  • 最近需求中遇到关于全屏展示的需求,于是深入了解了一下demo如下所示? demo[https://codepen....
    好奇男孩阅读 1,063评论 0 2
  • 浏览器全屏模式的启动函数requestFullscreen仍然需要附带各浏览器的js方言前缀,相信下面这段代码需要...
    dctxf阅读 1,867评论 0 1
  • 第一部分: 接口 全屏 API 没有它自己的接口实现。相反,它提供了一些其他接口以供实现全屏所需的方法、属性、事件...
    岁月静好_不负此生阅读 704评论 0 1