Communitygithub.com

steipete/swiftui-liquid-glass

SwiftUI Liquid Glass : implémenter, adopter, refactoriser, vérifier la correction/performance/conception.

Qu'est-ce que swiftui-liquid-glass ?

Cette compétence est conçue pour les développeurs travaillant avec l'API Liquid Glass de SwiftUI, introduite avec iOS 26+. Elle guide l'implémentation, l'adoption, la refactorisation et la revue de fonctionnalités utilisant les APIs natives de Liquid Glass, comme `glassEffect`, `GlassEffectContainer` et les styles de boutons en verre. La compétence propose un arbre de décision pour choisir entre revoir une fonctionnalité existante, l'améliorer avec Liquid Glass, ou en implémenter une nouvelle. Elle fournit des directives précises sur l'ordre des modificateurs, l'utilisation des conteneurs, et la gestion de la disponibilité avec `#available(iOS 26, *)`. Des checklists de revue et d'implémentation, ainsi que des extraits de code prêts à l'emploi, aident à garantir une utilisation cohérente, interactive et performante. Les plateformes cibles incluent les applications iOS utilisant SwiftUI, et la compétence met l'accent sur les API natives plutôt que les flous personnalisés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swiftui-liquid-glass

Demander à votre IA préférée

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

Documentation

SwiftUI Liquid Glass

Attribution : copié depuis Dimillian/Skills de @Dimillian (2025-12-31).

Aperçu

Utilisez cette compétence pour construire ou revoir des fonctionnalités SwiftUI qui s'alignent pleinement sur l'API Liquid Glass d'iOS 26+. Privilégiez les API natives (glassEffect, GlassEffectContainer, styles de boutons en verre) et les recommandations de conception d'Apple. Maintenez une utilisation cohérente, interactive si nécessaire, et consciente des performances.

Arbre de décision du workflow

Choisissez le chemin correspondant à la demande :

1) Revoir une fonctionnalité existante

  • Inspectez les endroits où Liquid Glass devrait être utilisé et où il ne devrait pas l'être.
  • Vérifiez l'ordre correct des modificateurs, l'utilisation des formes et le placement des conteneurs.
  • Vérifiez la gestion de la disponibilité iOS 26+ et les solutions de repli sensées.

2) Améliorer une fonctionnalité avec Liquid Glass

  • Identifiez les composants cibles pour le traitement en verre (surfaces, chips, boutons, cartes).
  • Refactorisez pour utiliser GlassEffectContainer là où plusieurs éléments en verre apparaissent.
  • Introduisez du verre interactif uniquement pour les éléments tactiles ou pouvant être ciblés.

3) Implémenter une nouvelle fonctionnalité avec Liquid Glass

  • Concevez d'abord les surfaces en verre et les interactions (forme, proéminence, regroupement).
  • Ajoutez les modificateurs de verre après les modificateurs de mise en page/apparence.
  • Ajoutez des transitions morphiques uniquement lorsque la hiérarchie des vues change avec animation.

Directives principales

  • Préférez les API Liquid Glass natives aux flous personnalisés.
  • Utilisez GlassEffectContainer lorsque plusieurs éléments en verre coexistent.
  • Appliquez .glassEffect(...) après les modificateurs de mise en page et visuels.
  • Utilisez .interactive() pour les éléments qui répondent au toucher/pointeur.
  • Gardez des formes cohérentes entre les éléments associés pour un aspect homogène.
  • Encadrez avec #available(iOS 26, *) et fournissez une solution de repli sans verre.

Liste de vérification pour la revue

  • Disponibilité : #available(iOS 26, *) présent avec une interface de repli.
  • Composition : Plusieurs vues en verre encapsulées dans GlassEffectContainer.
  • Ordre des modificateurs : glassEffect appliqué après les modificateurs de mise en page/apparence.
  • Interactivité : interactive() uniquement là où une interaction utilisateur existe.
  • Transitions : glassEffectID utilisé avec @Namespace pour le morphing.
  • Cohérence : Les formes, les teintes et l'espacement sont alignés dans toute la fonctionnalité.

Liste de vérification pour l'implémentation

  • Définissez les éléments cibles et la proéminence du verre souhaitée.
  • Encapsulez les éléments en verre groupés dans GlassEffectContainer et ajustez l'espacement.
  • Utilisez .glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...)) si nécessaire.
  • Utilisez .buttonStyle(.glass) / .buttonStyle(.glassProminent) pour les actions.
  • Ajoutez des transitions morphiques avec glassEffectID lorsque la hiérarchie change.
  • Fournissez des matériaux et visuels de repli pour les versions antérieures d'iOS.

Extraits rapides

Utilisez ces modèles directement et adaptez les formes, teintes et espacements.

if #available(iOS 26, *) {
    Text("Bonjour")
        .padding()
        .glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
    Text("Bonjour")
        .padding()
        .background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
}
GlassEffectContainer(spacing: 24) {
    HStack(spacing: 24) {
        Image(systemName: "scribble.variable")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
        Image(systemName: "eraser.fill")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
    }
}
Button("Confirmer") { }
    .buttonStyle(.glassProminent)

Ressources

  • Guide de référence : references/liquid-glass.md
  • Privilégiez la documentation Apple pour des détails d'API à jour.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills associés