::view-transition-group

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The ::view-transition-group CSS pseudo-element represents a single view transition group.

During a view transition, ::view-transition-group is included in the associated pseudo-element tree as explained in The view transition process. It is only ever a child of ::view-transition, and has a ::view-transition-image-pair as a child.

::view-transition-group is given the following default styling in the UA stylesheet:

css
html::view-transition-group(*) {
  position: absolute;
  top: 0;
  left: 0;

  animation-duration: 0.25s;
  animation-fill-mode: both;
}

By default, selected elements initially mirror the size and position of the ::view-transition-old pseudo-element representing the "old" view state, or the ::view-transition-new pseudo-element representing the "new" view state if there isn't an "old" view state.

If there's both an "old" and "new" view state, styles in the view transition style sheet animate this pseudo-element's width and height from the size of the "old" view state's border box to that of the "new" view state's border box.

Note: View transition style sheet styles are dynamically generated during the view transition; see the specification setup transition pseudo-elements and update pseudo-element styles sections for more details.

In addition, the element's transform is animated from the "old" view state's screen space transform to the new view state's screen space transform. This style is generated dynamically since the values of animated properties are determined at the time that the transition begins.

Syntax

css
::view-transition-group(<pt-name-selector>) {
  /* ... */
}

<pt-name-selector> can be one of the following values:

*

Causes the pseudo-element to match all view transition groups.

root

Causes the pseudo-element to match the default root view transition group created by the user agent to contain the view transition for the overall page, meaning any element not assigned to its own specific view transition group via the view-transition-name property.

<custom-ident>

Causes the pseudo-element to match a specific view transition group created by assigning the given <custom-ident> to an element via the view-transition-name property.

Examples

css
view-transition-group(embed-container) {
  animation-duration: 0.3s;
  animation-timing-function: ease;
  z-index: 1;
}

Specifications

Specification
CSS View Transitions Module Level 1
# ::view-transition-group

Browser compatibility

BCD tables only load in the browser

See also