re:re:actable
Урок 104 минуты чтения

React 19.3: ViewTransition, Fragment Refs и browser()

На этой странице
Кратко

React 19.3 (сентябрь 2026) сделал стабильными <ViewTransition> — декларативные анимации появления, исчезновения, перемещения и «перелёта» элементов на основе браузерного View Transition API, — и Fragment Refs: ref на <Fragment> даёт объект FragmentInstance для работы с DOM-детьми фрагмента как с группой (фокус, слушатели событий, IntersectionObserver, измерения). Новый API browser() из react-dom вместе с use помечает компонент как «только для браузера»: на сервере он приостанавливается и рендерится fallback ближайшего Suspense. Также: поддержка Trusted Types, <Context value> прямо в Server Components, независимый рендер параллельных transitions. Анимации <ViewTransition> срабатывают только для transition-обновлений (startTransition, раскрытие Suspense, useDeferredValue), срочные обновления не анимируются.

Вопрос

Что нового в React 19.3? Как работают <ViewTransition>, Fragment Refs и browser()?

ViewTransition: анимации без библиотек

import { ViewTransition, startTransition, useState } from 'react';
 
function BookDetails({ book }) {
  return (
    <ViewTransition>
      <article className="details">{book.description}</article>
    </ViewTransition>
  );
}
 
export function Shelf({ books }) {
  const [openId, setOpenId] = useState(null);
 
  return books.map((book) => (
    <div key={book.id}>
      <button onClick={() => startTransition(() => setOpenId(openId === book.id ? null : book.id))}>
        {book.title}
      </button>
      {openId === book.id && <BookDetails book={book} />} {/* enter/exit анимируются */}
    </div>
  ));
}
Тип анимацииКогда
enter<ViewTransition> появился в дереве
exitУдалён
updateИзменились стили или содержимое детей
shareИменованный <ViewTransition name="…"> удалён в одном месте и добавлен в другом (эффект «перелёта» карточки в детальную страницу)

По умолчанию — плавный cross-fade. Настраивается CSS-классами (enter="slide-in") или императивно через onEnter, onExit, onUpdate, onShare (Web Animations API).

Разные анимации по причине перехода

import { addTransitionType, startTransition } from 'react';
 
function next() {
  startTransition(() => {
    addTransitionType('next');
    setPage((p) => p + 1);
  });
}
 
<ViewTransition
  enter={{ next: 'from-right', previous: 'from-left' }}
  exit={{ next: 'to-left', previous: 'to-right' }}
>
  <Page />
</ViewTransition>

Плавное раскрытие Suspense

<ViewTransition update="auto" default="none">
  <Suspense fallback={<ReviewsSkeleton />}>
    <Reviews />
  </Suspense>
</ViewTransition>

Анимируется только замена скелетона на контент. Если обернуть в <ViewTransition> картинки и шрифты, Suspense дождётся их загрузки — меньше «мигания».

Подсказка

Учитывай prefers-reduced-motion: отключай или сокращай анимации в CSS для пользователей, которые просят меньше движения.

Fragment Refs

import { Fragment, useEffect, useRef } from 'react';
 
function SearchResults({ results }) {
  const fragmentRef = useRef(null);
 
  useEffect(() => {
    fragmentRef.current.focus(); // фокус на первый фокусируемый элемент среди детей
    const io = new IntersectionObserver(onVisible);
    fragmentRef.current.observeUsing(io); // наблюдать за всеми детьми фрагмента
    return () => fragmentRef.current?.unobserveUsing(io);
  }, [results]);
 
  return (
    <Fragment ref={fragmentRef}>
      {results.map((r) => <ResultCard key={r.id} result={r} />)}
    </Fragment>
  );
}
Метод FragmentInstanceДля чего
addEventListener / removeEventListener / dispatchEventСлушатели на детях первого уровня
focus, focusLast, blurУправление фокусом в группе
observeUsing / unobserveUsingIntersectionObserver, ResizeObserver для всех детей
getClientRects, scrollIntoView, compareDocumentPositionИзмерения и прокрутка

Раньше для этого приходилось добавлять лишний обёрточный div (ломая flex/grid-раскладку или семантику списка) или требовать от каждого дочернего компонента пробрасывать ref.

browser(): компонент только для клиента

import { Suspense, use } from 'react';
import { browser } from 'react-dom';
 
function LocalTime({ date }) {
  use(browser()); // на сервере — suspend, в HTML уйдёт fallback
  return <time>{date.toLocaleString()}</time>; // часовой пояс пользователя
}
 
<Suspense fallback={<time>—</time>}>
  <LocalTime date={publishedAt} />
</Suspense>

Заменяет обходные пути вроде «useEffect + useState(isClient)», которые давали лишний рендер, а при ошибке — несовпадение гидратации. Можно вызывать условно: например, только если не передан defaultValue. Полезно для localStorage, matchMedia, локального времени, браузерных SDK.

Другие изменения

  • Trusted Types: React передаёт TrustedHTML и другие доверенные объекты в DOM без превращения в строку — совместимо с CSP require-trusted-types-for 'script'.
  • Server Components могут рендерить <Context value> из клиентского модуля напрямую, без отдельного клиентского провайдера.
  • Медленный transition больше не блокирует несвязанные transitions.
  • В Strict Mode эффекты дважды вызываются и при гидратации.
  • Error.cause и AggregateError.errors передаются с сервера на клиент.

Мини-шпаргалка

<ViewTransition> — enter/exit/update/share, только для transition-обновлений
addTransitionType('next') — разные анимации по причине
update="auto" default="none" — анимация раскрытия Suspense
<Fragment ref> → FragmentInstance: focus, observeUsing, addEventListener
use(browser()) — client-only компонент с fallback на сервере
Trusted Types, <Context> в RSC

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам