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.
  • Habilitar o inhabilitar una función
  • Selecciona una opción.

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

Ejemplos del componente Switch en los modos claro y oscuro
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 podrías necesitar usar:

  • checked: Es el estado inicial del interruptor.
  • onCheckedChange: Es una devolución de llamada que se activa cuando cambia el estado del interruptor.
  • enabled: Indica si el interruptor está habilitado o inhabilitado.
  • colors: Son los colores que se usan para el interruptor.

En el siguiente ejemplo, se muestra una implementación mínima del elemento de componibilidad Switch.

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

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

Esta implementación aparece de la siguiente manera cuando no está marcada:

Un interruptor básico que no está marcado.
Figura 2: Un interruptor sin marcar.

Así se ve cuando está marcada:

Un Switch básico que está marcado.
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: Úsalo para personalizar el aspecto del pulgar cuando está marcado.
  • colors: Úsala para personalizar el color de la pista y el control deslizante.

Miniatura personalizada

Puedes pasar cualquier elemento componible para el parámetro thumbContent y crear un control deslizante personalizado. A continuación, se muestra un ejemplo de un interruptor que usa un ícono personalizado para su control deslizante:

@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
        }
    )
}

En esta implementación, la apariencia sin marcar es la misma que en el ejemplo de la sección anterior. Sin embargo, cuando se verifica, esta implementación aparece de la siguiente manera:

Un interruptor que usa el parámetro thumbContent para mostrar un ícono personalizado cuando se marca.
Figura 4: Un interruptor con un ícono de marcado personalizado

Colores personalizados

En el siguiente ejemplo, se muestra cómo puedes usar el parámetro colors para cambiar el color del control deslizante y de la pista de un interruptor, teniendo en cuenta 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,
        )
    )
}

Esta implementación se ve de la siguiente manera:

Un interruptor que usa el parámetro colors para mostrar un interruptor con colores personalizados para el control deslizante y la pista.
Figura 5: Un interruptor con colores personalizados.

Recursos adicionales