Switch

胶囊轨道和圆形滑块,在 180ms 内移动。

查看源码
import { Switch } from "@logicplanes/kaeso-ui";

属性

  • aria-label
    string

    无障碍名称,用于没有可见标签的情况。

  • aria-labelledby
    string

    为其命名的元素的 ID,用于标签位于页面其他位置的情况。

  • checked
    boolean

    受控时,是否处于选中状态。

  • defaultChecked
    boolean

    非受控时,是否初始为选中状态。

  • description
    ReactNode

    标签下方的一句帮助文字。

  • disabled
    boolean

    将其禁用:无法使用,并显示为变暗。

  • disabledReason
    string

    禁用原因,以提示框显示;按钮保持可聚焦,便于阅读原因。

  • id
    string

    控件的 ID,便于其他位置的标签指向它。

  • label
    ReactNode

    开关的标签。

  • loading
    boolean

    显示更改正在保存,并在保存完成前忽略点击。

  • name
    string

    在表单中提交值时使用的字段名。

  • onCheckedChange
    ((checked: boolean) => void)

    选中或取消选中时调用,并传入新状态。

  • readOnly
    boolean

    显示值,但不允许修改。

  • size
    "md" | "sm" | "lg" = md

    开关的尺寸。