Nuxt 2 reached end of life on 30 June 2024
It no longer receives bug fixes or security patches. Upgrade to Nuxt 4 or get extended support from HeroDevs

Transition Properties

Set the default properties of the page and layout transitions.

The pageTransition Property

Nuxt v2.7.0 introduces key "pageTransition" in favor of the "transition" key to consolidate the naming with layout transition keys.
  • Type: String or Object
Used to set the default properties of the page transitions.

Default:

{
  name: 'page',
  mode: 'out-in'
}
nuxt.config.js
export default {
  pageTransition: 'page'
  // or
  pageTransition: {
    name: 'page',
    mode: 'out-in',
    beforeEnter (el) {
      console.log('Before enter...');
    }
  }
}

The transition key in nuxt.config.js is used to set the default properties for the page transitions. To learn more about the available keys when the transition key is an object, see the pages transition property.

The layoutTransition Property

  • Type: String or Object
Used to set the default properties of the layout transitions. The value provided in the name option is configured to work with the name provided in layout from your layouts folder.

Default:

{
  name: 'layout',
  mode: 'out-in'
}
nuxt.config.js
export default {
  layoutTransition: 'layout'
  // or
  layoutTransition: {
    name: 'layout',
    mode: 'out-in'
  }
}
assets/main.css
.layout-enter-active,
.layout-leave-active {
  transition: opacity 0.5s;
}
.layout-enter,
.layout-leave-active {
  opacity: 0;
}