Перейти к основному содержимому

Переключатель

Переключение между двумя взаимоисключающими состояниями; рендерит пользовательский элемент управления role="switch".

Базовое использование​

Контролируемый переключатель
Выкл

Текущее состояние: Выкл

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="Вкл"
inactiveText="Выкл"
onChange={(val) => setActive(val)}
/>
<LhSwitch disabled />
<LhSwitch loading />
</>
)
}

Switch Props​

СвойствоОписаниеТипВариантыПо умолчанию
checkedКонтролируемое состояние переключателяboolean——
defaultCheckedНеконтролируемое состояние по умолчаниюboolean—false
disabledОтключитьboolean—false
loadingСостояние загрузкиboolean—false
activeTextТекст во включённом состоянииstring—switch.on из языкового пакета
inactiveTextТекст в выключенном состоянииstring—switch.off из языкового пакета
sizeРазмер'large' | 'middle' | 'small'—Следует за ConfigProvider
themeVarsПеременные темы на уровне компонентаRecord<string, string>——
sxСокращённые props макетаSxProps——

События Switch​

СобытиеОписаниеСигнатура коллбэкаАналог в Vue
onChangeИзменение состояния (два аргумента)(checked: boolean, event: MouseEvent | KeyboardEvent) => void@change
Взаимодействие с клавиатурой

Переключатель реагирует на Enter / Space, как и нативный checkbox; aria-checked синхронизирован с текущим состоянием.

Стили​

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