当前位置：首页 > VUE

vue 实现弹窗遮罩

2026-03-08 17:56:33VUE

实现弹窗遮罩的基本方法

在Vue中实现弹窗遮罩通常需要结合CSS样式和Vue的组件化功能。遮罩层通常是一个半透明的黑色背景，覆盖整个屏幕，弹窗内容位于遮罩层上方。

创建遮罩组件

定义一个名为Modal.vue的组件，包含遮罩层和弹窗内容区域。组件模板结构如下：

<template>
  <div class="modal-mask" v-show="show" @click.self="close">
    <div class="modal-container">
      <slot></slot>
    </div>
  </div>
</template>

添加遮罩样式

CSS样式控制遮罩层的外观和行为。关键样式包括固定定位、全屏覆盖和半透明效果：

.modal-mask {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  background-color: rgba(0, 0, 0, 0.5);
  display: flex;
  align-items: center;
  justify-content: center;
  z-index: 999;
}

.modal-container {
  background: white;
  padding: 20px;
  border-radius: 4px;
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.33);
}

控制弹窗显示与隐藏

在组件脚本部分定义show属性和close方法，通过props控制弹窗显示状态：

<script>
export default {
  props: {
    show: Boolean
  },
  methods: {
    close() {
      this.$emit('close');
    }
  }
}
</script>

在父组件中使用

父组件中引入并使用弹窗组件，通过v-model或自定义事件控制显示状态：

<template>
  <button @click="showModal = true">打开弹窗</button>
  <Modal :show="showModal" @close="showModal = false">
    <h3>弹窗标题</h3>
    <p>弹窗内容</p>
  </Modal>
</template>

<script>
import Modal from './Modal.vue'

export default {
  components: { Modal },
  data() {
    return {
      showModal: false
    }
  }
}
</script>

添加过渡动画效果

为弹窗添加淡入淡出效果，可以使用Vue的transition组件：

<transition name="modal">
  <Modal v-if="showModal" @close="showModal = false">
    <!-- 弹窗内容 -->
  </Modal>
</transition>

添加对应的CSS过渡样式：

.modal-enter-active, .modal-leave-active {
  transition: opacity 0.3s ease;
}

.modal-enter, .modal-leave-to {
  opacity: 0;
}

阻止背景滚动

当弹窗显示时，通常需要阻止页面背景滚动。可以通过添加/移除body的overflow样式实现：

vue 实现弹窗遮罩

watch: {
  showModal(newVal) {
    if (newVal) {
      document.body.style.overflow = 'hidden'
    } else {
      document.body.style.overflow = ''
    }
  }
}