Communitygithub.com

Liquid Glass · Vollständige Implementierung

Apple WWDC25 Liquid Glass vollständig implementiert: 26 Materialeigenschaften + 82 Aktionen. Einfach ladbare, eigenständige HTML-Datei mit WebGL-Fragment-Shader, die unter ‚?selftest=1‘ 13 Selbsttests ausführt.

Was ist Liquid Glass · Vollständige Implementierung?

Dieses Skill implementiert den Apple WWDC25 Liquid Glass Look vollständig in einer einzigen, direkt ausführbaren HTML-Datei (liquid-glass-all.html). Es nutzt einen WebGL-Fragment-Shader (2 Programme, 10 Draw Calls) für alle Glas-Effekte: Brechung, Dicke, Fresnel, Dispersion, innere Leuchten – das DOM trägt nur Text, Buttons und Schatten. Insgesamt deckt das Skill **82 Aktionen** in 9 Kategorien ab (Zeiger, Drag mit Trägheit, Morphing, Druckrückmeldung, optische Animationen, Adaptive, System/Barrierefreiheit, Steuerelemente, Tastatur). Die Shader-Pipeline folgt einer festen siebenstufigen Reihenfolge (Kontur, konvexes Höhenfeld, Einfallswinkel, Dicke, Verschiebung, Fokus/Lippe, Compositing), die für realistische Glas-Optik entscheidend ist. Das Skill enthält eine Selbsttest‑Suite (?selftest=1) mit 13 Tests, einen konfigurierbaren Parameter-Satz (refract, mag, rim, disp, tint, thick) und zahlreiche Fallstricke, die beim Nachbauen von Glas-Shadern passieren (z.B. uniform-Arrays unter ANGLE/D3D, GLSL-Reservierte Wörter wie half). Es läuft in jedem modernen Browser (Chrome, Edge, Safari) und wurde mit Headless Chrome getestet. Entwickler können damit schnell eine voll funktionsfähige Liquid Glass Komponente in eigene Projekte einbauen oder als Referenz für Shader- und Interaktions-Entwicklung nutzen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Liquid Glass · Vollständige Implementierung?

Einzeldatei-WebGL-Implementierung: Glasbrechung, Dicke, Fresnel, Dispersion, Lippe, inneres Leuchten – alles im Fragment-Shader berechnet. Das DOM trägt nur Text, Buttons und Schatten. Shader nicht von Grund auf neu schreiben: 90 Zeilen reichen für den Lauf, aber 400 Zeilen von Null haben extrem geringe Erfolgswahrscheinlichkeit. Von liquid-glass-all.html aus anpassen.

0. Schnellster Weg (1 Minute bis zum Effekt)

  1. Chrome / Edge: liquid-glass-all.html öffnen.
  2. Rechtes Steuerfeld: 5 Schieberegler (refract / mag / rim / disp / tint) + 4 Rezept-Buttons. Änderungen sofort sichtbar.
  3. Alle Aktionen enthalten: Klick auf Kapsel zum Aufklappen, gedrückt halten und ziehen, langer Druck erzeugt Blase, Rechtsklick öffnet anderes Menü, Doppelklick hebt an, Dock-Trenntaste, Tastatur Leertaste/S/W/Esc.
  4. Abnahme mit integriertem Selbsttest: ?selftest=1 an die Adresse anhängen. Oben links erscheinen 13 Zeilen PASS / FAIL.
  5. Screenshot-Pose: ?pose=1 zeigt „Aufgeklappt + Getrennt + Blase“; ?pose&wire=1 zusätzlich optisches Diagnosefeld.
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
  --window-size=1280,800 --screenshot=out.png "file:///<absoluterPfad>/liquid-glass-all.html?selftest=1"

Nach dem Screenshot das Bild wirklich lesen und prüfen, dass oben links FAIL 0 steht. Nicht nur aufgrund des Codes sagen, dass es fertig ist.

1. Assets

liquid-glass-all/
├── SKILL.md                       # Diese Datei: Pfade, Aktionen, Optik, Fallstricke, Abnahme
├── liquid-glass-all.html          # Vollständige Implementierung (einziges Laufzeit-Ergebnis)
└── references/
    ├── action-matrix.md           # Vollständige Tabelle der 82 Aktionen (Auslöser / Was ändert sich / Parameter / Umkehrung)
    ├── feature-matrix.md          # 26 Materialeigenschaften × Abdeckung dieser Implementierung
    ├── optics-model.md            # Physikmodell des Lichtwegs und Konstanten (vor dem Shader-Schreiben lesen)
    └── interaction-playbook.md    # Zustandsmaschine, Timing, Treffertests, Abnahme

2. Schnellübersicht der 82 Aktionen (9 Kategorien)

Vollständige Tabelle siehe references/action-matrix.md. Hier nur das Gerüst:

KategorieAnzahlInhalt
A Zeiger13Hover Ein/Bewegen/Aus, Umfeld-Abklingen, Press, Release, Klick, Drag Start/Follow/Rücksprung, Rand-Clamp, Rechtsklick-Menü, Langdruck-Menü
B Drag-Trägheit6Richtungszug, elastische Verschiebung, Verformungsabklingen, Trägheitsgleiten, Drag-Anhebung, Nachlauf-Schatten
C Morph10Auf-/Zuklappen, Menüpunkt-Einblendung, abgerundete Ecken folgen, Trennen/rechtes Teil wächst/ Zusammenführen, Spalt-Betonung, Nullbreite Überspringen, Verschmelzungsverbindungshals
D Druckrückmeldung8Einrücken, Brechungsverstärkung, Dickenzunahme, inneres Leuchten, Nachbarplatten-Ausbreitung, unterer Bogen heller, Richtungs-Highlight, Flash-Wegweiser
E Optische Animationen8Drei Brechungsmodi, Variantenwechsel, Tint-Mapping, Hell-Dunkel-Umkehr, Umgebungs-Überfarbe, adaptiver Schatten, Defokus-Ausblenden, Hintergrundlichtflecken-Wandern
F Adaptiv7Helligkeit/Hauptfarbe abtasten, Hintergrund hochladen, adaptive Auflösung, Optik-Aktualisierung, DPR-Obergrenze, Degradationskette
G System & Barrierefreiheit8Resize-Neuberechnung, Scrollen soft/hard, drei Barrierefreiheits-Schalter, Fenster-Unschärfe, Tab-Fokus-Ring, Screenreader-Semantik
H Steuerelemente8Hauptaktions-Button, 5 Schieberegler, Varianten-Segment, Modus-Dreifach-Button, 4 Schalter, 4 Rezepte, Trenntaste, Aufklappkopf
K Tastatur7Leertaste / S / W / Esc / Tab / ↑↓ / Enter

Aktionsüberwachungsleiste unten auf der Seite: Jede Aktion wird protokolliert und die letzten 4 werden angezeigt – dient zur Bestätigung, ob eine Aktion ausgelöst wurde.

3. Sieben Schritte des Lichtwegs (Reihenfolge unveränderlich)

  1. Kontur: sdRoundBox liefert vorzeichenbehafteten Abstand d; x = clamp(-d/band, 0, 1), 0=Kontur, 1=Zentrum, band = max(5, min(hx,hy)*0.30).
  2. Konvexes Höhenfeld: H(x)=sqrt(1-(1-x)²), H'(x)=v/sqrt(1-v²) (v=clamp(1-x,0.02,0.9995)). sqrt statt pow verwenden.
  3. Einfallswinkel: sinI = min(H'/sqrt(1+H'²), 0.62), thT = asin(sinI/1.5168). 0.62 ist harte Obergrenze; bei 0.93 wird die Kante auf 200px Niveau geschoben, das ganze Stück wird schwarz.
  4. Dicke: tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg, vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y)) (unten dick, oben dünn).
  5. Verschiebung: off = -dir*tan(thI-thT)*tpx*refract*Tf, plus Rand-Term; abschließend clamp(off,-10,10).
  6. Fokus/Lippe: focal = mag*magMul*(0.50*cW - 0.40*eW); 1-focal muss immer positiv sein, sonst lokale 180°-Umkehrung, Buchstaben stehen kopf. magMul ist panel-spezifisch: Linse 1.30 / Kapsel 0.85 / Platte 0.55 / Navi 0.90 / Dock 0.80.
  7. Compositing: sp = c + rel*(1-focal) - off; RGB getrennt nach ±disp*7*eW abtasten; dann Tint-Helligkeitskompression 0.58*L+0.133, Umgebungs-Überfarbe 0.10, Fresnel-Rim, milchig, obere Spiegelung, unterer Bogen, inneres Leuchten.

Textur Y muss gespiegelt werden: uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y). Fehlt diese Zeile, ergibt sich ein gespiegeltes Bild + kopfstehender Text.

4. Zustandsmaschine und wichtige Schwellenwerte

AktionSchwelle / Parameter
HoverInnerhalb Panel; außerhalb 180px fade-Abklingen
Presspress→1 (k=0.19/Frame), scale 0.965, Brechung ×1.3, unterer Bogen ×1.75
Klickpointerup und Verschiebung ≤4px → 240 ms verzögert auslösen, um Konflikt mit Doppelklick zu vermeiden
DoppelklickZwei pointerdown-Ereignisse <300 ms auseinander; zweites down sofort Klick-Timer abbrechen
Langdruck500 ms nach pointerdown; Bewegung >4px bricht ab; Fortschrittspunkt am Berührungspunkt vergrößert
DragErst bei Verschiebung >4px in Drag umschalten; clamp 8px Innenabstand
TrägheitLoslassgeschwindigkeit >6px/Ereignis → Start bei v*1.05, pro Frame ×0.94, endet bei <1px und einrasten
Aufklappen136×48 → 236×296, Unterkante bleibt: ty = lay.y + lay.h - 296; Menüpunkte von Höhe 110→250 einblenden, pointerEvents erst nach Hälfte aktiv
TrennenDock 300 → links 140; rechtes Teil tx fixiert auf lay.x + lay.w - 140, Breite 0→140
ZusammenführenRechtes Teil zuerst Breite einziehen, Position bleibt (um „Wegrutschen“ zu vermeiden)
VerschmelzungNach Trennung 20px Spalt zwischen beiden Teilen; Rim korrespondiert; echtes Metaball-Vereinigung benötigt SDF smooth-min – Web Single-Pass-Version nicht implementiert
FederPosition ω=15, Breite ω=18.5, ζ=0.66, dt=1/60 → ca. 0.45s, 6% Überschwingen

5. Parameter-Rezepte

Gewünschtrefractmagrimdisptintthick
Dicke Glaskapsel1.200.350.950.220.24✓
Linse auf Farbstreifen1.500.601.000.180.10✓
Dicke Glasabdeckung kleine Schrift1.250.420.800.300.16✓
Obere Navigation (dezent)0.900.200.600.150.10✗
Steuerfeld (lesbar)1.000.150.550.120.14✗

Parametrierreihenfolge: refract legt Verschiebung fest → mag legt Lippe fest → rim legt Rand fest → disp/tint legen Textur fest. Umgekehrt kommt es ständig zu Konflikten.

6. Acht zwingend zu vermeidende Fallstricke

  1. uniform-Arrays sind nicht zuverlässig: uGeo[12] unter ANGLE/D3D wird ohne Fehler zugewiesen, erreicht aber nicht den Shader → pro Panel ein Draw Call.
  2. uniform-Verzweigungen in Schleifen werden wegoptimiert: In Schleifen mix / step ohne Verzweigung verwenden.
  3. Nicht verwendete uniforms werden optimiert, getUniformLocation gibt null zurück, fälschlicherweise „fehlendes uniform“ gemeldet.
  4. gl.getUniform(prog, null) wirft TypeError, der gesamte folgende Code der Framestelle wird übersprungen (sieht aus wie Einfrieren).
  5. Textur Y-Achse: Ohne Spiegelung ergibt sich ein gespiegeltes Bild + kopfstehender Text.
  6. Nur click binden führt zu verlorenen Ereignissen: pointerdown + pointerup + Verschiebungsschwellwert verwenden.
  7. half ist reserviertes Wort in GLSL ES: vec2 half führt zu Kompilierungsfehler der gesamten Shader-Einheit, Log sagt nur syntax error. Ähnliche Minen: filter / input / output / long / short / packed.
  8. Umgekehrter smoothstep ist undefiniertes Verhalten: smoothstep(1.0,-1.0,d) verhält sich auf verschiedenen Maschinen unterschiedlich; immer 1.0 - smoothstep(klein,groß,x) schreiben.

Zwei zusätzliche aktionsspezifische Fallstricke:

  • Nach langem Druck darf ein Loslassen nicht als Klick zählen (longFired-Flag), sonst öffnet sich nach dem Langdruck-Menü sofort ein weiteres Aufklappen.
  • Rechtsklick muss vor pointerdown abgefangen werden (e.button !== 0 direkt return), sonst startet Rechtsklick einen Drag.

7. Abnahme (nach jeder Änderung ausführen)

?selftest=1 deckt 13 Tests ab: Klick Aufklappen/Zuklappen, Langdruck-Blase, Esc schließt Blase, Rechtsklick öffnet anderes Menü, Dock Trennen/Zusammenführen, Verschmelzungshals, Pfeiltasten Auswahl, Esc globales Zuklappen, Doppelklick Anheben, Trägheit, W Optikfeld.

Zusätzlich manuell prüfen:

  • Inhalt im Glas korrekt ausgerichtet (keine Kopfstände, keine Spiegelung)
  • Rand-Rim, obere Spiegelung, unterer heller Bogen vollständig vorhanden
  • Bei dunklem Hintergrund ist das Glasinnere nicht totschwarz (nebliges Grau)
  • Beim Drag hinkt der Schatten hinterher, Loslassen hat Trägheit und rastet dann ein
  • Beim Trennen sind die beiden Teile „aufgebrochen“, nicht „auseinandergezogen“
  • Scrollender Text verblasst am Rand, am Ende wechselt zu hard Hairline
  • Alle drei Barrierefreiheits-Schalter wirken (Transparenz verringern / Kontrast erhöhen / Dynamik verringern)

8. Leistungsbudget

PostenBudget
Gleichzeitige Glasscheiben≤10 (diese Implementierung 10, inkl. bei Bedarf erscheinende Blase/Brücke mit Breite 0)
Draw Calls2 Programme + pro Scheibe ein AABB-Draw
Hintergrund-UploadAlle 5 Frames; bei Ruhe alle 8 Frames
HelligkeitsabtastungAlle 10 Frames, nur bei Panels mit w*h>24000
Render-Skalierung<42fps → 0.72; >56fps → 1.0; DPR-Obergrenze 2
DegradationsketteScheibenanzahl reduzieren → Skalierung senken → Upload reduzieren → Dispersion ausschalten → auf CSS-Version zurückfallen

9. Grenzlinien und Plattformgrenzen

  • Glas nur in der Navigationsebene; Inhaltsebene kein Glas.
  • Keine überlappenden Glasscheiben (verliert Brechungsreferenz, wirkt wie Schmutzflecken); Regular und Clear nicht gleichzeitig auf einem Bildschirm verwenden.
  • Tint nur für Hauptaktion; Highlights dezent halten; rim > 1.2 wirkt falsch.
  • Im Web nicht machbar: Text/Icons auf Glas werden nicht durch das Glas selbst gebrochen (das ist iOS 26 System Compositing Pipeline); CSS-Notfall kann keine pixelgenaue Linsenlippe und Dispersion erzeugen.
  • Nicht durch Eigenzeichnung abgedeckt: Echte Metaball-Vereinigung (diese Implementierung verwendet schmalen Hals als Näherung), geräteneigungsabhängige Beleuchtung, frame-genaue Hauptfarbstatistik von Live-Video.

Individual skills in this repo

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

Verwandte Skills