View Transitions in Astro

Jeremy Frank, Former UI Development Director

Article Categories: #Code, #Front-end Engineering, #Motion

Posted on

Astro 3.0 makes it super easy to add animated transitions between two pages!

Updates

As of March ‘24, Astro 4.5 has been available with some View Transition improvements. Additionally, as of June ‘24, Chrome and Edge 126 have shipped with support for “cross-document view transitions,” which is an opt-in feature of CSS! Read more at astro.build.

Astro 3.0 was released recently and it includes some great improvements, but the most exciting feature by far is its support for the View Transitions API (MDN)! In this article, I’ll briefly introduce Astro and View Transitions, and walk through a demo which showcases how easy it is to get set up and running.

About Astro #

Astro is an all-in-one open-source web framework focused on building fast, content-focused websites, as well as web applications & APIs. It takes an HTML-first approach, outputs zero JavaScript by default, and follows an islands architecture pattern. It supports both static site generation (SSG) and server-side rendering (SSR), and also supports importing components from other UI frameworks like React, Vue, Svelte, and more. 🤯

We’ve been watching Astro since its pre-1.0 days and have been impressed with how it's developed and where it’s going. We most recently used it for a revamp of Viget Explorations and two new Explorations.

About View Transitions #

The View Transitions API provides a mechanism for creating animated transitions between two different pages, all while updating the DOM in a single step. The result is a seamless transition between pages which can help users stay in context, reducing cognitive load and improving perceived performance. Historically, this has been rather difficult to do for multi-page apps (MPAs), but the View Transitions API makes this more achievable, and Astro makes it downright easy!

Demo #

Earlier this month, Andrew Greeson and Eric Fuhrmann teamed up to build a demo (repo), which illustrates some fun possibilities with View Transitions. Be sure to check out Eric's article on the collaboration and design process for this demo. The key parts of the implementation in Astro are highlighted here.

Video showing Trail Buddy interface with view transitions.

Setup #

To get started using View Transitions in an Astro 3 codebase, you’ll need to enable it since it’s an opt-in feature. First import the ViewTransitions routing component.

import { ViewTransitions } from "astro:transitions";

Then add it to the <head> in your base layout (or shared) component.

<head>
  <title>Astro</title>
  <ViewTransitions />
</head>

Boom, you’re done! That’s all it takes to enable page transitions using a default crossfade animation! For some use-cases, the default fade animation might be all you need. There’s also a built-in slide animation. But for other cases where you need element specific transitions, as is the case for our demo, Astro provides some directives which help with that.

Transitioning Specific Elements #

We can identify any matching elements in both the grid view and the detail page as matching pairs, and seamlessly transition between the two. To accomplish this in Astro, we add the transition:name directive with a unique value to each element in both views, and make sure it has the same value for each one to bind them together. Just make sure that the value matches each instance of the matched pair.

Markup 
// index.astro
<Image
  ...
  transition:name={`avatar ${slug} image`}
/>
Markup 
// [slug].astro
<Image
  ...
  transition:name={`avatar ${slug} image`}
/>

Now our page-to-page transitions are enhanced with a linked element seamlessly transitioning from the grid view to the detail view. In order to produce a more comprehensive transition where the entire interface seems to move into place, we need to identify more elements to transition. Prime candidates are images, buttons, and backgrounds.

Persisting Video Playback #

For use cases where each view is utilizing video playback, the video element will restart after a transition has completed. In order to have videos continue to play as you navigate to another page that contains the same video element, add the transition:persist directive. This is a feature unique to Astro.

In the case of our demo, we have videos which we’ve added persistence to, however the effect is subtle since the videos themselves are short and contain small visual changes. Persistence is also helpful for components which rely on state, such as a counter or a progress bar.

Staggered Transitions #

In our detail page, there are some elements which could sequentially transition into view, as shown below.

Video showing staggered transitions in Trail Buddy

This requires some customization. Fortunately, Astro 3 has accounted for customizing animations in a few ways. The first is by importing their built-in animations and passing in any customization options. However, at the time of this writing, duration is the only property available for setting.

The second way is by allowing you to define your own animations for use within the transition:animate directive. This would be necessary for cases where you want to specify a custom delay, easing, fill mode, or custom CSS animations, and involves a few things:

  1. Defining both old and new content animation settings for both the forwards and backwards navigation.

    // components/Metadata/Value.astro
const { index } = Astro.props
const slideAnim = {
  old: {
    name: 'slideDown',
    duration: '0.3s',
    easing: 'ease-out',
    fillMode: 'backwards',
  },
  new: {
    name: 'slideUp',
    duration: '0.3s',
    delay: `${index * 0.1 + 0.1}s`,
    easing: 'ease-out',
    fillMode: 'backwards',
  },
}
const verticalSlide = {
  forwards: animSlideUp,
  backwards: animSlideUp,
}

    <!-- components/Metadata/Value.astro -->
<li transition:animate={verticalSlide}>
  ...
</li>

  2. Defining the custom CSS animations in a global style tag.

    @keyframes slideUp {
  from {
    transform: translateY(20%);
    opacity: 0;
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}
@keyframes slideDown {
  from {
    transform: translateY(0);
    opacity: 1;
  }
  to {
    opacity: 0;
    transform: translateY(20%);
  }
}

Browser Support #

As of March ‘23, View Transitions are supported in Chromium-based browsers (Chrome, Edge, and Opera), with both Safari and Firefox signaling support for the API in the near future. In the meantime, Astro’s implementation provides cross browser support via a built-in polyfill; however, it’s important to note that Firefox and Safari receive slightly different transitions which are not a 1:1 match, but still perfectly acceptable. Astro refers to this as the fallback animation, which can also be controlled with a fallback property.

Accessibility #

Using View Transitions does come with some accessibility challenges; however, the Astro team has taken measures to ensure that accessibility features are built-in. They’ve done this in two ways: by including CSS media queries using prefer-reduced-motion to disable all view transitions animations, and by including a route announcer (as of 3.2.0) which automatically announces new pages for assistive technology. No configuration is needed to enable these features. Read more about them in Astro's documentation.

Future Improvements #

View Transitions in Astro will undoubtedly receive some good updates in upcoming releases, and we have our own small list of hopeful improvements we’d like to see:

  • The ability to control the z-index of a transitioning element. In our work so far, we’ve seen some odd z-index things where elements sometimes appear like they are moving underneath other elements, when they should be moving over top of them.
  • The ability to set different animations for transitioning into and out of view. For example, fade in, and slide out.
  • Exposing additional animation properties for the built-in fade and slide animations, for example, delay, easing, direction, and fillMode. Currently, duration is the only property that you can set.

Summary #

The potential for View Transitions on the web is promising! It has the potential to level the navigation transition playing field between MPAs and mobile apps and SPAs. Astro being the first framework to include support for View Transitions (with others currently working on it), has given the feature a huge boost. Astro’s batteries-included approach of wrapping the browser primitives and providing good defaults, with accessibility built-in, will prove to be a big win for developers looking to implement View Transitions. We’re certainly hopeful for and excited to see how View Transitions will begin to be used!

Resources #

If you’re curious and would like to see some other Astro & View Transitions resources, here are the best ones we’ve seen:

Related Articles