Saltar al contenido principal

Interruptor

Alterna entre dos estados mutuamente excluyentes; renderiza un control personalizado con role="switch".

Uso básico​

Interruptor controlado
Desactivado

Estado actual: Desactivado

import { useState } from 'react'
import { LhSwitch } from '@lh-ui/react'

export default function Demo() {
const [active, setActive] = useState(false)

return (
<>
<LhSwitch checked={active} onChange={(val) => setActive(val)} />
<LhSwitch
checked={active}
activeText="Activado"
inactiveText="Desactivado"
onChange={(val) => setActive(val)}
/>
<LhSwitch disabled />
<LhSwitch loading />
</>
)
}

Props de Switch​

PropDescripciónTipoOpcionesPredeterminado
checkedEstado controlado del interruptorboolean——
defaultCheckedEstado predeterminado no controladoboolean—false
disabledDesactivadoboolean—false
loadingCargandoboolean—false
activeTextTexto cuando está activadostring—Paquete de idioma switch.on
inactiveTextTexto cuando está desactivadostring—Paquete de idioma switch.off
sizeTamaño'large' | 'middle' | 'small'—Según ConfigProvider
themeVarsVariables de tema a nivel de componenteRecord<string, string>——
sxPropiedad abreviada de diseñoSxProps——

Eventos de Switch​

EventoDescripciónFirma del callbackEquivalente en Vue
onChangeCambio de estado (dos parámetros)(checked: boolean, event: MouseEvent | KeyboardEvent) => void@change
Interacción de teclado

El interruptor responde a Enter / Space para conmutar, igual que un checkbox nativo; aria-checked se sincroniza con el estado actual.

Estilos​

import '@lh-ui/react/style/switch'