当前位置：首页 > VUE

vue实现弹窗组件

2026-03-29 11:36:23VUE

Vue 实现弹窗组件的方法

使用 v-if 或 v-show 控制显示

在 Vue 中可以通过 v-if 或 v-show 指令来控制弹窗的显示与隐藏。v-if 会完全销毁和重建 DOM 元素，适合不频繁切换的场景；v-show 只是切换 display 属性，适合频繁切换的场景。

<template>
  <div>
    <button @click="showModal = true">打开弹窗</button>

    <div v-if="showModal" class="modal">
      <div class="modal-content">
        <span @click="showModal = false" class="close">&times;</span>
        <p>弹窗内容</p>
      </div>
    </div>
  </div>
</template>

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

<style>
.modal {
  position: fixed;
  z-index: 1;
  left: 0;
  top: 0;
  width: 100%;
  height: 100%;
  background-color: rgba(0,0,0,0.4);
}

.modal-content {
  background-color: #fefefe;
  margin: 15% auto;
  padding: 20px;
  border: 1px solid #888;
  width: 80%;
}

.close {
  color: #aaa;
  float: right;
  font-size: 28px;
  font-weight: bold;
  cursor: pointer;
}
</style>

创建可复用的弹窗组件

将弹窗封装为独立组件，通过 props 接收父组件传递的数据和方法，通过 $emit 触发父组件事件。

<!-- Modal.vue -->
<template>
  <div v-if="visible" class="modal">
    <div class="modal-content">
      <span @click="close" class="close">&times;</span>
      <slot></slot>
    </div>
  </div>
</template>

<script>
export default {
  props: {
    visible: {
      type: Boolean,
      default: false
    }
  },
  methods: {
    close() {
      this.$emit('update:visible', false)
    }
  }
}
</script>

<!-- ParentComponent.vue -->
<template>
  <div>
    <button @click="showModal = true">打开弹窗</button>
    <Modal v-model:visible="showModal">
      <p>自定义弹窗内容</p>
    </Modal>
  </div>
</template>

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

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

使用 Teleport 实现弹窗

Vue 3 提供了 Teleport 组件，可以将弹窗内容渲染到 DOM 树的任意位置，避免 z-index 和样式冲突问题。

<template>
  <button @click="showModal = true">打开弹窗</button>

  <Teleport to="body">
    <div v-if="showModal" class="modal">
      <div class="modal-content">
        <span @click="showModal = false" class="close">&times;</span>
        <p>弹窗内容</p>
      </div>
    </div>
  </Teleport>
</template>

实现带动画的弹窗

使用 Vue 的过渡系统为弹窗添加动画效果。

<template>
  <button @click="showModal = true">打开弹窗</button>

  <Transition name="modal">
    <div v-if="showModal" class="modal">
      <div class="modal-content">
        <span @click="showModal = false" class="close">&times;</span>
        <p>弹窗内容</p>
      </div>
    </div>
  </Transition>
</template>

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

.modal-enter-from,
.modal-leave-to {
  opacity: 0;
}
</style>

使用第三方库

对于更复杂的需求，可以考虑使用专门的弹窗库如 vuejs-modal、sweetalert2 等。

vue实现弹窗组件

// 安装 sweetalert2
npm install sweetalert2

// 在组件中使用
import Swal from 'sweetalert2'

methods: {
  showAlert() {
    Swal.fire({
      title: '弹窗标题',
      text: '弹窗内容',
      icon: 'success',
      confirmButtonText: '确定'
    })
  }
}