SwiftUI Liquid Glass
Atribución: copiado de Dimillian/Skills de @Dimillian (2025-12-31).
Resumen
Usa esta habilidad para construir o revisar características de SwiftUI que se alineen completamente con la API Liquid Glass de iOS 26+. Prioriza las APIs nativas (glassEffect, GlassEffectContainer, estilos de botón de vidrio) y las guías de diseño de Apple. Mantén un uso consistente, interactivo donde sea necesario y consciente del rendimiento.
Árbol de Decisión del Flujo de Trabajo
Elige la ruta que coincida con la solicitud:
1) Revisar una característica existente
- Inspecciona dónde se debe usar Liquid Glass y dónde no.
- Verifica el orden correcto de modificadores, el uso de formas y la colocación de contenedores.
- Comprueba el manejo de disponibilidad para iOS 26+ y fallbacks razonables.
2) Mejorar una característica usando Liquid Glass
- Identifica los componentes objetivo para el tratamiento de vidrio (superficies, chips, botones, tarjetas).
- Refactoriza para usar
GlassEffectContainerdonde aparezcan múltiples elementos de vidrio. - Introduce vidrio interactivo solo para elementos táctiles o enfocables.
3) Implementar una nueva característica usando Liquid Glass
- Diseña primero las superficies de vidrio y las interacciones (forma, prominencia, agrupación).
- Agrega modificadores de vidrio después de los modificadores de diseño/apariencia.
- Agrega transiciones de morphing solo cuando la jerarquía de vistas cambie con animación.
Directrices Principales
- Prefiere las APIs nativas de Liquid Glass sobre los desenfoques personalizados.
- Usa
GlassEffectContainercuando varios elementos de vidrio coexistan. - Aplica
.glassEffect(...)después de los modificadores de diseño y visuales. - Usa
.interactive()para elementos que responden al tacto/pointer. - Mantén las formas consistentes en elementos relacionados para una apariencia cohesiva.
- Protege con
#available(iOS 26, *)y proporciona un fallback sin vidrio.
Lista de Verificación de Revisión
- Disponibilidad:
#available(iOS 26, *)presente con UI de fallback. - Composición: Vistas de vidrio múltiples envueltas en
GlassEffectContainer. - Orden de modificadores:
glassEffectaplicado después de modificadores de diseño/apariencia. - Interactividad:
interactive()solo donde existe interacción del usuario. - Transiciones:
glassEffectIDusado con@Namespacepara morphing. - Consistencia: Formas, tintes y espaciado alineados en toda la característica.
Lista de Verificación de Implementación
- Define los elementos objetivo y la prominencia de vidrio deseada.
- Envuelve los elementos de vidrio agrupados en
GlassEffectContainery ajusta el espaciado. - Usa
.glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))según sea necesario. - Usa
.buttonStyle(.glass)/.buttonStyle(.glassProminent)para acciones. - Agrega transiciones de morphing con
glassEffectIDcuando la jerarquía cambie. - Proporciona materiales y visuales de fallback para versiones anteriores de iOS.
Fragmentos Rápidos
Usa estos patrones directamente y adapta formas, tintes y espaciado.
if #available(iOS 26, *) {
Text("Hello")
.padding()
.glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
Text("Hello")
.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("Confirmar") { }
.buttonStyle(.glassProminent)
Recursos
- Guía de referencia:
references/liquid-glass.md - Prefiere la documentación de Apple para obtener detalles actualizados de la API.