CSS Transitions can be handled by the Vue Transition Component. The transitions are used for entering (appearing) or leaving (disappearing) animations.
However, Quasar can supply a big list of ready to use CSS animations. The animation effects are borrowed from Animate.css. So there are 80+ animation types available for you to use out of the box. Check the list either on Animate.css website or on the demo available for this page.
Please refer to Vue documentation for learning on how to use the Vue supplied
<transition>
component.
Installation
Edit /quasar.conf.js
.
// embedding all animations
animations: 'all'
// or embedding only specific animations
animations: [
'bounceInLeft',
'bounceOutRight'
]
If you are building a website, you can also skip configuring quasar.conf.js and use a CDN link which points to Animate.css like this (following is just an example, Google for latest link). Remember this will require an Internet connection for your user, as opposed to bundling from within quasar.conf.js.
<!-- src/index.template.html -->
<head>
...
<!-- CDN example for Animate.css -->
<link
rel="stylesheet"
href="https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.0.0/animate.min.css"
>
</head>
WARNING
It should be noted that when you import Animate.css through the <link>
tag, all animation CSS classes must be prefixed with animate__
. This is a breaking change in the migration of Animate.css from v3 to v4. If you want to avoid using prefixes, you can import the compat version. However, if you’re using the Quasar CLI, no additional changes are needed.
Usage
Notice the string “animated” in front of the actual animation name.
<!-- Example with wrapping only one DOM element / component -->
<transition
appear
enter-active-class="animated fadeIn"
leave-active-class="animated fadeOut"
>
<!-- Wrapping only one DOM element, defined by QBtn -->
<q-btn
color="secondary"
icon="mail"
label="Email"
/>
</transition>
Wrapping Multiple Elements
You can also group components or DOM elements in a transition so that the same effects are applied to all of them simultaneously.
<!-- Example with wrapping multiple DOM elements / components -->
<transition-group
appear
enter-active-class="animated fadeIn"
leave-active-class="animated fadeOut"
>
<!-- We wrap a "p" tag and a QBtn -->
<p key="text">
Lorem Ipsum
</p>
<q-btn
key="email-button"
color="secondary"
icon="mail"
label="Email"
/>
</transition-group>
Please note some things in the above example:
- Note
<transition-group>
instead of<transition>
. - The components and DOM elements must be keyed, like
key="text"
orkey="email-button"
in the example above. - Both examples above have the Boolean property
appear
specified, which makes the entering animation kick in right after component(s) have been rendered. This property is optional.