Button

触发一个操作。每个按钮都是胶囊形;每个视图中只有一个是墨色主按钮。

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

属性

  • children
    ReactNode

    按钮的标签:动词开头,句首大写。

  • count
    number

    标签后的计数。

  • disabledReason
    string

    按钮被禁用的原因,以提示框显示。按钮仍可获得焦点,方便用户阅读原因。

  • fullWidth
    boolean

    填满容器的宽度。

  • href
    string

    渲染为外观与按钮相同的链接。

  • icon
    IconSvgElement

    图标按钮的唯一内容;请为其设置 aria-label。

  • leadingIcon
    IconSvgElement

    文字前的图标。

  • loading
    boolean

    操作进行中:按钮立即进入忙碌状态并忽略点击;操作超过 300ms 才显示加载指示,之后至少显示 400ms(useDelayedLoading)。它会替换前置图标或覆盖标签;宽度始终不变。

  • rel
    string

    链接关系,与 a 元素相同。

  • reserveLabels
    ReactNode[]

    此按钮可能显示的所有标签(“复制密钥”“已复制”)。按钮保持最宽标签的宽度,状态变化时尺寸绝不改变。

  • shape
    "pill" | "circle"

    仅含图标的按钮为圆形,需要无障碍名称。

  • shortcut
    string[] | string[][]

    标签后的快捷键提示(lg 和 xl 尺寸,以及菜单中)。

  • size
    "md" | "xs" | "sm" | "lg" | "xl"

    高度,从 xs(24px)到 xl(44px)。

  • target
    string

    链接打开的位置,与 a 元素相同。

  • trailingIcon
    IconSvgElement

    文字后的图标。

  • variant
    "danger" | "link" | "secondary" | "primary" | "ghost" | "quiet" | "soft" | "danger-secondary"

    primary 用于视图中唯一的主要操作,secondary 用于其他操作,ghost 和 quiet 用于工具栏,danger 用于破坏性操作。