useTransition

const [isPending, startTransition] = useTransition()

• Referencia
  • useTransition()
  • Función startTransition
• Uso
  • Perform non-blocking updates with Actions
  • Exposing action prop from components
  • Displaying a pending visual state
  • Evitar indicadores de carga no deseados
  • Construir un enrutador preparado para Suspense
  • Displaying an error to users with an error boundary
• Solución de problemas
  • No funciona la actualización de una entrada en una Transición
  • React no trata mi actualización de estado como una Transición
  • React doesn’t treat my state update after await as a Transition
  • Quiero llamar a useTransition desde fuera de un componente
  • La función que paso a startTransition se ejecuta inmediatamente
  • My state updates in Transitions are out of order

Referencia

useTransition()

Llama a useTransition en el nivel superior de tu componente para marcar algunas actualizaciones de estado como Transiciones.

import { useTransition } from 'react';

function TabContainer() {
  const [isPending, startTransition] = useTransition();
  // ...
}

Ver más ejemplos abajo.

Parámetros

useTransition no recibe ningun parámetro.

Devuelve

useTransition devuelve un array con exactamente dos elementos:

1. isPending que indica si hay una Transición pendiente.
2. startTransition function que permite marcar actualizaciones como una Transición.

Función startTransition

La función startTransition devuelta por useTransition permite marcar una actualización de estado como una Transición.

function TabContainer() {
  const [isPending, startTransition] = useTransition();
  const [tab, setTab] = useState('about');

  function selectTab(nextTab) {
    startTransition(() => {
      setTab(nextTab);
    });
  }
  // ...
}

function SubmitButton({ submitAction }) {
  const [isPending, startTransition] = useTransition();

  return (
    <button
      disabled={isPending}
      onClick={() => {
        startTransition(async () => {
          await submitAction();
        });
      }}
    >
      Submit
    </button>
  );
}

Parameters

• action: A function that updates some state by calling one or more set functions. React calls action immediately with no parameters and marks all state updates scheduled synchronously during the action function call as Transitions. Any async calls that are awaited in the action will be included in the Transition, but currently require wrapping any set functions after the await in an additional startTransition (see Troubleshooting). State updates marked as Transitions will be non-blocking and will not display unwanted loading indicators.

Devuelve

startTransition no devuelve nada.

Advertencias

• useTransition es un Hook, por lo que sólo puede ser llamado dentro de componentes o Hooks personalizados. Si necesitas iniciar una Transición en otro lugar (por ejemplo, desde una biblioteca de datos), llama a la función independiente startTransition en su lugar.

• Puedes envolver una actualización en una Transición sólo si tienes acceso a la función set de ese estado. Si deseas iniciar una Transición en respuesta a alguna prop o algún valor de un Hook personalizado, prueba useDeferredValue en su lugar.

• The function you pass to startTransition is called immediately, marking all state updates that happen while it executes as Transitions. If you try to perform state updates in a setTimeout, for example, they won’t be marked as Transitions.

• You must wrap any state updates after any async requests in another startTransition to mark them as Transitions. This is a known limitation that we will fix in the future (see Troubleshooting).

• La función startTransition tiene una identidad estable, por lo que a menudo verás que se omite de las dependencias de los Efectos, pero que se incluya no causa que el Efecto se dispare. Si el linter te permite omitir una dependencia sin errores, es seguro hacerlo. Aprende más sobre eliminar dependencias de los Efectos.

• Una actualización de estado marcada como Transición será interrumpida por otras actualizaciones de estado. Por ejemplo, si actualizas un componente gráfico dentro de una Transición, pero luego empiezas a escribir en un input mientras el gráfico está en medio de un rerenderizado, React reiniciará el trabajo de renderizado en el componente gráfico después de gestionar la actualización del input.

• Las actualizaciones de Transición no pueden utilizarse para controlar las entradas de texto.

• Si hay varias Transiciones en curso, React las agrupa. Se trata de una limitación que podría eliminarse en una versión futura.

Uso

Perform non-blocking updates with Actions

Call useTransition at the top of your component to create Actions, and access the pending state:

import {useState, useTransition} from 'react';

function CheckoutForm() {
  const [isPending, startTransition] = useTransition();
  // ...
}

useTransition devuelve un array con exactamente dos elementos:

1. isPending flag que te indica si hay una Transición pendiente.
2. startTransition function que te permite crear una Acción.

Para iniciar una Transición pasa una función a