You need to enable JavaScript to run this app. Vuetify中如何让hide-on-leave过渡仅在特定条件满足后触发一次?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 08:45:10