You are browsing Nuxt 2 docs. Go to Nuxt 3 docs, or learn more about Nuxt 2 Long Term Support.

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