SwiftUI Liquid Glass
Aperçu
Utilisez cette compétence pour construire ou réviser des fonctionnalités SwiftUI qui s'alignent parfaitement avec l'API Liquid Glass d'iOS 26+. Privilégiez les API natives (glassEffect, GlassEffectContainer, les 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 flux de travail
Choisissez le chemin qui correspond à la demande :
1) Réviser une fonctionnalité existante
- Inspectez où Liquid Glass doit être utilisé et où il ne doit 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é pour iOS 26+ et les solutions de repli raisonnables.
2) Améliorer une fonctionnalité avec Liquid Glass
- Identifiez les composants cibles pour un traitement en verre (surfaces, chips, boutons, cartes).
- Refactorez pour utiliser
GlassEffectContainerlorsque plusieurs éléments en verre apparaissent. - Introduisez du verre interactif uniquement pour les éléments tactiles ou focalisables.
3) Implémenter une nouvelle fonctionnalité avec Liquid Glass
- Concevez d'abord les surfaces en verre et leurs 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 de base
- Préférez les API natives Liquid Glass aux flous personnalisés.
- Utilisez
GlassEffectContainerlorsque 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 apparentés pour un aspect homogène.
- Protégez avec
#available(iOS 26, *)et fournissez une solution de repli non-verre.
Liste de vérification pour la révision
- Disponibilité :
#available(iOS 26, *)présent avec une interface utilisateur de repli. - Composition : Plusieurs vues en verre encapsulées dans
GlassEffectContainer. - Ordre des modificateurs :
glassEffectappliqué après les modificateurs de mise en page/apparence. - Interactivité :
interactive()uniquement là où l'interaction utilisateur existe. - Transitions :
glassEffectIDutilisé avec@Namespacepour le morphing. - Cohérence : Les formes, la teinte et l'espacement sont alignés sur l'ensemble de 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
GlassEffectContaineret ajustez l'espacement. - Utilisez
.glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))selon les besoins. - Utilisez
.buttonStyle(.glass)/.buttonStyle(.glassProminent)pour les actions. - Ajoutez des transitions morphiques avec
glassEffectIDlorsque la hiérarchie change. - Fournissez des matériaux et visuels de repli pour les versions iOS antérieures.
Extraits rapides
Utilisez ces modèles directement et adaptez les formes/teintes/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.