Liquid Glass · Implementação Completa
Implementação em arquivo único com WebGL. Toda a refração, espessura, efeito Fresnel, dispersão cromática, brilho de borda e brilho interno do vidro são calculados no fragment shader. O DOM contém apenas texto, botões e sombras projetadas.
Não escreva shaders do zero: 90 linhas são suficientes para rodar, mas escrever 400 linhas do zero tem taxa de sucesso extremamente baixa. Modifique a partir de liquid-glass-all.html.
0. Caminho Mais Rápido (ver o efeito em 1 minuto)
- Abra
liquid-glass-all.htmlno Chrome / Edge. - O painel de controle à direita tem 5 controles deslizantes (refract / mag / rim / disp / tint) + 4 botões de receita. Altere e veja a mudança imediatamente.
- Todas as ações estão lá: clique na cápsula para expandir, pressione e arraste, toque longo para bolhas, clique direito para outro menu, duplo clique para levantar, botão de separação do Dock, teclas de atalho Espaço/S/W/Esc.
- Use o teste automático interno: adicione
?selftest=1ao final do URL. O canto superior esquerdo da página exibirá 13 linhasPASS / FAIL. - Captura de tela posada:
?pose=1posiciona a interface no estado "Expandido + Separado + Bolhas";?pose&wire=1adiciona o campo de diagnóstico óptico.
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
--window-size=1280,800 --screenshot=out.png "file:///<caminho_absoluto>/liquid-glass-all.html?selftest=1"
Após a captura de tela, realmente leia a imagem para confirmar que o canto superior esquerdo mostra FAIL 0. Não confie apenas no código para declarar sucesso.
1. Ativos
liquid-glass-all/
├── SKILL.md # Este arquivo: caminhos, ações, traçado de raios, armadilhas, validação
├── liquid-glass-all.html # Implementação completa (único artefato de execução)
└── references/
├── action-matrix.md # Tabela completa das 82 ações (gatilho / o que muda / parâmetros / reversão)
├── feature-matrix.md # 26 propriedades de material × cobertura desta implementação
├── optics-model.md # Modelo físico do traçado de raios e constantes (leitura obrigatória antes de escrever shaders)
└── interaction-playbook.md # Máquina de estados, temporização, teste de colisão, validação
2. Referência Rápida das 82 Ações (9 Categorias)
A tabela completa está em references/action-matrix.md. Aqui está apenas o esqueleto:
| Categoria | Qtd | Conteúdo |
|---|---|---|
| A Ponteiro | 13 | Hover entrada/movimento/saída, atenuação de vizinhança, press, release, clique, início de arrasto/seguimento/retorno elástico, clamp de borda, menu de clique direito, menu de toque longo |
| B Arrasto com Inércia | 6 | Esticamento direcional, translação elástica, atenuação de deformação, deslize inercial, levantamento ao arrastar, sombra fantasma com atraso |
| C Morfologia | 10 | Expandir/recolher, fade-in de itens de menu, arredondamento acompanhante, separar/crescimento da peça direita/mesclar, acento de divisão, salto de largura zero, pescoço de fusão |
| D Feedback de Pressão | 8 | Retração, aumento de refração, aumento de espessura, brilho interno, propagação para placa vizinha, brilho do arco inferior, destaque direcional, flash de orientação |
| E Animação Óptica | 8 | Três modos de refração, alternância de variante, mapeamento de matiz, inversão claro/escuro, cor de ambiente vazada, sombra adaptativa, esmaecimento por desfoco, deriva de manchas de fundo |
| F Adaptabilidade | 7 | Amostragem de brilho/cor principal, upload de fundo, resolução adaptativa, atualização do traçado de raios, limite máximo de DPR, cadeia de degradação |
| G Sistema e Acessibilidade | 8 | Reorganização em resize, rolagem soft/hard, três switches de acessibilidade, perda de foco da janela, anel de foco Tab, semântica para leitores de tela |
| H Controles | 8 | Botão de ação principal, 5 controles deslizantes, segmentação de variante, três botões de modo, 4 switches, 4 receitas, botão de separação, cabeçalho de expansão |
| K Teclado | 7 | Espaço / S / W / Esc / Tab / ↑↓ / Enter |
Barra de monitoramento de ações na parte inferior da página: cada ação gera um ponto e exibe os 4 eventos mais recentes, para confirmar "essa ação realmente foi acionada".
3. Sete Etapas do Traçado de Raios (a ordem não pode ser alterada)
- Contorno:
sdRoundBoxcalcula a distância com sinald;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)). Use sqrt, não pow. - Ângulo de incidência:
sinI = min(H'/sqrt(1+H'²), 0.62),thT = asin(sinI/1.5168). 0.62 é o limite superior rígido; definir como 0.93 empurra a borda para 200px, escurecendo todo o bloco. - Espessura:
tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg,vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y))(mais espesso embaixo, mais fino em cima). - Deslocamento:
off = -dir*tan(thI-thT)*tpx*refract*Tf, mais termo de ajuste de borda; no finalclamp(off,-10,10). - Foco/lábio:
focal = mag*magMul*(0.50*cW - 0.40*eW);1-focaldeve ser sempre positivo, caso contrário haverá inversão local de 180°, texto de cabeça para baixo.magMulé definido no nível do painel: lens 1.30 / capsule 0.85 / plate 0.55 / nav 0.90 / dock 0.80. - Composição:
sp = c + rel*(1-focal) - off; amostragem RGB separada por±disp*7*eW; depois compressão de brilho com matiz0.58*L+0.133, cor de ambiente vazada 0.10, borda Fresnel, branco leitoso, espelho no topo, arco inferior, brilho interno.
A textura Y deve ser invertida: uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y). Pular esta linha resulta em imagem espelhada + texto invertido.
4. Máquina de Estados e Limiares Críticos
| Ação | Limiar / Parâmetro |
|---|---|
| hover | Dentro do painel; fora do painel, atenuação fade em 180px |
| press | press→1 (k=0.19/frame), scale 0.965, refração ×1.3, arco inferior ×1.75 |
| Clique | pointerup e deslocamento ≤4px → atraso de 240ms para acionar, evitando conflito com duplo clique |
| Duplo clique | Dois pointerdown com intervalo <300ms; no segundo down, cancela imediatamente o timer de clique simples |
| Toque longo | 500ms após pointerdown; movimento >4px cancela; ponto de progresso ampliado no ponto de contato |
| Arrasto | Deslocamento >4px inicia arrasto; clamp de margem interna de 8px |
| Inércia | Velocidade na soltura >6px/evento → começa com v*1.05, multiplica por 0.94 a cada frame, termina quando <1px e ancora |
| Expandir | 136×48 → 236×296, base fixa: ty = lay.y + lay.h - 296; itens de menu com fade-in de altura 110→250, pointerEvents ativado somente após metade |
| Separar | Dock 300 → esquerda 140; peça direita tx fixada em lay.x + lay.w - 140, largura 0→140 |
| Mesclar | Peça direita primeiro reduz a largura, mantendo a posição (evita "deslizar") |
| Fusão | Após separar, as duas peças mantêm uma lacuna de 20px; os rims se acoplam mutuamente; união real metaball requer SDF smooth-min, não implementado na versão single-pass Web |
| Mola | Posição ω=15, largura ω=18.5, ζ=0.66, dt=1/60 → ~0.45s, 6% de overshoot |
5. Receitas de Parâmetros
| Desejado | refract | mag | rim | disp | tint | thick |
|---|---|---|---|---|---|---|
| Cápsula de vidro grosso | 1.20 | 0.35 | 0.95 | 0.22 | 0.24 | ✓ |
| Lente com faixa colorida | 1.50 | 0.60 | 1.00 | 0.18 | 0.10 | ✓ |
| Tampa de vidro grosso com texto pequeno | 1.25 | 0.42 | 0.80 | 0.30 | 0.16 | ✓ |
| Navegação superior (contida) | 0.90 | 0.20 | 0.60 | 0.15 | 0.10 | ✗ |
| Painel de controle (legível) | 1.00 | 0.15 | 0.55 | 0.12 | 0.14 | ✗ |
Ordem de ajuste: refract para deslocamento → mag para lábio → rim para borda → disp/tint para textura. A ordem inversa sempre causa conflitos.
6. Oito Armadilhas Obrigatórias
- Arrays uniform não são confiáveis:
uGeo[12]no ANGLE/D3D não gera erro de atribuição, mas não funciona → um draw call por painel. - Branches uniform dentro de loops são otimizados: Use
mix/steppara escrita sem branches. - Uniforms não utilizados são otimizados:
getUniformLocationretorna null, gerando falsos relatórios de falta de uniform. gl.getUniform(prog, null)lança TypeError: O código restante do frame é todo ignorado (parece travamento).- Eixo Y da textura: Não inverter resulta em imagem espelhada + texto invertido.
- Apenas
clickperde eventos: Usepointerdown + pointerup + limite de deslocamento. halfé palavra reservada do GLSL ES: Escrevervec2 halfcausa falha de compilação, relatório apenas "syntax error". Palavras semelhantes:filter,input,output,long,short,packed.- smoothstep com ordem inversa é comportamento indefinido:
smoothstep(1.0,-1.0,d)falha em diferentes máquinas; sempre escreva1.0 - smoothstep(pequeno,grande,x).
Mais duas armadilhas específicas da camada de ação:
- Após toque longo, soltar o dedo não pode contar como clique (marcar
longFired), caso contrário, ao abrir o menu de toque longo, um clique de expansão ocorrerá imediatamente. - Clique direito deve ser interceptado antes de
pointerdown(e.button !== 0retornar diretamente), caso contrário, o clique direito iniciará um arrasto.
7. Validação (Execute após cada modificação)
?selftest=1 cobre 13 itens: clique para expandir/recolher, toque longo para bolhas, Esc fecha bolhas, clique direito para outro menu, separação e mesclagem do Dock, pescoço de fusão, seleção com teclas direcionais, Esc recolhimento global, duplo clique para levantar, inércia, campo de raios W.
Confirme manualmente:
- Conteúdo dentro do vidro na orientação correta (sem inversão, sem espelhamento)
- Borda com rim, espelho no topo e arco inferior brilhante estão todos presentes
- Em fundo escuro, o interior do vidro não é preto sólido (tem um tom cinza nebuloso)
- Durante o arrasto, a sombra fantasma tem atraso; ao soltar, há inércia antes de ancorar
- Ao separar, as duas peças "se partem", não "se afastam puxando"
- Texto rolante desaparece gradualmente nas bordas; na extremidade, corta para modo hard (linha fina de cabelo)
- Todos os três switches de acessibilidade funcionam (reduzir transparência / aumentar contraste / reduzir movimento)
8. Orçamento de Desempenho
| Item | Orçamento |
|---|---|
| Painéis de vidro na tela | ≤10 (esta implementação usa 10, incluindo bubble/bridge com largura zero que aparecem sob demanda) |
| Draw calls | 2 programas + 1 AABB draw por painel |
| Upload de fundo | A cada 5 frames; estático pode ser a cada 8 frames |
| Amostragem de brilho | A cada 10 frames, apenas painéis com w*h > 24000 |
| Fator de renderização | <42fps → 0.72, >56fps → 1.0, DPR máximo 2 |
| Cadeia de degradação | Reduzir painéis → reduzir fator → reduzir upload → desligar dispersão cromática → recorrer a versão CSS |
9. Linhas Vermelhas e Limites da Plataforma
- O vidro está apenas na camada de navegação; a camada de conteúdo não recebe vidro.
- Não empilhe vidro (perde referência de refração, parece sujeira); Regular e Clear não podem ser misturados na mesma tela.
- tint apenas para ações principais; brilho contido,
rim > 1.2parece falso. - O que a Web não pode fazer: Texto/ícones sobre vidro não são refratados pelo próprio vidro (isso é feito no pipeline de composição do iOS 26); o fallback CSS não consegue reproduzir o lábio de lente e a dispersão cromática pixel a pixel.
- Não coberto pela versão de desenho próprio: União real metaball (esta implementação usa aproximação de pescoço estreito), iluminação por inclinação do dispositivo, estatísticas de cor principal quadro a quadro de vídeo ao vivo.