Imagina una tarea habitual de cualquier proyecto: en una página de producto o una landing necesitas poner no una imagen plana, sino un par de objetos 3D que estén uno al lado del otro, reciban la misma luz y respondan a los clics. Parece algo menor. Sin embargo, detrás de un widget «tan sencillo» hoy arranca de inmediato todo un minimotor gráfico.
El navegador tiene que cargar una librería como Three.js, Babylon.js o PlayCanvas sobre WebGL o WebGPU. Luego armas la escena a mano, configuras la cámara virtual, mantienes un bucle de dibujado para cada fotograma, conectas los gestos de ratón y pantalla táctil, y además vigila que el lienzo 3D no se rompa al girar la pantalla, cambiar al modo oscuro o activar la preferencia prefers-reduced-motion. El CSS normal no sabe absolutamente nada de lo que pasa dentro de ese <canvas>.
El equipo de WebKit decidió abordar el problema desde otro ángulo y llevar la composición 3D básica directamente a HTML y CSS. El 16 de noviembre de 2026, el ingeniero de WebKit Brandel Zachernuk publicó el anuncio de Spatial CSS Developer Preview en el blog de WebKit, y en paralelo salió en el grupo de trabajo W3C CSSWG el borrador de la especificación CSS Spatial Layout Module Level 1. Por ahora todo funciona solo como una vista previa temprana en Safari para visionOS 27.3 y se esconde tras un flag experimental: todavía es pronto para llevarlo a producción. Pero ya puedes probar la mecánica y entender cómo planean los navegadores unir los modelos 3D con la maquetación de siempre.
De motores WebGL pesados a la etiqueta <model>: por qué un solo modelo no basta
El primer paso hacia el 3D sin toneladas de JavaScript fue el propio elemento HTML <model>. En Safari 27 estable ya funciona en todos los dispositivos de Apple: iOS, iPadOS, macOS y visionOS (en cambio, Chrome y Firefox aún no lo tienen). La idea de la etiqueta es sencilla: incrustar un modelo 3D en la página con la misma naturalidad que una imagen con <img> o un video con <video>.
Dentro de <model>, el navegador entiende dos formatos principales. El primero es USDZ (model/vnd.usdz+zip), el archivo propio del ecosistema Apple basado en Universal Scene Description de Pixar, donde ya vienen empaquetados geometría, materiales y animaciones preparadas. El segundo es el formato abierto y muy popular en la web glTF / GLB (model/gltf-binary). Si el navegador no conoce la etiqueta <model>, simplemente muestra la imagen de respaldo <img> que está dentro: mejora progresiva clásica sin scripts adicionales.
<!-- Incrustación básica de un modelo 3D en Safari 27 con imagen de respaldo -->
<model stagemode="orbit" alt="Modelo 3D de una silla">
<!-- Formato para dispositivos Apple (USDZ) -->
<source src="chair.usdz" type="model/vnd.usdz+zip">
<!-- Formato abierto para la web (GLB / glTF) -->
<source src="chair.glb" type="model/gltf-binary">
<!-- Respaldo para Chrome, Firefox y navegadores antiguos -->
<img src="chair-fallback.jpg" alt="Modelo 3D de una silla">
</model>
El atributo stagemode="orbit" permite al usuario girar la silla con el ratón o con un gesto desde el primer momento, sin escribir una sola línea de JS. Parecería que el problema está resuelto. Pero en cuanto aparece más de un objeto en la página, chocas contra un muro.
Cada <model> vive en su propia caja aislada. No puedes meter un <model> dentro de otro <model> como harías con un <div>: en términos de WebKit, se comporta como un elemento reemplazado sin flujo 3D propio para hijos. Como resultado, dos modelos vecinos en la página no saben nada el uno del otro: tienen sistemas de coordenadas distintos, iluminación distinta y cero posibilidades de encajar en una escena única. Para armar aunque sea un pequeño configurador de varias piezas, antes tenías que volver a WebGL.
Spatial CSS en WebKit: cómo maquetar objetos 3D en la web con CSS normal
Espacio 3D compartido: cómo funciona spatial: portal y las transformaciones reales
Para demostrar cómo Spatial CSS elimina esa limitación, el equipo de WebKit montó una demo interactiva con un tablero infantil de formas: una base de madera con huecos (board.usdz) y piezas sueltas con volumen como un octágono (octagon.usdz) y una estrella (star.usdz).
La pieza clave que une las etiquetas <model> sueltas es la nueva propiedad CSS spatial: portal. Se la aplicas a un contenedor normal (<div> o <figure>), y ese bloque se convierte en un portal tridimensional compartido. Todos los <model> en su interior dejan de estar en «peceras» separadas y pasan a formar parte de una única escena 3D con un sistema de coordenadas común.
Dentro de ese portal, la propiedad CSS habitual transform (que por debajo se apoya en DOMMatrix) empieza a funcionar como una transformación tridimensional real, e incluso acepta unidades físicas reales, como centímetros. Cada modelo se puede mover, rotar y escalar de forma independiente y, lo mejor, animar con transition y @keyframes de CSS de toda la vida.
<!-- El contenedor con spatial: portal une los modelos en una escena común -->
<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>
/* Movemos el octágono a la izquierda 50 centímetros reales */
#octagon {
transform: translateX(-50cm);
}
/* Movemos la estrella a la derecha los mismos 50 centímetros */
#star {
transform: translateX(50cm);
}
</style>
Fíjate en la unidad cm. En la maquetación plana casi nadie usa centímetros, porque en un monitor son aproximados. Pero en la web espacial los objetos tienen escala física real, y translateX(-50cm) significa un desplazamiento exacto de medio metro respecto al centro de la escena. Además, no escribes ningún bucle requestAnimationFrame: si quieres mover una pieza suavemente al pasar el cursor o hacer clic, solo añades transition: transform 0.4s ease y el navegador interpola el movimiento en 3D por su cuenta.
Por ahora la vista previa se centra en elementos <model>, pero la especificación se diseña con un alcance mayor: en el futuro también podrá vivir contenido web normal dentro del portal.
Acoplamiento sin tantear coordenadas: anclas 3D sobre CSS Anchor Positioning
Aquí surge una pregunta lógica: supongamos que metemos el tablero y las piezas en el mismo portal. ¿Cómo encajamos el octágono justo en su hueco del tablero? Si ajustas translateX, translateY y translateZ a ojo, todo se desarmará en cuanto cambie el modelo o su escala. Y como recordamos, en HTML no se puede anidar <model id="octagon"> dentro de <model id="board">.
WebKit resuelve esto con elegancia extendiendo a la tercera dimensión un mecanismo que los desarrolladores frontend ya conocen: CSS Anchor Positioning (posicionamiento por anclas). El trabajo se reparte entre el artista 3D y el desarrollador web:
- En un editor 3D como Blender, el diseñador abre el modelo base (
board.usdz) y coloca dentro puntos de referencia invisibles, llamados objetos nulos o «vacíos» (empties). Por ejemplo, pone un punto en el centro del hueco correspondiente y lo nombraoctagon-position. - En CSS, el desarrollador asigna al modelo base un nombre de ancla con
anchor-namey al segundo modelo le indica el punto exacto dentro de esa ancla usando una almohadilla:--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>
/* Declaramos el tablero como ancla de referencia de la escena */
#board {
anchor-name: --board;
}
/* Anclamos el octágono al punto vacío dentro de board.usdz */
#octagon {
position-anchor: --board#octagon-position;
position-context: anchor;
}
/* Propiedades CSS normales como display: none también funcionan */
#star {
display: none;
}
</style>
La propiedad position-context: anchor pasa el elemento al sistema de coordenadas del punto de referencia elegido, y el octágono encaja por sí solo en su ranura, sin un solo ajuste manual en centímetros. Más aún: si ese punto de referencia está animado dentro del archivo 3D, el modelo anclado lo seguirá sin protestar.
En el trabajo diario esto ahorra muchísimos dolores de cabeza. Piensa en un configurador online de muebles, bicicletas o zapatillas: el diseñador 3D marca una sola vez en Blender los puntos de unión para patas, manijas y accesorios, y el frontend en la web solo cambia variantes y conecta piezas con CSS, sin tocar matrices ni geometría. Y fíjate en el detalle al final del snippet: para quitar la estrella de la escena basta el viejo conocido display: none.
Luz y reflejos con @environment-map: el tema del sitio controla la escena 3D
Cuando varios modelos comparten un espacio, no basta con colocarlos en sus coordenadas: tienen que parecer parte del mismo mundo. En 3D, de eso se encarga sobre todo el mapa de entorno (Environment Map). En esencia, es una panorámica HDR de 360 grados en proyección equirectangular (equirectangular, como el mapa de la Tierra desplegado en un rectángulo). El motor envuelve mentalmente toda la escena con esa esfera y toma de ahí la iluminación y los brillos en las superficies.
Antes había que pasar ese mapa como atributo HTML en cada <model> por separado. Si tenías cinco modelos y el sitio ofrecía tema claro y oscuro, sincronizar la luz a mano era bastante molesto. En Spatial CSS la iluminación pasó a una regla declarativa @environment-map, cuya sintaxis se parece mucho a @keyframes.
<!-- Cambiamos el ambiente de toda la escena 3D con una clase CSS normal -->
<div class="world spooky">
<!-- Los elementos <model> anidados recibirán la luz compartida -->
</div>
El propio mapa de iluminación se describe en los estilos mediante la nueva regla @environment-map, donde indicas el nombre, la proyección y la ruta al archivo HDR, y luego lo aplicas al portal con la propiedad environment-map.
/* Declaramos un mapa de luz HDR de 360 grados reutilizable */
@environment-map {
name: "spooky";
format: equirectangular;
src: url("night.hdr");
}
/* Aplicamos la iluminación nocturna a todo el portal */
.world.spooky {
environment-map: "spooky";
}
A partir de ahí, todo obedece a la cascada normal de CSS. ¿Necesitas atenuar la luz de la escena 3D cuando el usuario activa el modo oscuro del sistema? Pones environment-map dentro de @media (prefers-color-scheme: dark) y todos los modelos del portal reciben reflejos nocturnos al mismo tiempo. Cero código JS recorriendo el árbol de la escena para recargar texturas en cada objeto.
Girar la escena y sacarla a la habitación: portal-action y requestVolumetricScene()
Un diorama 3D estático en la ventana del navegador ya es agradable, pero el usuario casi siempre quiere girarlo para verlo por todos lados. Para un <model> suelto antes bastaba el atributo HTML stagemode="orbit". Para un portal completo con varios modelos, WebKit añadió el equivalente en CSS: la propiedad portal-action: orbit.
/* Activamos el portal 3D común y permitimos girar la escena con ratón o gestos */
.world {
spatial: portal;
portal-action: orbit;
}
Una sola línea portal-action: orbit habilita la rotación de toda la escena combinada, y en el borrador ya contemplan otros modos de interacción para el futuro, como pan-x y pan-y. Pero el truco más llamativo de la vista previa se reservó para visionOS: la escena dentro del portal puede literalmente «salir» de la ventana plana del navegador hacia la habitación física que rodea al usuario. Para eso, el elemento DOM del portal incorpora el método JavaScript requestVolumetricScene(), que solo se dispara tras una acción explícita del usuario, como hacer clic en un botón.
/* Al hacer clic sacamos el portal 3D de la ventana del navegador al espacio de la habitación */
launchSpaceButton.addEventListener("click", (event) => {
const world = document.querySelector(".world");
world.requestVolumetricScene();
});
Tras el clic, el sistema abre lo que llaman una Connected Volumetric Scene: una escena con volumen que flota en la habitación sin cortar el vínculo con la página web. No es una copia congelada ni una «exportación a un visor», sino una extensión viva de tu DOM. Si un script de la página añade un modelo nuevo, cambia la clase .spooky o desplaza un bloque según su ancla, el objeto suspendido frente al usuario se actualiza al instante.
Para ver con claridad qué lugar ocupa Spatial CSS frente a los enfoques actuales de 3D en el navegador, resumámoslo en una tabla breve.
| Enfoque | Escena 3D común y acople | Luz y vínculo con CSS | Gráficos complejos (shaders, física) | Soporte en navegadores |
|---|---|---|---|---|
| WebGL / WebGPU (Three.js) | Control total mediante código JS | Sincronización manual con CSS | Sí, cualquier juego o efecto | Todos los navegadores modernos |
<model> individual | No, cada objeto está aislado | Solo atributos HTML en la etiqueta | No, solo modelos preparados | Safari 27 estable (Apple) |
Spatial CSS (spatial: portal) | Sí, mediante portal y anclas 3D | Total: cascada, temas, @environment-map | No, enfocado en composición de modelos | Vista previa en Safari para visionOS 27.3 |
La comparación deja claro que Spatial CSS no pretende enterrar a Three.js. Para juegos, simulaciones físicas, partículas y shaders personalizados, los motores imperativos sobre WebGL y WebGPU seguirán siendo necesarios. En cambio, para escaparates 3D de producto, fichas de artículos y configuradores, el enfoque declarativo puede reducir cientos de líneas de código repetitivo a un par de decenas de líneas de CSS conocido.
Dónde funciona ahora, cuál es el truco y hacia dónde va el estándar
Si te dieron ganas de abrir el editor ahora mismo y jugar con portales, ten en cuenta varias limitaciones estrictas. En el momento del anuncio, Spatial CSS funciona solo en Safari sobre visionOS 27.3, y allí viene desactivado por defecto. Para activarlo debes ir a los ajustes del sistema y encender a mano el flag experimental: Settings > Apps > Safari > Advanced > Feature flags > CSS Portals.
Una buena noticia si no tienes un Apple Vision Pro a mano: en Mac puedes ejecutar la vista previa usando visionOS Simulator incluido en Xcode; los pasos de instalación están en la documentación oficial de Apple sobre Xcode y simuladores. Allí mismo se abre el playground de WebKit con el tablero y las piezas.
- La vista previa está disponible únicamente en Safari para visionOS 27.3 y solo tras activar manualmente el flag CSS Portals.
- Chrome/Chromium y Firefox no soportan por ahora ni Spatial CSS ni siquiera el elemento HTML básico
<model>. - La especificación
CSS Spatial Layout Module Level 1sigue en estado Editor's Draft: nombres de propiedades comospatial: portal,position-anchory la sintaxis de@environment-maptodavía pueden cambiar bastante. - La implementación actual se centra en elementos
<model>y mapas HDR de 360 grados, aunque a futuro el estándar apunta a cualquier contenido del DOM.
El borrador CSS Spatial Layout Module Level 1 del 16 de noviembre de 2026 lo editan integrantes de Apple: Ada Rose Cannon y Elika J. Etemad (conocida en la comunidad CSSWG como fantasai). En el documento ya se vislumbra un plan mucho más ambicioso que las seis primitivas de esta primera vista previa: describe portal-stage, portal-transform, límites de profundidad front-limit, márgenes en el eje Z (inset-front e inset-back) y posicionamiento position: spatial-absolute.
Además, en WebKit subrayan una idea importante: el CSS espacial no se piensa como un juguete exclusivo para visores. Los modelos con volumen se giran cada vez más en teléfonos, tabletas y portátiles normales: en tiendas online, manuales educativos y reseñas interactivas. Por eso la meta final del estándar es que la maquetación 3D funcione en navegadores de cualquier pantalla, y que en visores simplemente se despliegue con más profundidad al sacar la escena a la habitación.

