«Хотя это большой концептуальный скачок, сам по себе Spatial CSS состоит из множества небольших доработок уже существующего синтаксиса». — Брэндел Закерник, WebKit Blog
Звучит почти дерзко, правда? Привыкаешь годами думать о 3D в браузере как о тяжёлом мире с матрицами проекций, шейдерами и отдельным рендер-циклом на JavaScript — и вдруг инженер команды WebKit говорит, что всё это можно крутить обычными CSS-правилами. В ноябрьском обновлении Safari на visionOS 27.3 Apple как раз выкатила превью для разработчиков с первыми примитивами спецификации CSS Spatial Module Level 1.
Сразу проясним рамки, чтобы не строить лишних иллюзий. Речь пока про экспериментальную песочницу за флагом CSS Portals, которую можно пощупать на гарнитуре Vision Pro или в симуляторе visionOS из Xcode. Но сама архитектура стандарта задумывалась шире одних только гарнитур: те же приёмы в будущем должны работать на телефонах, планшетах и обычных десктопах. Разберёмся вместе на реальном стенде WebKit webkids-puzzle-playground с детским сортером фигур, как новая механика устроена под капотом и почему ради неё решили перетряхнуть привычный каскад.
Зачем 3D вытаскивают из canvas в обычный CSS
Чтобы понять задумку авторов стандарта, посмотри, как трёхмерная графика живёт на сайтах сегодня. Обычно разработчик ставит на страницу элемент <canvas>, подключает тяжёлый WebGL-движок и отдаёт ему прямоугольник пикселей на откуп. Внутри этого прямоугольника можно нарисовать хоть космический корабль, хоть конфигуратор кроссовок.
Проблема в том, что для самого браузера <canvas> остаётся глухой стеклянной витриной. Всё, что происходит за стеклом, полностью оторвано от DOM-дерева и CSS. Хочешь подстроить яркость сцены под тёмную тему через @media (prefers-color-scheme)? Придётся писать обвязку на JavaScript и прокидывать события внутрь движка. Хочешь уважить настройку пользователя @media (prefers-reduced-motion) и остановить лишнее вращение камеры? Снова ручной код и отслеживание состояния. Про доступность для скринридеров или простую анимацию свойств через CSS-переходы вообще молчим — каскад внутрь холста не проникает.
Первый шаг к исправлению этой изоляции Apple сделала с тегом <model>, который в Safari 27 уже работает на всех платформах. Он позволяет вставить на страницу готовую 3D-модель так же просто, как картинку через <img>. Но тут всплыло другое ограничение: одиночный <model> отлично показывает один предмет сам по себе, в собственной коробочке. А вот собрать на странице сцену из нескольких объектов, которые взаимодействуют друг с другом, стоят на одном столе и делят общий свет, таким способом нельзя.
Именно эту задачу решает Spatial CSS. Вместо того чтобы придумывать новый язык разметки, редакторы спецификации из консорциума W3C перенесли пространственные механики прямо в декларативный CSS. Если навести порядок на уровне стилей, страница начинает адаптировать 3D-контент под размер окна, соотношение сторон экрана, цветовую тему и параметры движения точно так же, как обычные карточки товара. Числовые параметры вроде сдвигов и углов поворота при этом плавно анимируются стандартными переходами без лишнего кода на JavaScript.
Если под рукой есть Mac с установленным симулятором visionOS в Xcode или сама гарнитура, превью включается в четыре клика. Достаточно зайти в системные настройки по пути Settings → Apps → Safari → Advanced → Feature flags и переключить тумблер CSS Portals. После этого демонстрационная страница webkids-puzzle-playground с синей доской-сортером и оранжевыми объёмными фигурами оживёт в настоящем пространстве.
Spatial CSS в Safari: как новый стандарт WebKit выводит 3D-модели в пространственный веб
Элемент <model> и контейнер spatial: portal
Прежде чем лезть в разметку, давай на пару абзацев подлатаем матчасть, потому что тут сталкиваются два непривычных для повседневного фронтенда формата. Первый — сами 3D-ассеты в файлах .usdz. Это сжатый контейнер формата Universal Scene Description, который изначально разработали в Pixar, а Apple взяла его за основу для движка RealityKit в своих операционных системах. Внутри одного .usdz-файла уже упакованы геометрия объекта, текстуры, материалы и при желании встроенная анимация.
Второй термин — портал, который задаётся новым CSS-свойством spatial: portal. В привычной вёрстке любой блок вроде <div> или <figure> — это плоский прямоугольник на листе бумаги. Даже когда мы крутим карточки с помощью perspective, браузер на самом деле просто искажает плоские слои, а пересекающиеся фигуры режут друг друга как листы картона. Свойство spatial: portal превращает контейнер в настоящий трёхмерный аквариум или объёмную нишу прямо внутри страницы. В черновике CSS Spatial Module Level 1 это называется пространственным контекстом форматирования: все дочерние элементы внутри такого контейнера попадают в одну общую комнату и делят единую систему координат.
На стартовом стенде WebKit сцена с сортером, восьмиугольником и звездой выглядит до смешного просто. Посмотрим на саму HTML-структуру контейнера и его вложенных моделей:
<div class="world" style="spatial: portal;">
<model id="board" src="board.usdz"></model>
<model id="octagon" src="octagon.usdz"></model>
<model id="star" src="star.usdz"></model>
</div>
На экране в этот момент появляется три отдельных объекта внутри одного блока .world. Первый тег <model> загружает синюю платформу с выемками, второй подгружает оранжевую шайбу-восьмиугольник, а третий отвечает за оранжевую звезду. Самое любопытное здесь происходит за кулисами: хотя модели лежат в разных файлах, браузер больше не рендерит каждую из них в изолированной сцене.
За счёт правила spatial: portal на родительском <div> все три ассета оказываются в общем объёме. Движок понимает их взаимное расположение, глубину и пересечения в пространстве, как будто их экспортировали из единого проекта. По замыслу спецификации портал в перспективе сможет объединять и обычный HTML-контент, хотя текущее превью в visionOS 27.3 пока сфокусировано именно на работе с 3D-моделями.
Трёхмерный transform: двигаем и крутим детали в объёме
Если оставить разметку из прошлого шага как есть, все три модели свалятся в одну кучу в центре портала. Чтобы развести фигуры по краям от доски, не нужно открывать 3D-редактор и пересохранять геометрию. Внутри пространственного портала в игру вступает старое доброе свойство transform.
Тут есть одна хитрая деталь под капотом, про которую полезно знать. В обычном CSS плоские и псевдообъёмные трансформации работают через класс DOMMatrix, который просто накладывает визуальный эффект на плоский слой документа. Как только родитель получает spatial: portal, та же самая DOMMatrix начинает управлять истинным 3D-положением объектов в объёме.
Для сдвигов подходят как привычные пиксели, так и реальные физические единицы вроде сантиметров cm. В гарнитуре или на калиброванном экране движок понимает физический масштаб сцены. Взглянем на стили, которыми WebKit расставляет фигурки по бокам от доски-сортера:
#octagon {
transform: translateX(-50cm);
}
#star {
transform: translateX(50cm);
}
Разберём эти шесть строк на примере нашей сцены. Платформа #board остаётся в нулевой точке координат по центру портала, а восьмиугольник #octagon уезжает строго на 50 сантиметров влево по оси X. Звезда #star зеркально сдвигается на 50 сантиметров вправо. В итоге пользователь видит аккуратную композицию: доска посередине, а две детали для сортировки лежат по бокам и ждут своей очереди.
Зачем выносить эти сдвиги в CSS, если внутри .usdz-файла можно заранее прошить анимацию? Дело в гибкости. Встроенная в модель временная шкала умеет проигрывать одну заранее записанную последовательность действий — скажем, деталь просто падает сверху вниз. Когда же каждая модель управляется через transform с функциями translateX, translateY, translateZ и поворотами вокруг всех трёх осей, у тебя появляются независимые степени свободы. На демо-странице WebKit к этим параметрам даже прикрутили панель настроек, чтобы двигать и вращать доску с фигурами отдельно друг от друга прямо на лету.
Сборка без рулетки: position-anchor и точки привязки в 3D
Расставить детали по краям экрана легко, а вот точно вложить оранжевый восьмиугольник в его выемку на доске через transform — уже головная боль. Попробуй представить, как ты подгоняешь на глаз translateX, translateY и углы наклона для составного предмета вроде мебели или детали конструктора. Стоит чуть-чуть повернуть или сдвинуть саму доску — и все тщательно подобранные координаты дочерних деталей мгновенно уплывут.
На плоской странице эту задачу решили бы простой вложенностью: положил один <div> внутрь другого, и они двигаются вместе. Но в 3D с элементом <model> такой фокус не пройдёт. Дело в том, что <model> — это void-элемент, пустой тег по аналогии с <img> или <br>, внутрь которого по правилам HTML нельзя вложить другие теги.
Здесь на сцену выходят два понятия из 3D-графики и современного CSS. Сначала про 3D-редакторы: когда художник моделирует доску-сортер в проекте shapeblocks.blend, он делает саму видимую геометрию доски и дополнительно ставит внутри специальные невидимые маркеры. В 3D-среде их называют null objects или empties, то есть пустышки. У такой пустышки нет ни полигонов, ни текстур, она хранит только точную точку в пространстве и поворот осей. В проекте сортера лежат две такие точки-мишени для центров выемок под восьмиугольник и звезду.
Второе понятие — CSS Anchor Positioning. В обычной вёрстке механизм position-anchor используют, чтобы приклеить всплывающую подсказку к кнопке, даже если они лежат в разных ветках DOM. Авторы Spatial CSS расширили этот механизм на третье измерение: родительская модель объявляет своё якорное имя, а вторая модель прицепляется к конкретному именованному маркеру внутри неё. Посмотрим, как WebKit укладывает восьмиугольник ровно в паз на доске:
#board {
anchor-name: --board;
}
#octagon {
position-anchor: --board#octagon-position;
position-context: anchor;
}
#star {
display: none;
}
Смотрим на магию в этих CSS-правилах. Правило anchor-name: --board; регистрирует саму платформу-сортер как точку отсчёта с именем --board. Дальше для восьмиугольника #octagon мы пишем position-anchor: --board#octagon-position; — обращение через решётку целит в конкретный пустой объект-якорь внутри board.usdz, а не в общий центр доски.
Но одной привязки мало, поэтому следующей строкой идёт обязательное свойство position-context: anchor;. Оно переключает систему координат восьмиугольника: теперь его собственный центр и оси ориентации выравниваются строго по координатам того самого маркера в пазу. Лишнюю звезду в этом примере просто скрыли через привычный display: none;, и она честно исчезла из 3D-сцены.
Самое приятное в таком подходе — тебе больше не нужно копировать числа с точностью до миллиметра из 3D-редактора или считать тригонометрию в скриптах. Если дизайнер сдвинет выемку в исходной модели или анимирует саму точку привязки во времени, прицепленная деталь поедет следом автоматически. И при необходимости поверх привязанного положения всё так же можно накидывать локальные сдвиги через transform — например, чтобы деталь плавно выезжала из паза при наведении.
Свет как в комнате: директива @environment-map и HDR-панорамы
Даже идеально расставленные фигурки в 3D выглядят как дешёвый пластик из девяностых, если над ними не поработать со светом. Когда ты крутишь в руках матовый кубик или металлическую деталь, на их гранях отражается вся комната вокруг: окно, лампа под потолком, цвет стен. В 3D-графике такой приём называют освещением по карте окружения, или IBL (Image-Based Lighting).
Вместо того чтобы вручную расставлять десяток виртуальных прожекторов вокруг модели, разработчики оборачивают сцену в невидимую сферу с панорамной фотографией в формате .hdr. В отличие от обычной JPEG-картинки, HDR-файл с широким динамическим диапазоном честно хранит и тусклую тень в углу, и ослепительный блик лампы. Проекция при этом называется equirectangular, то есть равнопромежуточная: представь глобус, который аккуратно разрезали и развернули в один широкий прямоугольник.
Когда тег <model> только появился, карту окружения задавали прямо через HTML-атрибут на самом элементе. Но как только модели собрали в общий портал, стало понятно, что освещение должно быть общим для всей сцены и легко переключаться через стили. Вдохновившись директивой @keyframes для анимаций, инженеры WebKit ввели в Spatial CSS новую директиву @environment-map. Добавляем к нашему контейнеру .world класс spooky и включаем мрачную ночную подсветку через стили:
@environment-map {
name: "spooky";
format: equirectangular;
src: url("night.hdr");
}
.world.spooky {
environment-map: "spooky";
}
Внутри блока @environment-map мы сначала регистрируем именованный пресет освещения: даём ему имя "spooky", явно подсказываем браузеру тип развёртки equirectangular и передаём ссылку на 360-градусную HDR-панораму night.hdr. Второе правило .world.spooky подключает этот свет ко всему порталу одной строкой environment-map: "spooky";.
На скриншоте из блога WebKit эффект виден моментально: привычная светло-синяя доска проваливается в глубокую тень на тёмно-коричневом фоне, а в выемках и вдоль граней оранжевых фигурок загорается зловещее зелёное, фиолетовое и оранжевое свечение снизу. И заметь, насколько это удобно для живых интерфейсов: чтобы переключить сцену с дневного освещения на ночное под тёмную тему операционной системы, достаточно обернуть environment-map в стандартный медиазапрос @media (prefers-color-scheme: dark) или просто переключить CSS-класс на контейнере.
Интерактивная орбита и выход из окна: portal-action и requestVolumetricScene()
Статичная 3D-картинка, которую нельзя покрутить пальцем или взглядом, быстро разочаровывает. В 3D-софте базовый жест, когда пользователь тащит сцену и вращает камеру вокруг центра композиции, называют орбитой (orbit). Раньше у одиночного тега <model> за такое поведение отвечал HTML-атрибут stagemode. В новом стандарте интерактивность перенесли в CSS через свойство portal-action.
Настройка занимает ровно три строки в таблице стилей:
.world {
portal-action: orbit;
}
После добавления portal-action: orbit браузер сам перехватывает жесты над порталом и превращает его в интерактивную сцену, которую можно свободно разглядывать со всех сторон. Вынос этой логики в CSS делает управление поведением гораздо гибче HTML-атрибутов: например, на мобильном экране жесты вращения можно включить, а на десктопе в узкой боковой колонке — отключить одним медиазапросом. В будущем авторы спецификации планируют расширить список доступных режимов значениями вроде pan-x или pan-y для панорамирования по осям.
Но главная фишка для пространственных гарнитур ждёт дальше. В visionOS обычная веб-страница по умолчанию привязана к плоскому стеклянному окну Safari. А что, если пользователю захочется вытащить собранную 3D-сцену наружу и поставить сортер или модель мебели прямо на свой реальный стол посреди комнаты? Для этого в превью появился механизм Connected Volumetric Scene и JavaScript-метод requestVolumetricScene().
Вот как выглядит запуск этого режима по нажатию кнопки на странице:
const launchSpaceButton = document.querySelector("#launch-space");
launchSpaceButton.addEventListener("click", (event) => {
const world = document.querySelector(".world");
world.requestVolumetricScene();
});
Давай разберём, что происходит после клика по #launch-space. Во-первых, браузер не позволит вызвать requestVolumetricScene() просто так при загрузке скрипта — вызов обязан идти из обработчика явного действия пользователя, чтобы навязчивые сайты не заваливали твою комнату рекламными 3D-объектами без спроса. Во-вторых, как только система одобряет запрос, содержимое контейнера .world открепляется от плоского окна браузера и превращается в самостоятельный объёмный объект, который можно перетащить в любую точку пространства.
Самое крутое кроется в слове Connected, то есть связанная сцена. Вынесенная в комнату композиция не превращается в мёртвый слепок: между веб-страницей и парящим в воздухе объёмом сохраняется живая связь. Если код на странице добавит внутрь .world новый тег <model>, удалит деталь или поменяет ей transform через CSS, объект посреди твоей комнаты обновится в реальном времени.
Что со стандартом и форматами: CSSWG, USDZ против glTF и границы превью
Если смотреть на картину трезво, перед нами пока не готовый инструмент для продакшена, а ранний эскиз будущего стандарта. Спецификация CSS Spatial Module Level 1 разрабатывается в рабочей группе W3C CSS Working Group под редакцией Ады Роуз Кэннон и Элики Этемад. Сейчас в черновике закладываются базовые правила: как работают пространственные контексты форматирования, сцены порталов и привязка якорей в объёме.
С доступностью на устройствах ситуация пока жёстко ограничена. Сам тег <model> уже вышел в релизном Safari 27 на всех платформах Apple, а вот Spatial CSS с порталами, position-anchor в 3D и @environment-map существует только как developer preview за экспериментальным флагом CSS Portals в Safari на visionOS 27.3. Разработчики с другими браузерами тоже в подвешенном состоянии: ни команда Chromium, ни разработчики Gecko ещё не публиковали графиков внедрения CSS Portals дальше предварительных обсуждений на уровне стандартов.
Отдельный камень преткновения — форматы 3D-моделей. Превью в visionOS 27.3 опирается на .usdz, который нативно переваривает графический движок Apple RealityKit. Но за пределами экосистемы Apple стандартом де-факто в вебе давно стал открытый формат glTF (и его бинарный вариант GLB), на котором держится большая часть 3D-контента в интернете. Внутри рабочей группы W3C сейчас как раз обсуждают обязательную поддержку glTF/GLB, иначе разработчикам придётся конвертировать и хранить на серверах по два комплекта моделей под разные браузеры.
Ограничения этого релиза не отменяют главного: декларативный подход снимает с фронтендера целый пласт рутины. Для сложных игр, процедурных шейдеров или кастомной физики по-прежнему понадобятся специализированные движки на <canvas>. Зато для витрин, инструкций по сборке, конфигураторов и интерактивных иллюстраций идея собирать 3D-композиции обычным CSS уже выглядит как практичный инструмент, который команда WebKit предлагает тестировать в симуляторе и обсуждать на трекере ошибок WebKit.



