Vue.js Übergänge & Animation

In diesem Kapitel behandeln wir hauptsächlich Vue.js-Übergangseffekte und Animationseffekte.


Übergänge

Vue bietet verschiedene Möglichkeiten, Übergangseffekte anzuwenden, wenn DOM-Elemente eingefügt, aktualisiert oder entfernt werden.

Vue bietet eine integrierte Transition-Wrapper-Komponente, die verwendet wird, um Komponenten zu umschließen, die Übergangseffekte benötigen.

Syntaxformat

<transition name = "nameoftransition">
   <div></div>
</transition>

Anhand des folgenden Beispiels können wir verstehen, wie Vues Transitionen implementiert werden:

Beispiel

<div id = "databinding"> <button v-on:click = "show = !show">Klick mich</button> <transition name = "fade"> <p v-show = "show" v-bind:style = "styleobj">Animationsbeispiel</p> </transition> </div> <script type = "text/javascript"> var vm = new Vue({ el: '#databinding', data: { show:true, styleobj :{ fontSize:'30px', color:'red' } }, methods : { } }); </script>

Ausprobieren »

Im Beispiel ändert ein Klick auf die Schaltfläche "Click me" die Variable show von true in false. Wenn sie true ist, wird der Inhalt des untergeordneten p-Tags angezeigt.

Der folgende Code zeigt, dass das transition-Tag das p-Tag umschließt:

<transition name = "fade">
    <p v-show = "show" v-bind:style = "styleobj">动画实例</p>
</transition>

Eine Transition ist im Wesentlichen ein Ein- und Ausblendeffekt. Vue bietet 6 Klassen zum Umschalten, wenn Elemente angezeigt und ausgeblendet werden:

  • v-enter: Definiert den Startzustand des Enter-Übergangs. Er wird vor dem Einfügen des Elements angewendet und ein Frame nach dem Einfügen des Elements entfernt.

  • v-enter-active: Definiert den Zustand, wenn der Enter-Übergang aktiv ist. Er wird während der gesamten Phase des Enter-Übergangs angewendet, wirkt vor dem Einfügen des Elements und wird nach Abschluss des Übergangs/der Animation entfernt. Diese Klasse kann verwendet werden, um die Dauer, Verzögerung und Easing-Funktion des Enter-Übergangs zu definieren.

  • v-enter-to: Version 2.1.8 und höherDefiniert den Endzustand des Enter-Übergangs. Er wird ein Frame nach dem Einfügen des Elements wirksam (gleichzeitigv-enterwird entfernt), und wird nach Abschluss des Übergangs/der Animation entfernt.

  • v-leave: Definiert den Startzustand des Leave-Übergangs. Er wird sofort wirksam, wenn der Leave-Übergang ausgelöst wird, und ein Frame später entfernt.

  • v-leave-active: Definiert den Zustand, wenn der Leave-Übergang aktiv ist. Er wird während der gesamten Phase des Leave-Übergangs angewendet, wirkt sofort, wenn der Leave-Übergang ausgelöst wird, und wird nach Abschluss des Übergangs/der Animation entfernt. Diese Klasse kann verwendet werden, um die Dauer, Verzögerung und Easing-Funktion des Leave-Übergangs zu definieren.

  • v-leave-to: Version 2.1.8 und höherDefiniert den Endzustand des Leave-Übergangs. Er wird einen Frame nach dem Auslösen des Leave-Übergangs wirksam (zur gleichen Zeitv-leavewird entfernt), und wird nach Abschluss des Übergangs/der Animation entfernt.

Für diese Klassennamen, die während Übergängen wechseln, wenn Sie ein unbenanntes<transition>, dannv-ist das Standardpräfix für diese Klassennamen. Wenn Sie<transition name="my-transition">, dannv-enterwird ersetzt durchmy-transition-enter。

v-enter-activeundv-leave-activekönnen die verschiedenen Easing-Kurven von Enter-/Leave-Übergängen steuern; ein Beispiel wird im folgenden Abschnitt gegeben.

CSS-Übergänge

Normalerweise verwenden wir CSS-Übergänge, um Effekte zu erzielen.

Wie im folgenden Beispiel:

Beispiel

<div id = "databinding"> <button v-on:click = "show = !show">Klick mich</button> <transition name="slide-fade"> <p v-if="show">hello</p> </transition> </div> <script type = "text/javascript"> new Vue({ el: '#databinding', data: { show: true } }) </script>

Ausprobieren »

CSS-Animationen

CSS-Animationen werden ähnlich wie CSS-Übergänge verwendet, aber bei Animationen wird der Klassenname v-enter nicht sofort entfernt, nachdem der Knoten in das DOM eingefügt wurde; er wird entfernt, wenn das animationend-Ereignis ausgelöst wird.

Beispiel

<div id = "databinding"> <button v-on:click = "show = !show">Klick mich</button> <transition name="bounce"> <p v-if="show">Beispiel-Tutorial -- Beim Lernen geht es nicht nur um Technologie, sondern auch um Träume!!!</p> </transition> </div> <script type = "text/javascript"> new Vue({ el: '#databinding', data: { show: true } }) </script>

Ausprobieren »

Benutzerdefinierte Übergangsklassennamen

Wir können Transitions-Klassennamen über die folgenden Attribute anpassen:

  • enter-class
  • enter-active-class
  • enter-to-class (2.1.8+)
  • leave-class
  • leave-active-class
  • leave-to-class (2.1.8+)

Benutzerdefinierte Transitions-Klassennamen haben eine höhere Priorität als gewöhnliche Klassennamen, sodass sie gut mit Animationsbibliotheken von Drittanbietern (wie animate.css) kombiniert werden können.

Beispiel

<div id = "databinding"> <button v-on:click = "show = !show">Klick mich</button> <transition name="custom-classes-transition" enter-active-class="animated tada" leave-active-class="animated bounceOutRight" > <p v-if="show">Beispiel-Tutorial -- Beim Lernen geht es nicht nur um Technologie, sondern auch um Träume!!!</p> </transition> </div> <script type = "text/javascript"> new Vue({ el: '#databinding', data: { show: true } }) </script>

Ausprobieren »

Transitions und Animationen zusammen verwenden

Damit Vue weiß, dass eine Transition abgeschlossen ist, muss es den entsprechenden Event-Listener einrichten. Er kanntransitionendoderanimationend, abhängig von den CSS-Regeln, die auf das Element angewendet werden. Wenn Sie eine der beiden verwenden, kann Vue den Typ automatisch erkennen und den Listener einrichten.

In einigen Szenarien müssen Sie jedoch zwei Transitionseffekte gleichzeitig auf dasselbe Element anwenden, wie z. B.animationwird sehr schnell ausgelöst und abgeschlossen, währendtransitionder Effekt noch nicht beendet ist. In diesem Fall müssen Sietypedas Attribut festlegen undanimationodertransitionden Typ explizit angeben, den Vue überwachen soll.

Explizite Übergangsdauern

In vielen Fällen kann Vue automatisch bestimmen, wann der Übergangseffekt abgeschlossen ist. Standardmäßig wartet Vue auf das erstetransitionendoderanimationendEreignis. Es ist jedoch auch möglich, es anders festzulegen – zum Beispiel können wir eine aufwendig choreografierte Abfolge von Übergangseffekten haben, bei der einige verschachtelte innere Elemente verzögerte oder längere Übergänge im Vergleich zum Wurzelelement des Übergangseffekts aufweisen.

In diesem Fall können Sie<transition>auf der Komponentedurationdas Attribut verwenden, um eine explizite Übergangsdauer (in Millisekunden) festzulegen:

<transition :duration="1000">...</transition>

Sie können auch die Dauer für das Eintreten und Verlassen anpassen:

<transition :duration="{ enter: 500, leave: 800 }">...</transition>

JavaScript-Hooks

Sie können JavaScript-Hooks in Attributen deklarieren:

HTML-Code:

<transition v-on:before-enter="beforeEnter" v-on:enter="enter" v-on:after-enter="afterEnter" v-on:enter-cancelled="enterCancelled" v-on:before-leave="beforeLeave" v-on:leave="leave" v-on:after-leave="afterLeave" v-on:leave-cancelled="leaveCancelled" > <!-- ... --> </transition>

JavaScript-Code:

// ... methods: { // -------- //Eintreten // -------- beforeEnter: function (el) { // ... }, //Diese Callback-Funktion ist optional. //Wird in Kombination mit CSS verwendet. enter: function (el, done) { // ... done() }, afterEnter: function (el) { // ... }, enterCancelled: function (el) { // ... }, // -------- //Verlassen // -------- beforeLeave: function (el) { // ... }, //Diese Callback-Funktion ist optional. //Wird in Kombination mit CSS verwendet. leave: function (el, done) { // ... done() }, afterLeave: function (el) { // ... }, //leaveCancelled wird nur in v-show verwendet. leaveCancelled: function (el) { // ... } }

Diese Hook-Funktionen können in Kombination mit CSS-Übergängen/-Animationen oder allein verwendet werden.

Wenn nur JavaScript-Übergänge verwendet werden,Inenterundleavemuss verwendet werden indonefür den Callback. Andernfalls werden sie synchron aufgerufen, und der Übergang wird sofort abgeschlossen.

Es wird empfohlen, hinzuzufügenv-bind:css="false", überspringt Vue die CSS-Erkennung. Dies vermeidet auch den Einfluss von CSS während des Übergangsprozesses.

Ein einfaches Beispiel mit Velocity.js:

Beispiel

<div id = "databinding"> <button v-on:click = "show = !show">Klick mich</button> <transition v-on:before-enter="beforeEnter" v-on:enter="enter" v-on:leave="leave" v-bind:css="false" > <p v-if="show">Beispiel-Tutorial -- Beim Lernen geht es nicht nur um Technologie, sondern auch um Träume!!!</p> </transition> </div> <script type = "text/javascript"> new Vue({ el: '#databinding', data: { show: false }, methods: { beforeEnter: function (el) { el.style.opacity = 0 el.style.transformOrigin = 'left' }, enter: function (el, done) { Velocity(el, { opacity: 1, fontSize: '1.4em' }, { duration: 300 }) Velocity(el, { fontSize: '1em' }, { complete: done }) }, leave: function (el, done) { Velocity(el, { translateX: '15px', rotateZ: '50deg' }, { duration: 600 }) Velocity(el, { rotateZ: '100deg' }, { loop: 2 }) Velocity(el, { rotateZ: '45deg', translateY: '30px', translateX: '30px', opacity: 0 }, { complete: done }) } } }) </script>

Ausprobieren »

Übergänge beim initialen Rendern

Sie könnenappearAttribut, um den Übergang des Knotens beim initialen Rendern festzulegen.

<transition appear>
  <!-- ... -->
</transition>

Der Standardwert hier ist derselbe wie bei Enter-/Leave-Übergängen, und Sie können auch CSS-Klassennamen anpassen.

<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>

Benutzerdefinierte JavaScript-Hooks:

<transition
  appear
  v-on:before-appear="customBeforeAppearHook"
  v-on:appear="customAppearHook"
  v-on:after-appear="customAfterAppearHook"
  v-on:appear-cancelled="customAppearCancelledHook"
>
  <!-- ... -->
</transition>

Übergänge für mehrere Elemente

Wir können Übergänge für mehrere Elemente festlegen, in der Regel eine Liste und Beschreibung:

Es ist zu beachten, dass Sie beim Umschalten von Elementen mit demselben Tag-Namen daskeyAttribut verwenden müssen, um einen eindeutigen Wert festzulegen, mit dem sie markiert werden, damit Vue sie unterscheiden kann; andernfalls ersetzt Vue aus Effizienzgründen nur den Inhalt innerhalb desselben Tags.

<transition>
  <table v-if="items.length > 0">
    <!-- ... -->
  </table>
  <p v-else>抱歉,没有找到您查找的内容。</p>
</transition>

Wie im folgenden Beispiel:

<transition>
  <button v-if="isEditing" key="save">
    Save
  </button>
  <button v-else key="edit">
    Edit
  </button>
</transition>

In einigen Szenarien können Sie auch daskeyAttribut verwenden, um verschiedene Zustände festzulegen, um zu ersetzenv-ifundv-else, das obige Beispiel kann wie folgt umgeschrieben werden:

<transition>
  <button v-bind:key="isEditing">
    {{ isEditing ? 'Save' : 'Edit' }}
  </button>
</transition>

Die Verwendung mehrererv-ifÜbergänge von mehreren Elementen können als ein einzelner Elementübergang umgeschrieben werden, der an ein dynamisches Attribut gebunden ist. Zum Beispiel:

<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>

kann umgeschrieben werden als:

<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'
    }
  }
}
Andere Erweiterungen