В реестре npm вышел релиз библиотеки React 19.3, подготовленный командой React в Meta (обзор выпустил Сэм Селикофф при участии Мэтта Кэрролла, Дэна Абрамова и Эндрю Кларка), а практический сценарий группового фокуса показал канал «Библиотека фронтендера». За номером минорной версии скрывается переход в стабильный стандарт двух механизмов, которые давно просились в повседневную вёрстку: прямой передачи ссылки ref виртуальному компоненту <Fragment> и декларативных анимаций через <ViewTransition>.
Меня в этом обновлении зацепило то, как просто инженеры помирили управление фокусом с чистой CSS-разметкой. Зачем передавать ref на невидимый фрагмент, которого нет в итоговом дереве браузера, и как это избавляет формы от лишних тегов-обёрток? Разберём это на рабочей задаче — панели фильтрации каталога товаров с полем поиска, чекбоксом наличия и кнопками, куда пользователь переходит по клику на внешнюю кнопку быстрого доступа.
Почему лишний <div> ломает сетку CSS Grid и таблицы ради одной ссылки ref
Когда ты верстаешь панель фильтров каталога, расположение элементов опирается на двумерную сетку CSS Grid или таблицу. Это как органайзер с размеченными ячейками: в первой лежит строка поиска, во второй — чекбокс «Только товары в наличии», в третьей — кнопка подтверждения. Браузер вычисляет ширину каждой ячейки напрямую от родительского контейнера .filters-grid.
Допустим, сверху на странице есть кнопка «Перейти к заполнению фильтров» для быстрой навигации с клавиатуры. По клику на неё курсор должен сразу встать в первое активное поле панели. В React для прямого обращения к элементу используется ссылка ref — программный «пульт управления», привязанный к узлу в объектной модели документа (DOM). Но как быть, если внутри фильтра лежит группа полей или дочерние компоненты из библиотеки, которые не принимают внешний ref?
Раньше приходилось оборачивать группу инпутов в технический <div> или <span> только ради того, чтобы прицепить к нему ref и искать внутри первое поле. Для CSS Grid или таблиц (<table>, <tr>, <td>) такая обёртка работает как лишняя картонная коробка в органайзере: вместо трёх независимых ячеек сетка видит один общий блок, все контролы сваливаются в первую колонку, а вёрстка едет. Пустой фрагмент <>...</> сохранял сетку чистой, потому что растворяется при рендере, но повесить на него ref было нельзя — в браузере у него нет физического узла.
Как устроен FragmentInstance и как метод focus() находит первое поле
В версии 19.3 явному компоненту <Fragment> разрешили принимать проп ref. Поскольку собственного HTML-тега у фрагмента нет, в ref.current записывается виртуальный диспетчер — экземпляр класса FragmentInstance. Если сравнить страницу с этажом офиса, раньше для управления группой кабинетов приходилось городить вокруг них фальшивую перегородку с общей дверью. Теперь же FragmentInstance действует как консьерж со списком дочерних комнат первого уровня: перегородки нет, сетка не тронута, но команды отдаются всей группе сразу:
- Управление фокусом (
focus(),focusLast(),blur()): вызовfocus()выполняет обход дочернего поддерева в глубину (depth-first — проверку веток сверху вниз и слева направо) и ставит курсор в первый интерактивный элемент (<input>,<button>,<a href>). МетодfocusLast()фокусирует последний контрол группы, аblur()снимает фокус внутри фрагмента. - События и геометрия (
addEventListener(),dispatchEvent(),getClientRects(),scrollIntoView()): вешают слушатели на все узлы первого уровня, измеряют координаты и прокручивают окно к первому видимому блоку. - Наблюдатели (
observeUsing(),unobserveUsing()): в один вызов подключаютIntersectionObserverилиResizeObserverко всем дочерним элементам без ручного цикла.
Вот как выглядит наша панель фильтрации каталога, где кнопка быстрого перехода переводит курсор в поле поиска без промежуточных тегов внутри .filters-grid:
import { Fragment, useRef, useState } from 'react';
export function ProductCatalogFilters() {
const filterInputsRef = useRef(null);
const [query, setQuery] = useState('');
const [inStockOnly, setInStockOnly] = useState(false);
return (
<section className="catalog-toolbar">
<button type="button" onClick={() => filterInputsRef.current?.focus()}>
Перейти к заполнению фильтров
</button>
<div className="filters-grid">
<Fragment ref={filterInputsRef}>
<input
type="search"
placeholder="Поиск по названию..."
value={query}
onChange={(e) => setQuery(e.target.value)}
aria-label="Поиск по каталогу"
/>
<label className="checkbox-field">
<input
type="checkbox"
checked={inStockOnly}
onChange={(e) => setInStockOnly(e.target.checked)}
/>
Только товары в наличии
</label>
<button type="button">Применить</button>
</Fragment>
</div>
</section>
);
}
Здесь мы пишем полное имя <Fragment ref={filterInputsRef}>, так как сокращённая запись <>...</> не принимает атрибуты. В браузере внутри .filters-grid рендерятся ровно три прямых потомка (<input>, <label> и <button>), поэтому колонки CSS Grid сохраняют задуманную геометрию. По клику на кнопку вызов filterInputsRef.current?.focus() обращается к FragmentInstance и ставит курсор в строку поиска, а если бы первый инпут имел атрибут disabled, обход в глубину сам бы перевёл фокус на чекбокс наличия. При этом помни: FragmentInstance — не DOM-узел, поэтому чтение filterInputsRef.current.style или tagName вернёт undefined. Заодно в 19.3 закрыли утечку памяти в слушателях фрагмента, нормализовав опции capture по стандарту DOM.
Стабильный <ViewTransition>: нативные анимации переходов без лагов ввода
Когда пользователь отметил фильтр наличия, список товаров перестраивается. Чтобы карточки не моргали резко, в React 19.3 стабилизировали компонент <ViewTransition> поверх нативного браузерного View Transitions API. Перед обновлением узлов (механику сопоставления дерева мы разбирали в статье об алгоритме сверки Reconciliation) браузер делает снимок старого состояния и плавно сводит его с новым через мягкий cross-fade.
Анимация включается только для несрочных обновлений внутри startTransition(), при раскрытии <Suspense> или через useDeferredValue(), поэтому срочный ввод букв в поиск фильтра отрисовывается мгновенно без задержек. По характеру изменений React выбирает сценарий enter, exit, update или share (перелёт именованного блока на новое место), а вызов addTransitionType('next') или addTransitionType('previous') передаёт направление перехода в CSS-селектор :active-view-transition-type(...). В паре с <Suspense> настройка <ViewTransition update="auto" default="none"> выводит fallback мгновенно по клику и плавно проявляет карточку после загрузки данных, картинок <img> и шрифтов <style>, пропуская лишнюю анимацию для данных из кэша. Пока <ViewTransition> работает только в браузерном DOM.
Прямой <Context> на сервере, use(browser()) и защита Trusted Types
В серверной части и безопасности React 19.3 принёс ещё три улучшения:
- Прямой
<Context>в Server Components. Серверные компоненты теперь импортируют контекст из'use client'модуля и рендерят<UserContext value={currentUser}>{children}</UserContext>напрямую без обёрткиUserProvider, что дополняет лестницу композиции компонентов в React. - Хук
use(browser())изreact-dom. Если виджет читает часовой пояс браузера черезIntl.DateTimeFormatилиlocalStorage, вызовuse(browser())(в том числе внутриif, когда не переданdefaultValue) переводит ближайший<Suspense>на сервере в режим fallback, а на клиенте сразу рендерит браузерные данные безuseEffectи ошибок гидратации. - Поддержка Trusted Types. Для защиты от DOM XSS (
Content-Security-Policy: require-trusted-types-for 'script')react-domперестал склеивать значения с пустой строкой ('' + value) и передаёт верифицированные объектыTrustedHTMLиTrustedScriptв DOM напрямую. Кроме того, независимые Transitions больше не блокируют друг друга в очереди.
Для привязки ссылки импортируй явный Fragment из 'react' — пустые скобки <>...</> проп ref не поддерживают. В ref.current лежит виртуальный диспетчер FragmentInstance, поэтому используй его групповые методы (focus(), focusLast(), blur(), observeUsing(), addEventListener()), а не свойства HTML-тегов.
Проверить обновление в деле можно прямо сегодня за пару минут: выполни npm install react@19.3.0 react-dom@19.3.0 (нужен Node.js 18.18+ или 20.9+), найди в проекте форму или CSS Grid, где вокруг группы полей стоит вынужденный <div> ради удержания ref, и замени его на <Fragment ref={...}> с вызовом .focus(). Ты сразу очистишь DOM-дерево от лишней обёртки и сохранишь чистую сетку стилей.



