MDN self-hosted library · e01.org

ViewTransition: transitionRoot property

View Transition API

Open notebook · 1 cells web-api-instance-property upstream source

View Transition API

The transitionRoot read-only property of the ViewTransition interface is a reference to the root Element of the view transition scope.

Value

An Element.

  • For document-scoped view transitions, transitionRoot is a reference to the Document.documentElement property, which for standard web documents is a reference to the html element.
  • For element-scoped view transitions, transitionRoot is a reference to the Element that startViewTransition() was called on to create the view transition.

Examples

Basic usage

This snippet shows how to use transitionRoot to retrieve a reference to the element the view transition was created on.

const myElement = document.querySelector(".my-element");

// ...

function handleVT() {
  const vt = myElement.startViewTransition(() => {
    updateDOMSomehow();
  });

  // ...

  // Returns reference to myElement
  vt.transitionRoot;
}

Specifications

Browser compatibility

See also