当前位置：首页 > VUE

vue实现全局遮罩层

2026-01-07 04:11:22VUE

实现全局遮罩层的方法

在Vue中实现全局遮罩层可以通过多种方式完成，以下是几种常见的实现方法：

使用Vue组件创建遮罩层

创建一个遮罩层组件，通过全局注册或动态挂载的方式实现全局调用。以下是一个简单的遮罩层组件示例：

<template>
  <div v-if="visible" class="global-mask" @click="onClick">
    <slot></slot>
  </div>
</template>

<script>
export default {
  name: 'GlobalMask',
  props: {
    visible: {
      type: Boolean,
      default: false
    },
    clickToClose: {
      type: Boolean,
      default: true
    }
  },
  methods: {
    onClick() {
      if (this.clickToClose) {
        this.$emit('update:visible', false)
      }
    }
  }
}
</script>

<style scoped>
.global-mask {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  background-color: rgba(0, 0, 0, 0.5);
  z-index: 9999;
  display: flex;
  justify-content: center;
  align-items: center;
}
</style>

全局注册并使用遮罩层

在main.js中全局注册组件，方便在任何地方使用：

import Vue from 'vue'
import GlobalMask from '@/components/GlobalMask.vue'

Vue.component('GlobalMask', GlobalMask)

在需要的地方使用：

<template>
  <div>
    <button @click="showMask = true">显示遮罩层</button>
    <GlobalMask v-model="showMask" />
  </div>
</template>

<script>
export default {
  data() {
    return {
      showMask: false
    }
  }
}
</script>

使用Vue插件方式实现

创建Vue插件实现更灵活的全局遮罩层控制：

// maskPlugin.js
const MaskPlugin = {
  install(Vue) {
    const MaskComponent = Vue.extend({
      template: '<div v-show="visible" class="global-mask"></div>',
      data() {
        return {
          visible: false
        }
      }
    })

    let maskInstance = new MaskComponent({
      el: document.createElement('div')
    })

    document.body.appendChild(maskInstance.$el)

    Vue.prototype.$mask = {
      show() {
        maskInstance.visible = true
      },
      hide() {
        maskInstance.visible = false
      }
    }
  }
}

export default MaskPlugin

在main.js中使用插件：

import Vue from 'vue'
import MaskPlugin from './maskPlugin'

Vue.use(MaskPlugin)

在组件中调用：

// 显示遮罩层
this.$mask.show()

// 隐藏遮罩层
this.$mask.hide()

使用Vuex管理遮罩层状态

对于大型应用，可以使用Vuex集中管理遮罩层的显示状态：

// store.js
export default new Vuex.Store({
  state: {
    maskVisible: false
  },
  mutations: {
    SHOW_MASK(state) {
      state.maskVisible = true
    },
    HIDE_MASK(state) {
      state.maskVisible = false
    }
  },
  actions: {
    showMask({ commit }) {
      commit('SHOW_MASK')
    },
    hideMask({ commit }) {
      commit('HIDE_MASK')
    }
  }
})

在根组件中使用：

<template>
  <div>
    <div v-if="$store.state.maskVisible" class="global-mask"></div>
    <router-view />
  </div>
</template>

在任何组件中控制遮罩层：

// 显示遮罩层
this.$store.dispatch('showMask')

// 隐藏遮罩层
this.$store.dispatch('hideMask')

样式优化建议

遮罩层样式可以根据需求进行调整：

vue实现全局遮罩层

.global-mask {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  background-color: rgba(0, 0, 0, 0.5);
  z-index: 9999;
  transition: opacity 0.3s ease;
}

/* 添加内容居中样式 */
.global-mask.with-content {
  display: flex;
  justify-content: center;
  align-items: center;
}