Vuetify中如何让hide-on-leave过渡仅在特定条件满足后触发一次?
非预期过渡的产生原因
你现在遇到的“切换启用/禁用状态时仍误触发hide-on-leave过渡”的问题,本质是过渡组件被永久挂载在模板中,没有做生命周期隔离:Vue的过渡组件一旦挂载,就会持续监听内部插槽的DOM变更,哪怕你的业务触发条件已经满足,只要父级按钮状态切换引发DOM重绘、内部元素的属性变动,都会被过渡组件捕获并触发对应的离场动画,完全不会主动判断“当前的变更是不是我应该生效的场景”。
一次性过渡的实现方法
想要实现“仅在特定条件首次满足时生效一次,后续任何状态变动都不再触发过渡”,只需要加一个一次性的状态锁,把过渡组件的渲染权限和这个锁绑定即可,不需要修改过渡本身的逻辑配置。
实现步骤
- 新增一个响应式状态锁,用来标记目标过渡是否已经完整执行过一次,初始值为
false - 监听预设的触发条件,当条件首次满足时,按照过渡的实际动画时长设置定时器,等动画完全走完后把状态锁置为
true - 模板做分支渲染:状态锁未激活时,使用带
hide-on-leave的过渡组件;状态锁激活后,直接渲染无任何过渡逻辑的普通DOM结构
可直接复用的代码示例
组件逻辑部分增加锁的监听:
import { ref, watch } from 'vue' // 过渡执行完成的锁标记 const transitionLocked = ref(false) watch( () => isAdded(idUn), (isAddedState) => { // 仅在首次满足触发条件时启动计时 if (isAddedState && !transitionLocked.value) { // 定时器时长和过渡动画时长对齐,避免动画截断 setTimeout(() => { transitionLocked.value = true }, 300) } }, { immediate: true } )
调整模板结构,替换永久挂载的过渡组件:
<!-- 锁未激活时,使用带hide-on-leave的目标过渡 --> <v-slide-x-transition v-if="!transitionLocked" hide-on-leave :duration="300" > <span v-if="isAdded(idUn)"> Added <v-icon> mdi-check </v-icon> </span> </v-slide-x-transition> <!-- 锁激活后,直接渲染无过渡的等效结构 --> <span v-else> <span v-if="isAdded(idUn)"> Added <v-icon> mdi-check </v-icon> </span> </span>
落地注意事项
- 两个分支里的DOM结构、样式类名要完全对齐,避免过渡组件卸载时出现布局偏移、跳动的问题
- 如果需要全局生效(即整个应用中只要触发过一次目标条件,所有同类型元素都不再显示过渡),可以把
transitionLocked标记放到Pinia/Vuex全局状态中,不需要每个组件单独维护 - 显式给过渡组件设置固定的动画时长,不要依赖Vuetify的默认值,避免和定时器计算的时长不匹配
内容的提问来源于stack exchange,提问作者Alex T
相关产品推荐
相关产品推荐

