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.
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 } ) }
Esta implementación se muestra de la siguiente manera cuando no se marca:
Esta es la apariencia cuando se marca:
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 } ) }
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:
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, ) ) }
Esta implementación se muestra de la siguiente manera: