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 / unobserveUsing | IntersectionObserver, 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 без превращения в строку — совместимо с CSPrequire-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