当前位置：首页 > VUE

vue实现弹窗功能

2026-01-16 19:22:31VUE

实现基础弹窗组件

在Vue中创建弹窗通常需要定义一个组件，利用v-if或v-show控制显示隐藏。以下是一个基础弹窗组件的实现：

<template>
  <div class="modal-mask" v-show="isVisible" @click.self="close">
    <div class="modal-container">
      <div class="modal-header">
        <h3>{{ title }}</h3>
        <button @click="close">&times;</button>
      </div>
      <div class="modal-body">
        <slot></slot>
      </div>
      <div class="modal-footer">
        <button @click="close">关闭</button>
      </div>
    </div>
  </div>
</template>

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

<style scoped>
.modal-mask {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  background: rgba(0, 0, 0, 0.5);
  display: flex;
  justify-content: center;
  align-items: center;
  z-index: 1000;
}
.modal-container {
  background: white;
  border-radius: 4px;
  width: 400px;
  padding: 20px;
}
</style>

使用弹窗组件

在父组件中使用弹窗，通过v-model绑定显示状态：

<template>
  <div>
    <button @click="showModal = true">打开弹窗</button>
    <Modal v-model:isVisible="showModal" title="示例弹窗">
      <p>这里是弹窗内容</p>
    </Modal>
  </div>
</template>

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

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

动画效果实现

为弹窗添加过渡动画，可以使用Vue的transition组件：

<template>
  <transition name="modal">
    <div class="modal-mask" v-show="isVisible" @click.self="close">
      <!-- 弹窗内容 -->
    </div>
  </transition>
</template>

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

全局弹窗服务

对于需要全局调用的弹窗，可以创建弹窗服务：

// modalService.js
import Vue from 'vue'

const ModalConstructor = Vue.extend(require('./Modal.vue').default)

const modalService = {
  open(options) {
    const instance = new ModalConstructor({
      propsData: options.props
    })

    instance.$mount()
    document.body.appendChild(instance.$el)

    return {
      close: () => {
        instance.$emit('update:isVisible', false)
        setTimeout(() => {
          document.body.removeChild(instance.$el)
          instance.$destroy()
        }, 300)
      }
    }
  }
}

export default modalService

第三方库方案

使用现成的弹窗库如vue-js-modal可以快速实现功能：

vue实现弹窗功能

npm install vue-js-modal

// main.js
import VModal from 'vue-js-modal'
Vue.use(VModal)

<template>
  <button @click="showModal = true">打开弹窗</button>
  <modal name="example" :adaptive="true" height="auto">
    <p>第三方库弹窗内容</p>
  </modal>
</template>

<script>
export default {
  methods: {
    show() {
      this.$modal.show('example')
    },
    hide() {
      this.$modal.hide('example')
    }
  }
}
</script>