SwiftUI Liquid Glass
Resumen
Usa este skill para construir o revisar características de SwiftUI que se alineen completamente con la API Liquid Glass de iOS 26+. Prioriza las API nativas (glassEffect, GlassEffectContainer, estilos de botón de vidrio) y las guías de diseño de Apple. Mantén el uso consistente, interactivo cuando sea necesario y consciente del rendimiento.
Árbol de Decisión de Flujo de Trabajo
Elige el camino 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 ubicación de contenedores.
- Comprueba el manejo de disponibilidad para iOS 26+ y las alternativas sensatas.
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 tocables 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 morphing solo cuando la jerarquía de vistas cambie con animación.
Directrices Clave
- Prefiere las API nativas de Liquid Glass sobre 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 un aspecto cohesionado.
- Condiciona con
#available(iOS 26, *)y proporciona una alternativa sin vidrio.
Lista de Verificación de Revisión
- Disponibilidad:
#available(iOS 26, *)presente con interfaz de usuario alternativa. - Composición: Varias vistas de vidrio envueltas en
GlassEffectContainer. - Orden de modificadores:
glassEffectaplicado después de modificadores de diseño/apariencia. - Interactividad:
interactive()solo donde exista interacción del usuario. - Transiciones:
glassEffectIDusado con@Namespacepara morphing. - Consistencia: Las formas, tintes y espaciados se alinean en toda la característica.
Lista de Verificación de Implementación
- Define los elementos objetivo y la prominencia de vidrio deseada.
- Envuelve 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 morphing con
glassEffectIDcuando cambie la jerarquía. - Proporciona materiales y visuales alternativos para versiones anteriores de iOS.
Fragmentos Rápidos
Usa estos patrones directamente y ajusta formas, tintes y espaciados.
if #available(iOS 26, *) {
Text("Hola")
.padding()
.glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
Text("Hola")
.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 los documentos de Apple para detalles actualizados de la API.