Switch

El componente Switch permite a los usuarios alternar entre dos estados: marcado y desmarcado. En tu app, puedes usar un interruptor para permitir que el usuario realice una de las siguientes acciones:

• Activa o desactiva un parámetro de configuración.
• Habilita o inhabilita una función.
• Selecciona una opción.

El componente tiene dos partes: el círculo y la pista. El círculo es la parte arrastrable del interruptor, y la pista es el fondo. El usuario puede arrastrar el pulgar hacia la izquierda o la derecha para cambiar el estado del interruptor. También pueden presionar el interruptor para comprobarlo y borrarlo.

Figura 1: El componente switch.

Implementación básica

Consulta la referencia de Switch para obtener una definición completa de la API. Los siguientes son algunos de los parámetros clave que quizás debas usar:

• checked: Es el estado inicial del interruptor.
• onCheckedChange: Es una devolución de llamada a la que se llama cuando cambia el estado del interruptor.
• enabled: Indica si el interruptor está habilitado o inhabilitado.
• colors: Los colores que se usaron para el cambio

El siguiente ejemplo es una implementación mínima del elemento Switch componible.

@Composable
fun SwitchMinimalExample() {
    var checked by remember { mutableStateOf(true) }

    Switch(
        checked = checked,
        onCheckedChange = {
            checked = it
        }
    )
}
Switch.kt

Esta implementación se muestra de la siguiente manera cuando no se marca:

Figura 2: Un interruptor desmarcado

Esta es la apariencia cuando se marca:

Figura 3: Un interruptor marcado.

Implementación avanzada

Los parámetros principales que puedes usar cuando implementas un interruptor más avanzado son los siguientes:

• thumbContent: Usa esta opción para personalizar la apariencia del pulgar cuando está marcado.
• colors: Usa esta opción para personalizar el color de la pista y el círculo.

Miniatura personalizada

Puedes pasar cualquier elemento componible para el parámetro thumbContent para crear un dedo personalizado. A continuación, se muestra un ejemplo de un interruptor que usa un ícono personalizado como círculo:

@Composable
fun SwitchWithIconExample() {
    var checked by remember { mutableStateOf(true) }

    Switch(
        checked = checked,
        onCheckedChange = {
            checked = it
        },
        thumbContent = if (checked) {
            {
                Icon(
                    imageVector = Icons.Filled.Check,
                    contentDescription = null,
                    modifier = Modifier.size(SwitchDefaults.IconSize),
                )
            }
        } else {
            null
        }
    )
}
Switch.kt

En esta implementación, el aspecto sin marcar es el mismo que el ejemplo de la sección anterior. Sin embargo, cuando se verifica, esta implementación se muestra de la siguiente manera:

Figura 4: Un interruptor con un ícono marcado personalizado

Colores personalizados

En el siguiente ejemplo, se muestra cómo puedes usar el parámetro "colors" para cambiar el color del círculo y el segmento de un interruptor (en función de si el interruptor está marcado).

@Composable
fun SwitchWithCustomColors() {
    var checked by remember { mutableStateOf(true) }

    Switch(
        checked = checked,
        onCheckedChange = {
            checked = it
        },
        colors = SwitchDefaults.colors(
            checkedThumbColor = MaterialTheme.colorScheme.primary,
            checkedTrackColor = MaterialTheme.colorScheme.primaryContainer,
            uncheckedThumbColor = MaterialTheme.colorScheme.secondary,
            uncheckedTrackColor = MaterialTheme.colorScheme.secondaryContainer,
        )
    )
}
Switch.kt

Esta implementación se muestra de la siguiente manera:

Figura 5: Un interruptor con colores personalizados

Recursos adicionales

• Documentos de Material UI