Saltar al contenido principal
Versión: Siguiente

Interruptor

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Renderiza una entrada booleana.

Este es un componente controlado que requiere un callback onValueChange que actualice la prop value para que el componente refleje las acciones del usuario. Si la prop value no se actualiza, el componente seguirá mostrando el valor proporcionado en value en lugar del resultado esperado de las interacciones.

Ejemplo


Referencia

Props

Props de View

Hereda Props de View.


disabled

Si es true, el usuario no podrá cambiar el estado del interruptor.

TypeDefault
boolfalse

ios_backgroundColor
iOS

En iOS, color personalizado para el fondo. Este color de fondo es visible cuando el valor del interruptor es false o cuando está deshabilitado (y el interruptor es translúcido).

Type
color

onChange

Se invoca cuando el usuario intenta cambiar el valor del interruptor. Recibe el evento de cambio como argumento. Si solo necesitas el nuevo valor, usa onValueChange en su lugar.

Type
function

onValueChange

Se invoca cuando el usuario intenta cambiar el valor del interruptor. Recibe el nuevo valor como argumento. Si prefieres recibir un evento, usa onChange.

Type
function

ref

Un asignador de referencia al que se le asignará un nodo de elemento cuando se monte.


thumbColor

Color del agarre del interruptor (parte frontal). Si se configura en iOS, el agarre perderá su sombra paralela.

Type
color

trackColor

Colores personalizados para la pista del interruptor.

iOS: Cuando el valor es false, la pista se contrae hacia el borde. Para cambiar el color del fondo expuesto por la pista contraída, usa ios_backgroundColor.

Type
object: {false: color, true: color}

value

Valor del interruptor. Si es true, el interruptor estará activado. El valor predeterminado es false.

Type
bool