Liquid Glass · Implementación completa
Implementación WebGL en un solo archivo. La refracción, el grosor, el Fresnel, la dispersión y el brillo interno del vidrio se calculan completamente en el shader de fragmentos; el DOM solo contiene texto, botones y sombras.
No escribas shaders desde cero: 90 líneas son suficientes, pero 400 líneas desde cero tienen una probabilidad de éxito extremadamente baja. Modifica liquid-glass-all.html.
0. Ruta más rápida (1 minuto para ver el efecto)
- Abre
liquid-glass-all.htmlen Chrome / Edge. - El panel de control derecho tiene 5 deslizadores (refract / mag / rim / disp / tint) + 4 botones de receta. Al cambiarlos verás los cambios al instante.
- Todas las acciones están ahí: haz clic en una cápsula para expandirla, mantén presionado para arrastrar, presión larga para burbujas, clic derecho para otro menú, doble clic para elevar, tecla de separación del Dock, teclado Espacio/S/W/Esc.
- Verificación con la autocomprobación incorporada: añade
?selftest=1a la URL; en la esquina superior izquierda de la página aparecerán 13 resultadosPASS / FAIL. - Captura de pantalla para mostrar:
?pose=1muestra una pose con «expandido + separado + burbujas»;?pose&wire=1añade un campo de diagnóstico de trayectoria óptica.
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
--window-size=1280,800 --screenshot=out.png "file:///<ruta_absoluta>/liquid-glass-all.html?selftest=1"
Después de la captura, revisa realmente la imagen y confirma que en la esquina superior izquierda aparece FAIL 0. No te fíes solo del código para decir que está completo.
1. Activos
liquid-glass-all/
├── SKILL.md # Este archivo: rutas, acciones, trayectoria óptica, errores comunes, verificación
├── liquid-glass-all.html # Implementación completa (único producto ejecutable)
└── references/
├── action-matrix.md # Tabla completa de las 82 acciones (desencadenante / qué cambia / parámetros / inversa)
├── feature-matrix.md # 26 propiedades de material × cobertura de esta implementación
├── optics-model.md # Modelo físico de la trayectoria óptica y constantes (lectura obligatoria antes de escribir shaders)
└── interaction-playbook.md # Máquina de estados, temporización, pruebas de acierto, verificación
2. Resumen rápido de las 82 acciones (9 categorías)
La tabla completa está en references/action-matrix.md. Aquí solo la estructura:
| Categoría | Cantidad | Contenido |
|---|---|---|
| A Puntero | 13 | hover entrada/movimiento/salida, atenuación de vecindad, press, release, clic, inicio de arrastre/seguimiento/rebote, límite de borde, menú contextual, menú de presión larga |
| B Arrastre con inercia | 6 | estiramiento direccional, traslación elástica, atenuación de deformación, deslizamiento inercial, elevación por arrastre, sombra fantasma con retardo |
| C Morfología Morph | 10 | expandir/contraer, fundido de entrada de elementos de menú, seguimiento de esquinas redondeadas, separación/aparición del lado derecho/fusión, acento de división, salto de ancho cero, cuello de conexión por fusión |
| D Realimentación por presión | 8 | contracción, aumento de refracción, aumento de grosor, brillo interno, propagación a paneles vecinos, brillo del arco inferior, resaltado direccional, flash indicador |
| E Animaciones ópticas | 8 | tres modos de refracción, cambio de variante, mapeo tint, inversión claro/oscuro, color de derrame ambiental, sombra adaptativa, desvanecimiento por desenfoque, deriva de manchas de fondo |
| F Adaptación | 7 | muestreo de brillo/color principal, subida de fondo, resolución adaptativa, actualización de trayectoria óptica, límite DPR, cadena de degradación |
| G Sistema y accesibilidad | 8 | reordenamiento por resize, desplazamiento soft/hard, tres interruptores de accesibilidad, pérdida de foco de ventana, anillo de foco Tab, semántica de lector de pantalla |
| H Controles | 8 | botón de operación principal, 5 deslizadores, segmentación de variantes, tres botones de modo, 4 interruptores, 4 recetas, botón de separación, cabezal de expansión |
| K Teclado | 7 | Espacio / S / W / Esc / Tab / ↑↓ / Enter |
Barra de monitoreo de acciones en la parte inferior de la página: registra cada acción y muestra las últimas 4, para confirmar si «esto se activó o no».
3. Siete pasos de la trayectoria óptica (el orden no puede cambiar)
- Contorno:
sdRoundBoxobtiene la distancia con signod;x = clamp(-d/band, 0, 1),0=contorno,1=centro,band = max(5, min(hx,hy)*0.30). - Campo de altura convexa:
H(x)=sqrt(1-(1-x)²),H'(x)=v/sqrt(1-v²)(v=clamp(1-x,0.02,0.9995)). Usa sqrt, no pow. - Ángulo de incidencia:
sinI = min(H'/sqrt(1+H'²), 0.62),thT = asin(sinI/1.5168). 0.62 es un límite superior estricto; si se sube a 0.93, los bordes se extienden a 200px y todo se vuelve negro. - Grosor:
tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg,vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y))(más grueso abajo, más delgado arriba). - Desplazamiento:
off = -dir*tan(thI-thT)*tpx*refract*Tf, más término de ajuste de borde; finalmenteclamp(off,-10,10). - Foco/labio:
focal = mag*magMul*(0.50*cW - 0.40*eW);1-focaldebe ser siempre positivo, de lo contrario se produce un giro local de 180° y el texto aparece al revés.magMules a nivel de panel: lens 1.30 / capsule 0.85 / plate 0.55 / nav 0.90 / dock 0.80. - Composición:
sp = c + rel*(1-focal) - off; muestreo RGB separado por±disp*7*eW; luego compresión de brillo tint0.58*L+0.133, color de derrame ambiental 0.10, borde Fresnel, blanco lechoso, brillo especular superior, arco inferior, brillo interno.
La textura Y debe invertirse: uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y). Sin esta línea, la imagen aparece reflejada y el texto al revés.
4. Máquina de estados y umbrales clave
| Acción | Umbral / Parámetro |
|---|---|
| hover | Dentro del panel; fuera del panel hasta 180px, atenuación fade |
| press | press→1 (k=0.19/fotograma), scale 0.965, refracción ×1.3, arco inferior ×1.75 |
| Clic | pointerup y desplazamiento ≤4px → retraso de 240ms para evitar conflicto con doble clic |
| Doble clic | Dos pointerdown con intervalo <300ms; el segundo down cancela inmediatamente el temporizador de clic |
| Presión larga | 500ms después de pointerdown; si el movimiento es >4px, se cancela; el punto de progreso se agranda en el punto de contacto |
| Arrastre | Solo se convierte en arrastre si el desplazamiento es >4px; clamp a 8px de margen interior |
| Inercia | Velocidad al soltar >6px/evento → comienza con v*1.05, se multiplica por 0.94 cada fotograma, termina cuando <1px y se ajusta |
| Expandir | 136×48 → 236×296, el borde inferior no se mueve: ty = lay.y + lay.h - 296; los elementos del menú aparecen gradualmente desde altura 110→250, los pointerEvents se activan solo después de la mitad |
| Separar | Dock 300 → izquierda 140; el lado derecho tx se fija en lay.x + lay.w - 140, ancho 0→140 |
| Fusionar | El lado derecho primero reduce su ancho, la posición no se mueve (para evitar «deslizarse») |
| Fundir | Tras la separación, queda un espacio de 20px entre las dos piezas; los bordes interactúan entre sí; la unión metaball real requiere SDF smooth-min, no implementada en la versión Web de un solo paso |
| Muelle | Posición ω=15, ancho ω=18.5, ζ=0.66, dt=1/60 → aproximadamente 0.45s, 6% de sobrepaso |
5. Recetas de parámetros
| Deseado | refract | mag | rim | disp | tint | thick |
|---|---|---|---|---|---|---|
| Cápsula de vidrio grueso | 1.20 | 0.35 | 0.95 | 0.22 | 0.24 | ✓ |
| Lente con tira de color | 1.50 | 0.60 | 1.00 | 0.18 | 0.10 | ✓ |
| Letras pequeñas bajo vidrio grueso | 1.25 | 0.42 | 0.80 | 0.30 | 0.16 | ✓ |
| Navegación superior (contenida) | 0.90 | 0.20 | 0.60 | 0.15 | 0.10 | ✗ |
| Panel de control (legible) | 1.00 | 0.15 | 0.55 | 0.12 | 0.14 | ✗ |
Orden de ajuste: refract para desplazamiento → mag para labio → rim para borde → disp/tint para textura. Al revés, siempre lucharán entre sí.
6. Ocho errores comunes que debes evitar
- Los arrays de uniform no son fiables:
uGeo[12]en ANGLE/D3D no da error pero no funciona → una draw call por panel. - Las ramas de uniform en bucles se optimizan: usa
mix/stepsin ramas dentro de bucles. - Los uniform declarados pero no usados se optimizan,
getUniformLocationdevuelve null, lo que provoca falsos informes de falta de uniform. gl.getUniform(prog, null)lanza TypeError, todo el código posterior del fotograma se salta (parece un bloqueo).- Eje Y de la textura: si no se invierte, la imagen aparece reflejada y el texto al revés.
- Solo enlazar
clickpierde eventos: usapointerdown + pointerup + umbral de desplazamiento. halfes una palabra reservada de GLSL ES: escribirvec2 halfprovoca un error de compilación, el log solo dice syntax error. Otras palabras problemáticas:filter,input,output,long,short,packed.smoothstepcon argumentos en orden inverso es comportamiento indefinido:smoothstep(1.0,-1.0,d)falla al cambiar de máquina; siempre escribe1.0 - smoothstep(pequeño, grande, x).
Dos errores específicos de la capa de acciones:
- Después de una presión larga, al levantar el dedo no debe considerarse un clic (marca
longFired), de lo contrario, el menú de presión larga se abre y va seguido inmediatamente de una expansión. - El clic derecho debe interceptarse antes de
pointerdown(e.button !== 0devolver directamente), de lo contrario, el clic derecho iniciará un arrastre.
7. Verificación (ejecutar después de cada cambio)
?selftest=1 cubre 13 puntos: clic expandir/contraer, presión larga para burbujas, Esc cerrar burbujas, clic derecho para otro menú, separación y fusión del Dock, cuello de fusión, selección con teclas de dirección, Esc cerrar global, doble clic para elevar, inercia, W campo de trayectoria óptica.
Además, verifica manualmente:
- El contenido dentro del vidrio está en la orientación correcta (sin invertir, sin reflejar)
- El borde tiene un anillo Fresnel, brillo especular superior y arco inferior brillante, todo presente
- En fondos oscuros, el interior del vidrio no es negro sólido (tiene un tono grisáceo brumoso)
- Al arrastrar, la sombra fantasma tiene retardo; al soltar, hay inercia y luego se ajusta
- Al separar, las dos piezas «se parten», no «se separan tirando»
- El texto al desplazarse se desvanece en los bordes; al llegar al final, cambia a borde duro
- Los tres interruptores de accesibilidad funcionan (reducir transparencia / aumentar contraste / reducir movimiento)
8. Presupuesto de rendimiento
| Elemento | Presupuesto |
|---|---|
| Paneles de vidrio en pantalla | ≤10 (esta implementación tiene 10, incluyendo bubble / bridge de ancho cero que aparecen según sea necesario) |
| Draw calls | 2 programas + un AABB draw por panel |
| Subida de fondo | Cada 5 fotogramas; si está estático, puede ser cada 8 fotogramas |
| Muestreo de brillo | Cada 10 fotogramas, solo para paneles con w*h>24000 |
| Factor de renderizado | <42fps → 0.72, >56fps → 1.0, límite DPR 2 |
| Cadena de degradación | Reducir paneles → reducir factor → reducir subida → desactivar dispersión → volver a versión CSS |
9. Líneas rojas y límites de la plataforma
- El vidrio solo está en la capa de navegación; la capa de contenido no tiene vidrio.
- No apilar vidrio (pierde la referencia de refracción, parece una mancha sucia); Regular y Clear no se mezclan en la misma pantalla.
- Tint solo para la operación principal; los reflejos deben ser moderados;
rim > 1.2se verá falso. - Lo que Web no puede hacer: el texto/los iconos sobre el vidrio no se refractan a sí mismos (eso es la tubería de composición del sistema iOS 26); la versión CSS de respaldo no puede lograr el labio de lente con dispersión cromática píxel a píxel.
- No cubierto por la versión de auto-dibujado: unión metaball real (esta implementación usa un cuello estrecho como aproximación), iluminación por inclinación del dispositivo, estadísticas de color principal fotograma a fotograma de video en tiempo real.