Spatial CSS в WebKit: как верстать 3D-объекты на вебе обычным CSSЛонгрид · дайджест за 19 ноября
Spatial CSS в WebKit: как верстать 3D-объекты на вебе обычным CSS
Лонгрид6 разделов≈ 13 мин

Spatial CSS в WebKit: как верстать 3D-объекты на вебе обычным CSS

Представь обычную задачу из практики: на страницу товара или лендинг нужно поставить не плоскую картинку, а пару-тройку 3D-объектов, которые стоят рядом, ловят один и тот же свет и реагируют на клики. Вроде бы мелочь. Но за кулисами такого «простого» виджета сегодня сразу запускается целый мини-движок.

Браузеру приходится грузить библиотеку вроде Three.js, Babylon.js или PlayCanvas поверх WebGL или WebGPU. Дальше ты руками собираешь сцену, настраиваешь виртуальную камеру, крутишь цикл отрисовки на каждый кадр, прикручиваешь обработку жестов мышью и пальцами, а потом ещё отдельно следишь за тем, чтобы 3D-канвас не сломался при повороте экрана, смене тёмной темы или включённой у пользователя настройке prefers-reduced-motion. Обычный CSS про то, что происходит внутри этого <canvas>, вообще ничего не знает.

Команда WebKit решила зайти с другой стороны и перенести базовую 3D-композицию прямо в HTML и CSS. 16 ноября 2026 года инженер WebKit Брэндел Захернук опубликовал анонс Spatial CSS Developer Preview в блоге WebKit, а параллельно в рабочей группе W3C CSSWG вышел черновик спецификации CSS Spatial Layout Module Level 1. Пока всё это работает только как ранний превью в Safari на visionOS 27.3 и прячется за экспериментальным флагом — в прод такое тащить рано. Зато уже сейчас можно пощупать механику и понять, как браузеры собираются подружить 3D-модели с привычной вёрсткой.

От тяжёлых WebGL-движков к тегу <model>: почему одной модели мало

Первым шагом к 3D без тонны JavaScript стал сам HTML-элемент <model>. В стабильном Safari 27 он уже работает на всех устройствах Apple — iOS, iPadOS, macOS и visionOS (а вот в Chrome и Firefox его пока нет). Идея у тега простая: встраивать 3D-модель в страницу так же естественно, как картинку через <img> или ролик через <video>.

Внутри <model> браузер понимает два основных формата. Первый — USDZ (model/vnd.usdz+zip), фирменный архив экосистемы Apple на базе Universal Scene Description от Pixar, куда сразу упакованы геометрия, материалы и запечённые анимации. Второй — открытый и популярный в вебе glTF / GLB (model/gltf-binary). Если браузер вообще не знает тег <model>, он просто покажет запасную картинку <img> внутри — классическое прогрессивное улучшение без лишних скриптов.

<!-- Базовое встраивание 3D-модели в Safari 27 с запасной картинкой -->
<model stagemode="orbit" alt="3D-модель кресла">
  <!-- Формат для устройств Apple (USDZ) -->
  <source src="chair.usdz" type="model/vnd.usdz+zip">
  <!-- Открытый формат для веба (GLB / glTF) -->
  <source src="chair.glb" type="model/gltf-binary">
  <!-- Фоллбэк для Chrome, Firefox и старых браузеров -->
  <img src="chair-fallback.jpg" alt="3D-модель кресла">
</model>

Атрибут stagemode="orbit" сразу даёт пользователю крутить кресло мышкой или жестом — ни строчки кода на JS писать не пришлось. Казалось бы, вот оно, счастье. Но как только на странице появляется больше одного объекта, упираешься в стену.

Каждый <model> живёт в своей изолированной коробке. Внутрь одного <model> нельзя вложить другой <model> как в обычный <div> — в терминах WebKit он ведёт себя как замещаемый элемент без собственного 3D-потока потомков. В итоге две соседние модели на странице не знают друг о друге: у них разные системы координат, разный свет и никакой возможности состыковать их в единую сцену. Чтобы собрать хотя бы простенький конструктор из нескольких деталей, раньше всё равно приходилось возвращаться к WebGL.

Spatial CSS в WebKit: как верстать 3D-объекты на вебе обычным CSS

Общее 3D-пространство: как работает spatial: portal и настоящие трансформации

Чтобы показать, как Spatial CSS снимает это ограничение, команда WebKit собрала интерактивное демо с детской доской-сортером: деревянная доска с выемками (board.usdz) и отдельные объёмные фигурки вроде восьмиугольника (octagon.usdz) и звезды (star.usdz).

Главная деталь, которая объединяет разрозненные теги <model>, — новое CSS-свойство spatial: portal. Вешаешь его на обычный контейнер (<div> или <figure>), и этот блок превращается в общий трёхмерный портал. Все <model> внутри него перестают сидеть по отдельным «аквариумам» и попадают в единую 3D-сцену с общей системой координат.

Внутри такого портала привычное CSS-свойство transform (под капотом оно опирается на DOMMatrix) начинает работать как настоящая трёхмерная трансформация, причём с реальными физическими единицами — например, сантиметрами. Каждую модель можно независимо двигать, крутить и масштабировать, а главное — анимировать обычными CSS transition и @keyframes.

<!-- Контейнер с spatial: portal объединяет модели в общую сцену -->
<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>

<style>
  /* Сдвигаем восьмиугольник влево на 50 реальных сантиметров */
  #octagon {
    transform: translateX(-50cm);
  }

  /* Звезду сдвигаем вправо на те же 50 сантиметров */
  #star {
    transform: translateX(50cm);
  }
</style>

Обрати внимание на единицу cm. В плоской вёрстке сантиметры почти никто не использует — на мониторе они всё равно условны. Но в пространственном вебе у объектов есть реальный физический масштаб, и translateX(-50cm) означает честный сдвиг на полметра относительно центра сцены. При этом ты не пишешь никакой цикл requestAnimationFrame: хочешь плавно подвинуть фигурку при наведении или по клику — просто добавляешь transition: transform 0.4s ease, и браузер сам интерполирует движение в 3D.

Пока в превью фокус сделан именно на элементах <model>, но сама спецификация проектируется шире: в будущем внутри портала сможет жить и обычный веб-контент.

Привязка без подбора координат: 3D-якоря поверх CSS Anchor Positioning

Тут сразу возникает резонный вопрос: допустим, мы положили доску и фигурки в один портал. А как вставить восьмиугольник ровно в его выемку на доске? Если подбирать translateX, translateY и translateZ вручную на глаз, конструкция развалится при первом же изменении модели или её масштаба. А вложить <model id="octagon"> внутрь <model id="board"> в HTML, как мы помним, нельзя.

WebKit решает эту задачу красиво — расширяет на третье измерение уже знакомый фронтендерам механизм CSS Anchor Positioning (якорного позиционирования). Работа делится между 3D-художником и веб-разработчиком:

  1. В 3D-редакторе вроде Blender дизайнер открывает базовую модель (board.usdz) и расставляет внутри неё невидимые опорные точки — так называемые null-объекты или «пустышки» (empties). Например, ставит точку в центре нужной выемки и даёт ей имя octagon-position.
  2. В CSS разработчик присваивает базовой модели имя якоря через anchor-name, а второй модели указывает конкретную точку внутри этого якоря через решётку — --board#octagon-position.
<div class="world">
  <model id="board" src="board.usdz"></model>
  <model id="octagon" src="octagon.usdz"></model>
  <model id="star" src="star.usdz"></model>
</div>

<style>
  /* Объявляем доску опорным якорем сцены */
  #board {
    anchor-name: --board;
  }

  /* Привязываем восьмиугольник к пустышке внутри board.usdz */
  #octagon {
    position-anchor: --board#octagon-position;
    position-context: anchor;
  }

  /* Обычные CSS-свойства вроде display: none тоже работают */
  #star {
    display: none;
  }
</style>

Свойство position-context: anchor переводит элемент в систему координат выбранной опорной точки, и восьмиугольник сам защёлкивается ровно в свой паз — без единого ручного сдвига в сантиметрах. Более того, если сама опорная точка внутри 3D-файла анимирована, привязанная к ней модель послушно поедет следом.

В реальной работе это снимает массу головной боли. Представь онлайн-конструктор мебели, велосипеда или кроссовок: 3D-дизайнер один раз размечает в Blender точки крепления для ножек, ручек и аксессуаров, а фронтендер на сайте просто переключает варианты и привязывает детали через CSS, не влезая в матрицы и геометрию. И заметь деталь в самом конце сниппета: чтобы убрать звезду со сцены, достаточно старого доброго display: none.

Свет и отражения через @environment-map: тема сайта управляет 3D-сценой

Когда несколько моделей стоят в одном пространстве, мало просто расставить их по координатам — они должны выглядеть частью одного мира. В 3D за это в первую очередь отвечает карта окружения (Environment Map). По сути, это 360-градусная HDR-панорама в равнопрямоугольной проекции (equirectangular — как карта Земли, развёрнутая в прямоугольник). Движок мысленно оборачивает этой сферой всю сцену и берёт оттуда освещение и блики на поверхностях.

Раньше такую карту приходилось передавать HTML-атрибутом на каждый отдельный <model>. Если моделей пять, а на сайте есть светлая и тёмная тема, синхронизировать свет вручную было то ещё удовольствие. В Spatial CSS освещение вынесли в декларативное правило @environment-map — по синтаксису оно очень похоже на @keyframes.

<!-- Переключаем настроение всей 3D-сцены обычным CSS-классом -->
<div class="world spooky">
  <!-- Вложенные элементы <model> получат общий свет -->
</div>

Саму карту освещения описывают в стилях через новое правило @environment-map, где задают имя, проекцию и путь к HDR-файлу, а затем вешают её на портал обычным свойством environment-map.

/* Объявляем переиспользуемую 360-градусную HDR-карту света */
@environment-map {
  name: "spooky";
  format: equirectangular;
  src: url("night.hdr");
}

/* Применяем ночное освещение ко всему порталу целиком */
.world.spooky {
  environment-map: "spooky";
}

После этого всё начинает подчиняться обычному CSS-каскаду. Нужно приглушить свет на 3D-сцене, когда пользователь переключил систему в тёмный режим? Вешаешь environment-map внутрь @media (prefers-color-scheme: dark) — и все модели внутри портала одновременно ловят ночные отражения. Никакого кода на JS, который бегает по дереву сцены и перезагружает текстуры окружения у каждого объекта.

Крутим сцену и выносим её в комнату: portal-action и requestVolumetricScene()

Статичная 3D-диорама в окне браузера — это уже приятно, но пользователю почти всегда хочется покрутить её со всех сторон. Для одиночного <model> раньше хватало HTML-атрибута stagemode="orbit". Для целого портала из нескольких моделей WebKit добавил CSS-аналог — свойство portal-action: orbit.

/* Включаем общий 3D-портал и даём крутить всю сцену мышью или жестом */
.world {
  spatial: portal;
  portal-action: orbit;
}

Одна строчка portal-action: orbit включает вращение всей объединённой сцены целиком, а на будущее в черновике закладывают и другие режимы взаимодействия вроде pan-x и pan-y. Но самый эффектный трюк превью приберегли для visionOS: сцену внутри портала можно буквально «вынуть» из плоского окна браузера в физическую комнату вокруг пользователя. Для этого у DOM-элемента портала появился JavaScript-метод requestVolumetricScene(), который срабатывает только по явному действию пользователя — например, по клику на кнопку.

/* По клику выносим 3D-портал из окна браузера в пространство комнаты */
launchSpaceButton.addEventListener("click", (event) => {
  const world = document.querySelector(".world");
  world.requestVolumetricScene();
});

После клика система открывает так называемую Connected Volumetric Scene — объёмную сцену, которая висит прямо в комнате, но при этом не обрывает связь с веб-страницей. Это не слепок и не «экспорт в просмотрщик», а живое продолжение твоего DOM. Если скрипт на странице добавит новую модель, переключит класс .spooky или сдвинет блок по якорю, объект в воздухе перед пользователем обновится в ту же секунду.

Чтобы наглядно увидеть, какое место Spatial CSS занимает среди существующих подходов к 3D в браузере, сведём их в короткую таблицу.

ПодходОбщая 3D-сцена и стыковкаСвет и связь с CSSСложная графика (шейдеры, физика)Поддержка в браузерах
WebGL / WebGPU (Three.js)Полный контроль через JS-кодСинхронизация с CSS вручнуюДа, любые игры и эффектыВсе современные браузеры
Одиночный <model>Нет, каждый объект изолированТолько HTML-атрибуты на тегеНет, только готовые моделиСтабильный Safari 27 (Apple)
Spatial CSS (spatial: portal)Да, через портал и 3D-якоряПолная: каскад, темы, @environment-mapНет, фокус на композиции моделейПревью в Safari на visionOS 27.3

Из сравнения хорошо видно, что Spatial CSS не пытается похоронить Three.js. Для игр, симуляций физики, частиц и кастомных шейдеров императивные движки поверх WebGL и WebGPU никуда не денутся. А вот для продуктовых 3D-витрин, карточек товаров и конфигураторов декларативный подход может срезать сотни строк однотипной обвязки до пары десятков строк привычного CSS.

Где это работает сейчас, в чём подвох и куда движется стандарт

Если захотелось прямо сейчас открыть код и поиграться с порталами, придётся учесть несколько жёстких ограничений. На момент анонса Spatial CSS работает только в Safari на visionOS 27.3, да и там выключен по умолчанию. Чтобы его активировать, нужно зайти в настройки системы и вручную включить экспериментальный флаг: Settings > Apps > Safari > Advanced > Feature flags > CSS Portals.

Хорошая новость для тех, у кого под рукой нет Apple Vision Pro: на Mac превью можно запустить через visionOS Simulator в составе Xcode — порядок установки описан в официальной документации Apple по Xcode и симуляторам. Там же откроется и песочница WebKit с доской и фигурками.

Почему в прод это брать рано
  • Превью доступно исключительно в Safari на visionOS 27.3 и только после ручного включения флага CSS Portals.
  • В Chrome/Chromium и Firefox сейчас нет поддержки ни Spatial CSS, ни даже базового HTML-элемента <model>.
  • Спецификация CSS Spatial Layout Module Level 1 находится в статусе Editor's Draft — имена свойств вроде spatial: portal, position-anchor и синтаксис @environment-map ещё могут заметно поменяться.
  • Текущая реализация сфокусирована на элементах <model> и 360-градусных HDR-картах, хотя в перспективе стандарт нацелен на любой DOM-контент.

Сам черновик CSS Spatial Layout Module Level 1 от 16 ноября 2026 года ведут редакторы из Apple — Ада Роуз Кэннон (Ada Rose Cannon) и Элика Этемад (Elika J. Etemad, известная в сообществе CSSWG как fantasai). В документе уже просматривается гораздо более масштабный замысел, чем шесть примитивов из первого превью: там описаны portal-stage, portal-transform, ограничение глубины front-limit, отступы по оси Z (inset-front и inset-back) и позиционирование position: spatial-absolute.

Причём в самом WebKit отдельно подчёркивают важную мысль: пространственный CSS задумывается не как эксклюзивная игрушка для гарнитур. Объёмные модели всё чаще крутят на обычных телефонах, планшетах и ноутбуках — в интернет-магазинах, учебных пособиях и интерактивных обзорах. Поэтому конечная цель стандарта — сделать так, чтобы 3D-вёрстка работала в браузерах на любых экранах, а в гарнитурах просто раскрывалась глубже за счёт выхода сцены в комнату.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 3