Communitygithub.com

Liquid Glass · Toutes Fonctionnalités

Implémentation complète du Liquid Glass d'Apple WWDC25 : 26 propriétés matérielles + 82 actions (clic/double-clic/appui long/clic droit/glisser/inertie/ombre/expansion/rétractation/séparation/fusion/combinaison/clavier/accessibilité/bord de défilement). Utilisez-le lorsque l'utilisateur demande du verre liquide Apple, de l'interface utilisateur en verre givré, du verre à réfraction transparente, des boutons/menus/Dock Liquid Glass, ou lorsqu'il a besoin de feedback de pression, de déformation, ou d'analyse de chemin lumineux. Livré avec un fichier unique exécutable liquid-glass-all.html (shader de fragment WebGL, 2 programmes, 10 appels de dessin, testé avec Chrome sans tête et intégrant un auto-test ?selftest=1).

Qu'est-ce que Liquid Glass · Toutes Fonctionnalités ?

Ce skill implémente intégralement le Liquid Glass d'Apple WWDC25 en un seul fichier HTML WebGL. Il gère 82 actions utilisateur réparties en 9 catégories (pointeur, glisser avec inertie, morphologie, feedback de pression, animations optiques, adaptations système, accessibilité, contrôles, clavier) et 26 propriétés matérielles (réfraction, épaisseur, effet Fresnel, dispersion chromatique, lueur interne, etc.). Le rendu est entièrement calculé dans un shader de fragment en 7 étapes (contour, champ de hauteur convexe, angle incident, épaisseur, déplacement, foyer/lèvre, composition) avec des limites claires (ne pas empiler les verres, ne pas couvrir la couche de contenu). Il inclut un système d'auto-test avec ?selftest=1 (13 tests) et un mode pose pour captures d'écran (?pose=1). Les plateformes supportées sont les navigateurs Chrome/Edge avec WebGL, et le fichier unique est conçu pour être exécuté sans serveur.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cyt-56/liquid-glass-webgl/tree/HEAD/skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Liquid Glass · Toutes Fonctionnalités ?

Implémentation WebGL en un seul fichier : la réfraction / l'épaisseur / Fresnel / la dispersion chromatique / la lèvre / la lueur interne du verre sont toutes calculées dans le shader de fragment, le DOM ne porte que le texte, les boutons et les ombres portées. N'écrivez pas un shader from scratch : 90 lignes suffisent pour fonctionner, mais 400 lignes écrites from scratch ont un taux de réussite extrêmement faible. Modifiez liquid-glass-all.html.

0. Chemin le plus rapide (voir le résultat en 1 minute)

  1. Ouvrir liquid-glass-all.html dans Chrome / Edge.
  2. Le panneau de contrôle à droite comporte 5 curseurs (refract / mag / rim / disp / tint) + 4 boutons de recette, modifiez-les pour voir le changement immédiatement.
  3. Toutes les actions sont incluses : cliquer sur une capsule pour développer, maintenir pour faire glisser, appui long pour faire apparaître des bulles, clic droit pour un autre menu, double-clic pour soulever, bouton de séparation du Dock, touches espace/S/W/Échap.
  4. Validation avec l'auto-test intégré : ajoutez ?selftest=1 à l'URL, le coin supérieur gauche de la page affiche directement 13 résultats PASS / FAIL.
  5. Capture d'écran pour mise en scène : ?pose=1 affiche en une fois « développement + séparation + bulles » ; ?pose&wire=1 superpose en plus le champ de diagnostic du chemin lumineux.
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
  --window-size=1280,800 --screenshot=out.png "file:///chemin/absolu/vers/liquid-glass-all.html?selftest=1"

Après la capture, lisez réellement cette image et confirmez que le coin supérieur gauche affiche FAIL 0. Ne vous contentez pas d'affirmer que c'est fait en vous basant uniquement sur le code.

1. Actifs

liquid-glass-all/
├── SKILL.md                       # Ce fichier : chemins, actions, trajet lumineux, pièges, validation
├── liquid-glass-all.html          # Implémentation complète (seul artefact exécutable)
└── references/
    ├── action-matrix.md           # Tableau complet des 82 actions (déclencheur / quoi modifié / paramètres / inverse)
    ├── feature-matrix.md          # 26 propriétés matérielles × couverture de cette implémentation
    ├── optics-model.md            # Modèle physique du trajet lumineux et constantes (à lire avant d'écrire le shader)
    └── interaction-playbook.md    # Machine d'état, séquencement, test de collision, validation

2. Aperçu rapide des 82 actions (9 catégories)

Le tableau complet se trouve dans references/action-matrix.md, ici seulement le squelette :

CatégorieQuantitéContenu
A Pointeur13survol entrée/déplacement/sortie, atténuation de voisinage, pression, relâchement, clic unique, démarrage de glisser/suivi/retour élastique, clamp du bord, menu clic droit, menu appui long
B Glisser inertiel6étirement directionnel, translation élastique, atténuation de déformation, glissement inertiel, soulèvement par glissement, ombre différée
C Morphologie Morph10développement/rétractation, fondu des éléments de menu, arrondi suiveur, séparation/allongement de la partie droite/fusion, accent de rupture, saut de largeur nulle, cou de fusion
D Feedback de pression8rétractation, renforcement de la réfraction, augmentation de l'épaisseur, lueur interne, propagation de la plaque voisine, éclat de l'arc inférieur, surbrillance directionnelle, flash indicateur
E Animations optiques8trois modes de réfraction, commutation de variante, mappage de teinte, inversion clair/foncé, débordement de couleur d'environnement, ombre adaptative, fondu hors focus, dérive de tache de fond
F Adaptatif7échantillonnage de la luminosité/couleur principale, téléchargement du fond, résolution adaptative, rafraîchissement du trajet lumineux, limite de DPR, chaîne de dégradation
G Système et accessibilité8redimensionnement, défilement soft/hard, trois commutateurs d'accessibilité, perte de focus de la fenêtre, anneau de focus Tab, sémantique de lecteur d'écran
H Contrôles8bouton d'action principal, 5 curseurs, segment de variante, trois boutons de mode, 4 commutateurs, 4 recettes, bouton de séparation, en-tête de développement
K Clavier7Espace / S / W / Échap / Tab / ↑↓ / Entrée

Barre de surveillance des actions en bas de la page : chaque action est marquée et les 4 dernières sont affichées, pour confirmer « est-ce que cette action a vraiment été déclenchée ? ».

3. Les sept étapes du trajet lumineux (l'ordre ne peut pas être changé)

  1. Contour : sdRoundBox prend la distance signée d ; x = clamp(-d/band, 0, 1), 0=contour, 1=centre, band = max(5, min(hx,hy)*0.30).
  2. Champ de hauteur convexe : H(x)=sqrt(1-(1-x)²), H'(x)=v/sqrt(1-v²) (v=clamp(1-x,0.02,0.9995)). Utilisez sqrt, pas pow.
  3. Angle incident : sinI = min(H'/sqrt(1+H'²), 0.62), thT = asin(sinI/1.5168). 0.62 est une limite supérieure dure ; si vous mettez 0.93, le bord sera poussé au niveau de 200px et tout deviendra noir.
  4. Épaisseur : tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg, vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y)) (plus épais en bas, plus fin en haut).
  5. Déplacement : off = -dir*tan(thI-thT)*tpx*refract*Tf, plus un terme de bord ; enfin clamp(off,-10,10).
  6. Foyer / Lèvre : focal = mag*magMul*(0.50*cW - 0.40*eW) ; 1-focal doit toujours être positif, sinon inversion locale à 180° et texte inversé. magMul est au niveau du panneau : lens 1.30 / capsule 0.85 / plate 0.55 / nav 0.90 / dock 0.80.
  7. Composition : sp = c + rel*(1-focal) - off ; échantillonnage RGB séparé de ±disp*7*eW ; puis compression de luminosité 0.58*L+0.133 pour la teinte, débordement de couleur d'environnement 0.10, Fresnel rim, blanc laiteux, miroir supérieur, arc inférieur, lueur interne.

La texture Y doit être inversée : uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y). Si vous omettez cette ligne, vous obtenez une image miroir + un texte inversé.

4. Machine d'état et seuils clés

ActionSeuil / Paramètre
survolDans le panneau ; atténuation fade dans les 180px hors panneau
pressionpress→1 (k=0.19/image), scale 0.965, réfraction ×1.3, arc inférieur ×1.75
clic uniquepointerup et déplacement ≤4px → déclenché 240ms plus tard, pour éviter le conflit avec le double-clic
double-clicDeux pointerdown à moins de 300ms d'intervalle ; au deuxième down, annulez immédiatement le timer du clic unique
appui long500ms après pointerdown ; un déplacement >4px annule ; le point de progression s'agrandit au point de contact
glisserDéplacement >4px pour passer en mode glisser ; clamp à 8px de marge intérieure
inertieVitesse de relâchement >6px/événement → commence par v*1.05, multiplie par 0.94 chaque image, finit quand <1px et s'accroche
développement136×48 → 236×296, le bord inférieur ne bouge pas : ty = lay.y + lay.h - 296 ; les éléments de menu apparaissent en fondu de hauteur 110→250, n'activent pointerEvents qu'à mi-parcours
séparationDock 300 → gauche 140 ; la partie droite tx est verrouillée à lay.x + lay.w - 140, largeur 0→140
fusionLa partie droite réduit d'abord sa largeur, la position ne bouge pas (éviter de « glisser »)
combinaisonAprès séparation, un espace de 20px est conservé entre les deux parties, les rims se répondent mutuellement ; une véritable union metaball nécessite SDF smooth-min, la version Web en un seul passage ne la fait pas
ressortPosition ω=15, largeur ω=18.5, ζ=0.66, dt=1/60 → environ 0.45s, 6% de dépassement

5. Recettes de paramètres

Effet recherchérefractmagrimdisptintthick
Capsule en verre épais1.200.350.950.220.24✓
Barre de lentille avec bandes de couleur1.500.601.000.180.10✓
Couvercle en verre épais avec petits caractères1.250.420.800.300.16✓
Navigation supérieure (sobre)0.900.200.600.150.10✗
Panneau de contrôle (lisible)1.000.150.550.120.14✗

Ordre d'ajustement : refract pour la position → mag pour la lèvre → rim pour le bord → disp/tint pour la texture, dans l'ordre inverse, vous vous battrez en boucle.

6. Huit pièges inévitables

  1. Les tableaux uniform ne sont pas fiables : uGeo[12] sur ANGLE/D3D ne donne pas d'erreur d'affectation mais ne passe pas → un appel de dessin par panneau.
  2. Les branches uniform dans les boucles sont optimisées : utilisez mix / step sans branche dans les boucles.
  3. Un uniform déclaré mais inutilisé est optimisé, getUniformLocation retourne null, ce qui fait croire à l'absence d'un uniform.
  4. gl.getUniform(prog, null) lance une TypeError, tout le code de l'image suivante est sauté (cela semble comme un plantage).
  5. Axe Y de la texture : si vous ne l'inversez pas, vous obtenez une image miroir + un texte inversé.
  6. Ne lier que click fait perdre des événements : utilisez pointerdown + pointerup + seuil de déplacement.
  7. half est un mot réservé de GLSL ES : écrire vec2 half fait échouer la compilation de tout le bloc, le journal ne dit que syntax error. Même piège avec filter / input / output / long / short / packed.
  8. smoothstep en ordre inverse est un comportement indéfini : smoothstep(1.0,-1.0,d) plante sur une autre machine ; écrivez toujours 1.0 - smoothstep(petit,grand,x).

Deux pièges supplémentaires spécifiques à la couche d'action :

  • Après un appui long, le relâchement ne doit pas être compté comme un clic unique (marque longFired), sinon le menu d'appui long s'ouvre et est immédiatement suivi d'un développement.
  • Le clic droit doit être intercepté avant pointerdown (e.button !== 0 pour retour direct), sinon le clic droit déclenche le glisser.

7. Validation (à chaque modification)

?selftest=1 couvre 13 tests : clic développement/rétractation, bulle appui long, Échap ferme la bulle, clic droit pour un autre menu, séparation et fusion du Dock, cou de fusion, sélection par touches directionnelles, Échap rétractation globale, double-clic soulèvement, inertie, W pour le champ lumineux.

Confirmez également manuellement :

  • Le contenu dans le verre est dans le bon sens (pas d'inversion, pas de miroir)
  • Le rim sur tout le bord, le miroir supérieur, l'arc inférieur lumineux sont tous présents
  • Sous un fond sombre, l'intérieur du verre n'est pas d'un noir absolu (a une grisaille brumeuse)
  • Lors du glisser, l'ombre est en retard, et après le relâchement, il y a une inertie avant l'accrochage
  • Lors de la séparation, les deux parties « se fissurent », pas « se tirent l'une contre l'autre »
  • Le texte défilant s'estompe aux bords, et au point final, il passe en mode hard avec un filigrane
  • Les trois commutateurs d'accessibilité fonctionnent (réduire l'opacité / augmenter le contraste / réduire le mouvement)

8. Budget de performance

ÉlémentBudget
Verres à l'écran≤10 (cette implémentation en a 10, incluant les bulles et ponts de largeur nulle qui apparaissent à la demande)
Appels de dessin2 programmes + un dessin AABB par bloc
Téléchargement du fondToutes les 5 images ; au repos, toutes les 8 images
Échantillonnage de la luminositéToutes les 10 images, seulement pour les panneaux w*h>24000
Facteur de rendu<42fps → 0.72, >56fps → 1.0, limite DPR à 2
Chaîne de dégradationRéduire les panneaux → réduire le facteur → réduire le téléchargement → désactiver la dispersion chromatique → revenir à la version CSS

9. Lignes rouges et limites de la plateforme

  • Le verre est uniquement placé dans la couche de navigation ; la couche de contenu n'est pas recouverte de verre.
  • Ne pas empiler les verres (perte de la référence de réfraction, comme une tache sale) ; Régulier et Clair ne sont pas mélangés sur le même écran.
  • La teinte (tint) est réservée à l'action principale ; les surbrillances sont limitées ; rim > 1.2 donne un aspect faux.
  • Le Web ne peut pas : le texte/icônes sur le verre ne sont pas réfractés par lui-même (c'est le pipeline de composition du système iOS 26) ; le repli CSS ne peut pas produire une lèvre de lentille pixel par pixel avec dispersion chromatique.
  • Non couvert par la version auto-dessinée : véritable union metaball (cette implémentation utilise un cou étroit comme approximation), éclairage par inclinaison de l'appareil, statistiques de couleur principale image par image sur une vidéo en direct.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés