Vue菜单动画双根元素警告及过渡失效问题求助

问题说明 #

实现的Vue.js侧边栏菜单动画存在两个问题：

1. Menu组件有两个根元素，触发Vue警告：

[Vue warn]: Runtime directive used on component with non-element root node. The directives will not function as intended.

2. 尝试用<template>包裹过渡元素时动画完全失效；用<div>包裹时仅能实现单向动画（滑入有效，滑出无效）。

修复步骤及代码 #

1. 修改App.vue：移除Menu组件的v-show指令 #

父组件的v-show会在menuVisible变为false时直接隐藏整个组件，导致子组件的退出动画无法执行，所有显示/隐藏逻辑交给子组件内部处理。

<script setup>
import { ref } from 'vue'
import Menu from './Menu.vue'

const menuVisible = ref(false)
const toggle = () => {
  menuVisible.value = !menuVisible.value
}
</script>

<template>
  <h1>侧边栏动画</h1>
  <button @click="toggle">切换菜单</button>
  <!-- 移除v-show，由子组件内部控制显示逻辑 -->
  <Menu :visible="menuVisible" @update:visible="toggle"/>
</template>

2. 修改Menu.vue：添加单个根容器并完善过渡逻辑 #

用<div>包裹两个过渡元素解决多根节点警告，同时确保过渡元素的v-if绑定visible，让过渡组件完整执行进入/退出动画。

<script setup lang="ts">
import { toRefs, watchEffect, onBeforeUnmount } from 'vue';

const props = defineProps({
  visible: {
    type: Boolean,
    required: true,
    default: false
  }
});

const { visible } = toRefs(props);

const emit = defineEmits(['update:visible']);

const hidemenuBar = () => {
  emit('update:visible', false);
};

watchEffect(() => {
  document.body.style.overflow = visible.value ? 'hidden' : 'auto';
  document.body.style.paddingRight = visible.value ? '15px' : '0px';
});

onBeforeUnmount(() => {
  document.body.style.overflow = 'auto';
  document.body.style.paddingRight = '0px';
});
</script>

<template>
  <!-- 添加单个根div容器，解决多根节点警告 -->
  <div>
    <transition name="fade">
      <div v-if="visible" class="menubar-overlay" @click="hidemenuBar"></div>
    </transition>
    <transition name="slide">
      <div class="menubar-container" v-if="visible">
        <div class="menubar__header">
          <h2 class="menu-headline">菜单</h2>
          <div>
            <i @click="hidemenuBar" class="cursor-pointer pi pi-times p-2"></i>
          </div>
        </div>
        <ul>
          <li>选项1</li>
          <li>选项2</li>
          <li>选项3</li>
        </ul>
        <button @click="hidemenuBar">关闭</button>
      </div>
    </transition>
  </div>
</template>

<style scoped>
.slide-enter-from,
.slide-leave-to {
  transform: translateX(100%);
}

.slide-enter-to,
.slide-leave-from {
  transform: translateX(0);
}

.slide-enter-active,
.slide-leave-active {
  transition: transform 1s;
}

/* 补全遮罩层的过渡动画 */
.fade-enter-from,
.fade-leave-to {
  opacity: 0;
}

.fade-enter-to,
.fade-leave-from {
  opacity: 1;
}

.fade-enter-active,
.fade-leave-active {
  transition: opacity 1s;
}

/* 菜单样式 */
.menubar-overlay {
  position: fixed;
  top: 0;
  right: 0;
  bottom: 0;
  left: 0;
  background-color: rgba(0, 0, 0, 0.7);
  cursor: pointer;
}
.menubar-container {
  position: fixed;
  display: grid;
  align-items: start;
  top: 0;
  right: 0;
  bottom: 0;
  width: 100%;
  max-width: 200px;
  height: 100%;
  overflow: hidden;
  overflow-y: auto;
  margin-left: auto;
  background-color: white;
  z-index: 100;
}

.menubar__header {
  z-index: 2;
  display: flex;
  justify-content: space-between;
  margin: 20px;
  border-bottom: 2px solid black;
}
</style>

修复原理 #

1. 移除父组件v-show：避免组件被直接隐藏，让子组件内的过渡元素有足够时间执行退出动画。
2. 添加根div容器：解决多根节点的Vue警告，同时保证过渡组件挂载在真实DOM节点上。
3. 完善过渡逻辑：通过子组件内部的v-if="visible"控制过渡元素的显示/隐藏，确保进入和退出动画都能完整触发。

内容的提问来源于stack exchange，提问作者Mr.P