Spatial CSS en Safari: cómo el nuevo estándar de WebKit lleva modelos 3D a la web espacialA fondo · digest del 18 de noviembre
Spatial CSS en Safari: cómo el nuevo estándar de WebKit lleva modelos 3D a la web espacial
A fondo7 secciones≈ 18 min

Spatial CSS en Safari: cómo el nuevo estándar de WebKit lleva modelos 3D a la web espacial

«Aunque es un gran salto conceptual, en sí mismo Spatial CSS consiste en muchas pequeñas mejoras a la sintaxis que ya existe». Brandel Zachernuk, WebKit Blog

Suena casi atrevido, ¿verdad? Llevas años pensando en el 3D en el navegador como un mundo pesado lleno de matrices de proyección, shaders y un ciclo de renderizado aparte en JavaScript. De pronto, un ingeniero del equipo de WebKit te dice que todo eso se puede mover con reglas normales de CSS. En la actualización de noviembre de Safari para visionOS 27.3, Apple lanzó una vista previa para desarrolladores con los primeros primitivos de la especificación CSS Spatial Module Level 1.

Aclaremos los límites desde el principio para no hacernos falsas ilusiones. Por ahora hablamos de un entorno experimental detrás de la bandera CSS Portals, que puedes probar en el visor Vision Pro o en el simulador de visionOS desde Xcode. Sin embargo, la arquitectura del estándar se pensó mucho más allá de los visores: las mismas técnicas deberían funcionar en el futuro en teléfonos, tabletas y computadoras de escritorio. Veamos juntos en la demo real de WebKit webkids-puzzle-playground, con un juego infantil de encajar figuras, cómo funciona esta mecánica por debajo y por qué decidieron replantear la cascada tradicional.

Por qué sacan el 3D del canvas hacia el CSS normal

Para entender la idea de los autores del estándar, mira cómo vive hoy la gráfica tridimensional en los sitios web. Normalmente, quien desarrolla coloca un elemento <canvas> en la página, conecta un motor WebGL pesado y le entrega ese rectángulo de píxeles. Dentro de ese rectángulo puedes dibujar desde una nave espacial hasta un configurador de tenis.

El problema es que, para el navegador, <canvas> sigue siendo una vitrina de vidrio cerrada. Todo lo que pasa detrás del vidrio queda totalmente desconectado del árbol DOM y del CSS. ¿Quieres ajustar el brillo de la escena al modo oscuro con @media (prefers-color-scheme)? Toca escribir código puente en JavaScript y pasar eventos hacia el motor. ¿Quieres respetar @media (prefers-reduced-motion) y frenar giros innecesarios de cámara? Otra vez código manual y seguimiento de estado. Ni hablar de la accesibilidad para lectores de pantalla o de animar propiedades con transiciones CSS: la cascada simplemente no entra al lienzo.

Apple dio el primer paso para romper este aislamiento con la etiqueta <model>, que en Safari 27 ya funciona en todas las plataformas. Te permite insertar un modelo 3D listo tan fácil como una imagen con <img>. Pero ahí apareció otro límite: un <model> aislado muestra muy bien un objeto solo, dentro de su propia caja. En cambio, armar una escena con varios objetos que interactúan entre sí, se apoyan en la misma mesa y comparten la misma luz no era posible.

Justo ese problema resuelve Spatial CSS. En lugar de inventar otro lenguaje de marcado, los editores de la especificación en el W3C llevaron las mecánicas espaciales directo al CSS declarativo. Al ordenar todo en la capa de estilos, la página adapta el contenido 3D al tamaño de la ventana, la relación de aspecto, el tema de color y las preferencias de movimiento igual que hace con cualquier tarjeta de producto. Además, valores numéricos como desplazamientos y ángulos de giro se animan con transiciones estándar sin escribir JavaScript extra.

Si tienes a la mano una Mac con el simulador de visionOS en Xcode o el visor físico, activas la vista previa en cuatro clics. Solo entra a los ajustes del sistema en Settings → Apps → Safari → Advanced → Feature flags y enciende CSS Portals. Después, la página de demostración webkids-puzzle-playground, con su tablero azul y figuras naranjas con volumen, cobrará vida en el espacio real.

Spatial CSS en Safari: cómo el nuevo estándar de WebKit lleva modelos 3D a la web espacial

El elemento <model> y el contenedor spatial: portal

Antes de meternos al código, repasemos en un par de párrafos la base técnica, porque aquí se cruzan dos conceptos poco comunes en el frontend diario. El primero son los recursos 3D en archivos .usdz. Es un contenedor comprimido del formato Universal Scene Description que creó Pixar originalmente y que Apple adoptó como base para el motor RealityKit en sus sistemas operativos. Dentro de un solo archivo .usdz ya vienen empaquetados la geometría del objeto, las texturas, los materiales y, si hace falta, animaciones integradas.

El segundo concepto es el portal, que se define con la nueva propiedad CSS spatial: portal. En la maquetación habitual, cualquier bloque como <div> o <figure> es un rectángulo plano sobre una hoja de papel. Incluso cuando giramos tarjetas con perspective, el navegador solo deforma capas planas y las figuras que se cruzan se cortan entre sí como hojas de cartón. La propiedad spatial: portal transforma el contenedor en un verdadero acuario tridimensional o nicho con profundidad dentro de la página. En el borrador de CSS Spatial Module Level 1 esto se llama contexto de formato espacial: todos los elementos hijos dentro de ese contenedor entran en una misma habitación y comparten un único sistema de coordenadas.

En la demo inicial de WebKit, la escena del tablero con el octágono y la estrella se ve sorprendentemente simple. Veamos la estructura HTML del contenedor y sus modelos anidados:

<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>

En pantalla aparecen tres objetos distintos dentro de un mismo bloque .world. La primera etiqueta <model> carga la plataforma azul con ranuras, la segunda carga la ficha naranja octagonal y la tercera corresponde a la estrella naranja. Lo más interesante ocurre tras bambalinas: aunque los modelos vienen en archivos separados, el navegador deja de renderizar cada uno en su propia escena aislada.

Gracias a la regla spatial: portal en el <div> padre, los tres recursos quedan dentro del mismo volumen. El motor entiende su posición relativa, profundidad e intersecciones en el espacio, como si los hubieran exportado desde un solo proyecto. Según la especificación, a futuro el portal también podrá combinar contenido HTML normal, aunque la vista previa actual en visionOS 27.3 se enfoca en modelos 3D.

transform en 3D: mover y girar piezas en el volumen

Si dejas el marcado del paso anterior tal cual, los tres modelos terminarán apilados en el centro del portal. Para separar las figuras hacia los lados del tablero no hace falta abrir un editor 3D ni reexportar la geometría. Dentro de un portal espacial entra en acción la vieja y conocida propiedad transform.

Aquí hay un detalle interno muy útil que conviene saber. En el CSS clásico, las transformaciones planas y pseudo-3D usan la clase DOMMatrix, que solo aplica un efecto visual sobre una capa plana del documento. En cuanto el elemento padre recibe spatial: portal, esa misma DOMMatrix pasa a controlar la posición 3D real de los objetos en el volumen.

Para mover las piezas sirven tanto los píxeles de siempre como unidades físicas reales, por ejemplo centímetros (cm). En el visor o en una pantalla calibrada, el motor entiende la escala física de la escena. Veamos los estilos con los que WebKit acomoda las figuras a los lados del tablero:

#octagon {
  transform: translateX(-50cm);
}

#star {
  transform: translateX(50cm);
}

Revisemos estas seis líneas en nuestra escena. La plataforma #board se queda en el punto cero de coordenadas en el centro del portal, mientras el octágono #octagon se desplaza exactamente 50 centímetros a la izquierda sobre el eje X. La estrella #star se mueve en espejo 50 centímetros hacia la derecha. El resultado es una composición limpia: el tablero en el medio y las dos fichas listas a cada lado.

¿Por qué sacar estos desplazamientos al CSS si puedes guardar una animación dentro del archivo .usdz? Por flexibilidad. La línea de tiempo integrada en un modelo solo reproduce una secuencia fija grabada de antemano, como hacer que una pieza caiga desde arriba. En cambio, cuando controlas cada modelo con transform usando translateX, translateY, translateZ y rotaciones en los tres ejes, ganas grados de libertad independientes. En la página de demo de WebKit incluso agregaron un panel de controles para mover y girar el tablero y las figuras por separado en tiempo real.

Armar sin cinta métrica: position-anchor y puntos de anclaje en 3D

Colocar piezas a los lados de la pantalla es fácil, pero encajar con exactitud el octágono naranja dentro de su hueco en el tablero usando transform ya es un dolor de cabeza. Imagina ajustar a ojo translateX, translateY y los ángulos de inclinación para un objeto compuesto como un mueble o una pieza de armado. Basta girar o mover un poco el tablero para que todas las coordenadas calculadas con tanto cuidado se desacomoden al instante.

En una página plana resolverías esto anidando etiquetas: metes un <div> dentro de otro y se mueven juntos. Pero en 3D con <model> ese truco no funciona. El motivo es que <model> es un elemento vacío (void element), igual que <img> o <br>, dentro del cual las reglas de HTML no permiten anidar otras etiquetas.

Aquí entran en escena dos ideas de la gráfica 3D y del CSS moderno. Primero, en los editores 3D: cuando quien diseña modela el tablero en el proyecto shapeblocks.blend, crea la geometría visible y además coloca marcadores invisibles por dentro. En entornos 3D se llaman null objects o empties (objetos vacíos). Un empty no tiene polígonos ni texturas; solo guarda un punto exacto en el espacio y la orientación de sus ejes. En el proyecto del juego hay dos puntos objetivo así para los centros de los huecos del octágono y la estrella.

La segunda pieza es CSS Anchor Positioning. En la maquetación normal, position-anchor sirve para pegar un tooltip a un botón aunque vivan en ramas distintas del DOM. Los autores de Spatial CSS extendieron este mecanismo a la tercera dimensión: el modelo padre declara su nombre de ancla y el segundo modelo se engancha a un marcador específico dentro de él. Veamos cómo WebKit encaja el octágono justo en su ranura del tablero:

#board {
  anchor-name: --board;
}

#octagon {
  position-anchor: --board#octagon-position;
  position-context: anchor;
}

#star {
  display: none;
}

Fíjate en la magia de estas reglas CSS. La línea anchor-name: --board; registra la plataforma como punto de referencia con el nombre --board. Luego, para #octagon escribimos position-anchor: --board#octagon-position;: usar el símbolo # apunta directo al objeto vacío ancla dentro de board.usdz, no al centro general del tablero.

Con el enlace solo no basta, por eso la línea siguiente incluye la propiedad obligatoria position-context: anchor;. Esta cambia el sistema de coordenadas del octágono para que su propio centro y sus ejes queden alineados exactamente con el marcador de la ranura. En este ejemplo, simplemente ocultaron la estrella sobrante con el clásico display: none; y desapareció de la escena 3D.

Lo mejor de este enfoque es que ya no tienes que copiar números al milímetro desde el editor 3D ni calcular trigonometría en scripts. Si el equipo de diseño mueve el hueco en el modelo original o anima el punto de anclaje con el tiempo, la pieza conectada lo seguirá en automático. Y si hace falta, igual puedes sumar desplazamientos locales con transform encima de la posición anclada, por ejemplo para que la ficha salga suavemente de su hueco al pasar el cursor.

Luz como en la habitación: la directiva @environment-map y panoramas HDR

Incluso las figuras mejor ubicadas en 3D parecen plástico barato de los años noventa si no trabajas la iluminación. Cuando giras en la mano un cubo mate o una pieza metálica, sus caras reflejan toda la habitación: la ventana, la lámpara del techo, el color de las paredes. En gráfica 3D esto se conoce como iluminación basada en imagen o IBL (Image-Based Lighting).

En vez de colocar a mano una decena de reflectores virtuales alrededor del modelo, se envuelve la escena en una esfera invisible con una fotografía panorámica en formato .hdr. A diferencia de un JPEG común, un archivo HDR de alto rango dinámico conserva tanto las sombras suaves de un rincón como el brillo intenso de una lámpara. Esta proyección se llama equirectangular: imagina un globo terráqueo cortado con cuidado y desplegado en un rectángulo ancho.

Cuando apareció la etiqueta <model>, el mapa de entorno se definía con un atributo HTML directo en el elemento. Pero en cuanto juntaron varios modelos en un portal, quedó claro que la luz debía ser compartida para toda la escena y fácil de cambiar desde los estilos. Inspirados en @keyframes para las animaciones, los ingenieros de WebKit introdujeron en Spatial CSS la directiva @environment-map. Agregamos la clase spooky a nuestro contenedor .world y activamos una luz nocturna tenebrosa con CSS:

@environment-map {
  name: "spooky";
  format: equirectangular;
  src: url("night.hdr");
}

.world.spooky {
  environment-map: "spooky";
}

Dentro del bloque @environment-map registramos primero un preset de luz con nombre: lo llamamos "spooky", indicamos el tipo de proyección equirectangular y pasamos la ruta al panorama HDR de 360 grados night.hdr. La segunda regla .world.spooky aplica esa iluminación a todo el portal con una sola línea: environment-map: "spooky";.

En la captura del blog de WebKit el cambio se nota al instante: el tablero azul claro cae en una sombra profunda sobre un fondo marrón oscuro, mientras en las ranuras y bordes de las figuras naranjas brilla un resplandor verde, morado y naranja desde abajo. Nota lo práctico que resulta esto para interfaces reales: para pasar de luz diurna a nocturna según el modo oscuro del sistema operativo, basta envolver environment-map en un @media (prefers-color-scheme: dark) o cambiar una clase CSS en el contenedor.

Órbita interactiva y salida de la ventana: portal-action y requestVolumetricScene()

Una imagen 3D estática que no puedes girar con el dedo ni con la mirada aburre rápido. En software 3D, el gesto básico donde arrastras la escena para rotar la cámara alrededor de la composición se llama órbita (orbit). Antes, en una etiqueta <model> individual ese comportamiento dependía del atributo HTML stagemode. En el nuevo estándar, la interactividad pasó al CSS mediante la propiedad portal-action.

Configurarlo toma apenas tres líneas en la hoja de estilos:

.world {
  portal-action: orbit;
}

Al añadir portal-action: orbit, el navegador intercepta los gestos sobre el portal y lo convierte en una escena interactiva que puedes inspeccionar desde todos los ángulos. Llevar esta lógica al CSS da mucha más flexibilidad que los atributos HTML: por ejemplo, puedes activar los gestos de rotación en pantallas móviles y desactivarlos en una barra lateral estrecha de escritorio con un simple media query. A futuro, los autores planean ampliar la lista de modos con valores como pan-x o pan-y para desplazarse por ejes.

Pero la función estrella para visores espaciales viene después. En visionOS, una página web normal vive pegada por defecto a la ventana plana de vidrio de Safari. ¿Y si alguien quiere sacar la escena 3D armada hacia afuera y poner el juego o un mueble justo sobre su mesa real en medio de la sala? Para eso la vista previa incorpora Connected Volumetric Scene y el método de JavaScript requestVolumetricScene().

Así se lanza este modo al presionar un botón en la página:

const launchSpaceButton = document.querySelector("#launch-space");

launchSpaceButton.addEventListener("click", (event) => {
  const world = document.querySelector(".world");
  world.requestVolumetricScene();
});

Veamos qué ocurre tras hacer clic en #launch-space. Primero, el navegador no te dejará llamar a requestVolumetricScene() apenas cargue el script: la llamada debe venir de una acción explícita del usuario para que sitios invasivos no llenen tu cuarto de objetos 3D publicitarios sin permiso. Segundo, cuando el sistema aprueba la solicitud, el contenido de .world se desprende de la ventana plana del navegador y se convierte en un objeto volumétrico independiente que puedes mover a cualquier punto del espacio.

Lo más genial está en la palabra Connected, es decir, escena conectada. La composición que sacaste a tu habitación no queda como una copia muerta: entre la página web y el volumen flotando en el aire se mantiene un enlace vivo. Si el código de la página agrega una nueva etiqueta <model> dentro de .world, elimina una pieza o cambia su transform por CSS, el objeto en medio de tu cuarto se actualiza en tiempo real.

Qué pasa con el estándar y los formatos: CSSWG, USDZ frente a glTF y límites de la vista previa

Si miramos el panorama con calma, todavía no tenemos una herramienta lista para producción, sino un primer boceto de un futuro estándar. La especificación CSS Spatial Module Level 1 avanza en el grupo de trabajo W3C CSS Working Group bajo la edición de Ada Rose Cannon y Elika Etemad. Por ahora, el borrador define las reglas base: cómo operan los contextos de formato espacial, las escenas de portal y el anclaje en volumen.

La disponibilidad en dispositivos sigue muy acotada. La etiqueta <model> ya salió en la versión estable de Safari 27 en todas las plataformas de Apple, pero Spatial CSS con portales, position-anchor en 3D y @environment-map solo existe como vista previa para desarrolladores detrás de la bandera CSS Portals en Safari sobre visionOS 27.3. En otros navegadores el panorama también está en pausa: ni Chromium ni Gecko han publicado fechas para implementar CSS Portals más allá de charlas preliminares en los grupos de estándares.

Otro punto delicado son los formatos de modelos 3D. La vista previa en visionOS 27.3 se apoya en .usdz, que el motor gráfico Apple RealityKit procesa de forma nativa. Sin embargo, fuera del ecosistema de Apple, el estándar de facto en la web es desde hace años el formato abierto glTF (y su variante binaria GLB), sobre el que corre casi todo el 3D en internet. Justo ahora en el W3C debaten si exigir soporte obligatorio para glTF/GLB; de lo contrario, los equipos tendrán que convertir y alojar dos juegos de modelos distintos según el navegador.

Las limitaciones de este lanzamiento no quitan lo principal: el enfoque declarativo le ahorra al frontend una enorme carga de trabajo repetitivo. Para juegos complejos, shaders procedurales o física a medida seguirán haciendo falta motores dedicados en <canvas>. En cambio, para vitrinas de productos, guías de armado, configuradores e ilustraciones interactivas, armar composiciones 3D con CSS normal ya luce como una herramienta práctica que el equipo de WebKit invita a probar en el simulador y comentar en el rastreador de errores de WebKit.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3