Sea Glass

Los roles de MaterialTheme.colorScheme y los tokens de SeaGlassTheme.colors son independientes: cambiar uno no deriva automáticamente el otro. Ajusta los pares de color de fondo y contenido para conservar el contraste.

Para evitar cargar las fuentes incluidas, proporciona tus familias:

fonts = SeaGlassFonts(
    FontFamily.SansSerif,
    FontFamily.SansSerif,
    FontFamily.Monospace,
)

FontFamily pertenece a androidx.compose.ui.text.font. Si proporcionas tanto typography como extraTypography, tampoco se cargan las fuentes predeterminadas. Si proporcionas solo una, la otra conserva su preset y puede cargarlas.

Los botones mantienen su geometría expresiva según square y size; las formas decorativas de SeaGlassShapes son independientes de Material Shapes.

Los temas anidados inician una configuración nueva, incluidos backdrop, etiquetas, movimiento y superficies. Reutiliza explícitamente config y backdrop cuando quieras heredarlos.

El módulo opcional seaglass-haze utiliza Haze 1.5.3.

import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import dev.chrisbanes.haze.HazeState
import io.github.mariorsh.seaglass.compose.*
import io.github.mariorsh.seaglass.haze.*

@Composable
fun BlurExample() {
    SeaGlassTheme {
        val haze = remember { HazeState() }
        val backdrop = rememberHazeBackdrop(haze)

        SeaGlassTheme(backdrop = backdrop) {
            Box {
                LazyColumn(Modifier.seaGlassHazeSource(haze)) {
                    items(100) {
                        Text("Contenido detrás: $it", Modifier.padding(24.dp))
                    }
                }
                Box(Modifier.glassPanel().padding(24.dp)) {
                    Text("Contenido nítido")
                }
            }
        }
    }
}

La fuente y la superficie son hermanas: no captures el contenedor que incluye el propio efecto. Fuente y efecto deben estar en la misma ventana.

rememberHazeBackdrop utiliza HazeDefaults.blurEnabled() como comprobación conservadora de disponibilidad. Android API 31 y anteriores usan fallback. Los wrappers de diálogos y menús desactivan el backdrop entre ventanas; el bottom sheet conserva un relleno legible.

glass() y glassPanel() comparten SeaGlassSurfaceStyle. Usa forceFallback = true para forzar el relleno de reserva.

GlassBackdrop.isBlurAvailable declara soporte y vale false por defecto. Instalar un adaptador no demuestra disponibilidad; GlassBackdrop.available(adapter) permite declararla explícitamente cuando ya la hayas comprobado.

Precedencia de opacidad:

1. Opaque fuerza alpha 1.
2. Un color explícito conserva su alpha en los demás modos.
3. Sin color explícito, se utilizan los tokens y la política del tema.

Un color explícito translúcido conserva su transparencia en fallback; comprueba su contraste. Sin color explícito, el mínimo predeterminado es 0.9 en vidrio y 0.85 en paneles.

En blur, opacityMultiplier modula la opacidad. shadowMultiplier, borderWidth y highlightMultiplier controlan el acabado. Los paneles conservan su relleno y elevación base de 10 dp; los niveles de vidrio mantienen sus valores de elevación, opacidad y blur.

Compose aplica la escala de duración del host cuando está disponible. Usa el control explícito de movimiento reducido para una preferencia uniforme entre plataformas.

Los grupos de botones hacen morphing sin crecimiento horizontal. Usa Modifier.weight(1f) para repartir ancho; los grupos conectados y segmentados distribuyen el espacio y admiten etiquetas multilínea.

Los modales delegan foco y cierre con Atrás/Escape al host. SgAlertDialog y SgFullScreenDialog exponen DialogProperties. La restauración del foco al control lanzador y el comportamiento con tecnologías de asistencia requieren validación en cada host.

Consulta la matriz de validación para distinguir las comprobaciones automatizadas de las revisiones visuales pendientes.