Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

view-transition-name — asignar un nombre a un elemento en una transición de vista

La propiedad view-transition-name marca un elemento para capturarlo de forma independiente durante una transición de vista. Los nombres coincidentes emparejan sus estados visuales antiguo y nuevo; la declaración por sí sola no inicia una transición.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

view-transition-name: none | <custom-ident> | auto | match-element;

view-transition-name permite animar un elemento capturado de forma independiente al resto de la página. Su valor inicial es none; no se hereda. none desactiva la captura independiente, pero no elimina el elemento de la imagen de un antecesor capturado.

Un identificador personalizado como card empareja los estados visuales antiguo y nuevo, aunque pertenezcan a nodos DOM distintos. El nombre debe ser único entre los elementos capturados simultáneamente durante la transición; los duplicados interrumpen la animación, pero no la propia actualización del DOM. Personaliza el grupo con ::view-transition-group(card).

El borrador de nivel 2 también describe match-element, que genera un nombre a partir de la identidad del elemento, y auto, que puede usar el id del elemento y, si no, genera un nombre. Estas palabras clave no son identificadores personalizados. Un borrador de especificación no garantiza la compatibilidad de los navegadores.

El ejemplo inicia una transición con document.startViewTransition() y cambia la posición de card. Si no hay compatibilidad, realiza una actualización normal. La consulta de medios prefers-reduced-motion: reduce establece la duración de la animación en 0s solo para el grupo card; la transición predeterminada del grupo root sigue activa.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>view-transition-name</title>
<style>
  #card {
    view-transition-name: card;
    width: 120px;
    padding: 16px;
    background: navy;
    color: white;
  }
  #card.moved { margin-left: 160px; }
  ::view-transition-group(card) { animation-duration: 600ms; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(card) { animation-duration: 0s; }
  }
</style>
<button id="move" type="button">Move</button>
<div id="card">A</div>
<script>
  const button = document.querySelector('#move');
  const card = document.querySelector('#card');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => card.classList.toggle('moved');
    try {
      if (document.startViewTransition &&
          CSS.supports('view-transition-name', 'card')) {
        const transition = document.startViewTransition(update);
        await transition.finished;
      } else {
        update();
      }
    } finally {
      button.disabled = false;
    }
  });
</script>

Resultado

After the first click: card.classList.contains('moved') === true. After the second completed click: false. With supported view transitions, the card changes position through its named transition group; otherwise it moves immediately.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes