Vue.js Transiciones y Animaciones
En este capítulo nos centramos principalmente en los efectos de transición y animación de Vue.js.
Transición
Vue ofrece múltiples formas de aplicar efectos de transición al insertar, actualizar o eliminar el DOM.
Vue proporciona un componente envoltorio de transición integrado, que se usa para envolver los componentes a los que se desea aplicar efectos de transición.
Formato de sintaxis
<transition name = "nameoftransition"> <div></div> </transition>
Podemos entender cómo se implementan las transiciones de Vue mediante el siguiente ejemplo:
Ejemplo
Pruébalo »
En el ejemplo, al hacer clic en el botón "Haz clic", el valor de la variable `show` cambia de `true` a `false`. Si es `true`, se muestra el contenido de la etiqueta `p` del elemento hijo.
El siguiente código muestra la etiqueta `transition` envolviendo la etiqueta `p`:
<transition name = "fade">
<p v-show = "show" v-bind:style = "styleobj">动画实例</p>
</transition>
La transición es, en realidad, un efecto de fundido de entrada y salida. Vue proporciona 6 clases para alternar en la transición de visibilidad y ocultamiento de los elementos:
v-enter: define el estado inicial de la transición de entrada. Se aplica antes de que el elemento se inserte y se elimina en el siguiente fotograma después de que el elemento se inserte.v-enter-active: define el estado activo de la transición de entrada. Se aplica durante toda la etapa de la transición de entrada, surte efecto antes de que el elemento se inserte y se elimina después de que finalice la transición/animación. Esta clase se puede usar para definir la duración, el retraso y la función de curva de la transición de entrada.v-enter-to: Desde la versión 2.1.8 en adelanteDefine el estado final de la transición de entrada. Surte efecto en el siguiente fotograma después de que el elemento se inserte (al mismo tiempo quev-enterse elimina), y se elimina después de que finalice la transición/animación.v-leave: define el estado inicial de la transición de salida. Surte efecto inmediatamente cuando se activa la transición de salida y se elimina en el siguiente fotograma.v-leave-active: define el estado activo de la transición de salida. Se aplica durante toda la etapa de la transición de salida, surte efecto inmediatamente cuando se activa la transición de salida y se elimina después de que finalice la transición/animación. Esta clase se puede usar para definir la duración, el retraso y la función de curva de la transición de salida.v-leave-to: Desde la versión 2.1.8 en adelanteDefine el estado final de la transición de salida. Surte efecto en el siguiente fotograma después de que se active la transición de salida (al mismo tiempo quev-leavese elimina), y se elimina después de que finalice la transición/animación.

Para estos nombres de clase que se alternan durante la transición, si usas uno sin nombre,<transition>, entoncesv-es el prefijo predeterminado de estos nombres de clase.<transition name="my-transition">Si usasv-enterse reemplazará pormy-transition-enter。
v-enter-activeyv-leave-activePueden controlar diferentes curvas de easing para las transiciones de entrada/salida; en el siguiente capítulo se mostrará un ejemplo.
Transiciones CSS
Normalmente usamos transiciones CSS para lograr el efecto.
Como en el siguiente ejemplo:
Ejemplo
Pruébalo »
Animaciones CSS
El uso de las animaciones CSS es similar al de las transiciones CSS, pero en las animaciones el nombre de clase `v-enter` no se elimina inmediatamente después de que el nodo se inserte en el DOM, sino que se elimina cuando se dispara el evento `animationend`.
Ejemplo
Pruébalo »
Nombres de clase personalizados para transiciones
Podemos personalizar los nombres de clase de transición mediante los siguientes atributos:
enter-classenter-active-classenter-to-class(2.1.8+)leave-classleave-active-classleave-to-class(2.1.8+)
Los nombres de clase de transición personalizados tienen prioridad sobre los nombres de clase normales, lo que permite combinarlos fácilmente con librerías de animación de terceros (como animate.css).
Ejemplo
Pruébalo »
Usar transiciones y animaciones al mismo tiempo
Para que Vue sepa cuándo se completa la transición, debe establecerse el escuchador de eventos correspondiente. Puede sertransitionendoanimationend, esto depende de las reglas CSS aplicadas al elemento. Si usas cualquiera de ellas, Vue puede reconocer el tipo automáticamente y configurar la escucha.
Sin embargo, en algunos escenarios, necesitas configurar dos efectos de transición al mismo tiempo en el mismo elemento, por ejemploanimationse activa y finaliza muy rápido, mientras quetransitionel efecto aún no ha terminado. En este caso, necesitas usartypeel atributo y estableceranimationotransitionpara declarar explícitamente el tipo que necesitas que Vue escuche.
Duración de transición explícita
En muchos casos, Vue puede determinar automáticamente el momento de finalización del efecto de transición. De forma predeterminada, Vue espera el primertransitionendoanimationendevento. Sin embargo, también se puede configurar de otra manera; por ejemplo, podemos tener una serie de efectos de transición cuidadosamente orquestada, en la que algunos elementos internos anidados tienen efectos de transición con retraso o de mayor duración en comparación con el elemento raíz del efecto de transición.
En este caso, puedes usar<transition>en el componentedurationel atributo para personalizar una duración de transición explícita (en milisegundos):
<transition :duration="1000">...</transition>
También puedes personalizar las duraciones de entrada y salida:
<transition :duration="{ enter: 500, leave: 800 }">...</transition>
Hooks de JavaScript
Puedes declarar hooks de JavaScript en los atributos:
Código HTML:
Código JavaScript:
Estas funciones de hook se pueden usar junto con transitions/animations CSS, o también de forma independiente.
Cuando se usan solo transiciones de JavaScript,Enenteryleavese debe usardonepara realizar el callback. De lo contrario, se llamarán de forma síncrona y la transición se completará de inmediato.
Se recomienda, para elementos que usan solo transiciones de JavaScript, agregarv-bind:css="false", Vue omitirá la detección de CSS. Esto también evita la influencia de CSS durante la transición.
Un ejemplo sencillo que utiliza Velocity.js:
Ejemplo
Pruébalo »
Transición en el renderizado inicial
Se puede medianteappearel atributo para establecer la transición del nodo en el renderizado inicial
<transition appear> <!-- ... --> </transition>
Aquí, al igual que en las transiciones de entrada/salida, también se pueden personalizar los nombres de clase CSS.
<transition appear appear-class="custom-appear-class" appear-to-class="custom-appear-to-class" (2.1.8+) appear-active-class="custom-appear-active-class" > <!-- ... --> </transition>
Hooks de JavaScript personalizados:
<transition appear v-on:before-appear="customBeforeAppearHook" v-on:appear="customAppearHook" v-on:after-appear="customAfterAppearHook" v-on:appear-cancelled="customAppearCancelledHook" > <!-- ... --> </transition>
Transición de múltiples elementos
Podemos configurar transiciones para múltiples elementos, generalmente listas y descripciones:
Ten en cuenta que, al alternar entre elementos con el mismo nombre de etiqueta, es necesario usarkeyel atributo para establecer un valor único que las marque para que Vue pueda distinguirlos; de lo contrario, Vue, por eficiencia, solo reemplazará el contenido interno de la misma etiqueta.
<transition>
<table v-if="items.length > 0">
<!-- ... -->
</table>
<p v-else>抱歉,没有找到您查找的内容。</p>
</transition>
Como en el siguiente ejemplo:
<transition>
<button v-if="isEditing" key="save">
Save
</button>
<button v-else key="edit">
Edit
</button>
</transition>
En algunos escenarios, también se puede, al darle al mismo elemento unkeyatributo para establecer diferentes estados en lugar dev-ifyv-else, el ejemplo anterior se puede reescribir como:
<transition>
<button v-bind:key="isEditing">
{{ isEditing ? 'Save' : 'Edit' }}
</button>
</transition>
Usando múltiplesv-iflas transiciones de múltiples elementos se pueden reescribir como una transición de un solo elemento con atributos dinámicos. Por ejemplo:
<transition>
<button v-if="docState === 'saved'" key="saved">
Edit
</button>
<button v-if="docState === 'edited'" key="edited">
Save
</button>
<button v-if="docState === 'editing'" key="editing">
Cancel
</button>
</transition>
Se puede reescribir como:
<transition>
<button v-bind:key="docState">
{{ buttonMessage }}
</button>
</transition>
// ...
computed: {
buttonMessage: function () {
switch (this.docState) {
case 'saved': return 'Edit'
case 'edited': return 'Save'
case 'editing': return 'Cancel'
}
}
}
Otras extensiones