按钮

与 BoardUI 设计系统相匹配的按钮 - 三种尺寸的主要、次要、幽灵和危险变体,具有前导/尾随图标槽、仅图标模式以及语义悬停、按下和禁用状态。

安装

您可以使用我们的 CLI 或手动添加此按钮组件:

已支持深色模式,此 组件 会自动使用 BoardUI 的语义设计变量。 设置主题切换.

CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。

npx boardui@latest add button

使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。

变体

四种变体通过 variant 属性。主要和危险使用垂直渐变,次要是有边框的表面,幽灵使用微妙的蓝色动作表面。

<Button variant="primary">Primary</Button> {/* blue gradient (default) */}<Button variant="secondary">Secondary</Button> {/* white surface + hairline border */}<Button variant="ghost">Ghost</Button> {/* blue-100 semantic surface */}<Button variant="danger">Danger</Button> {/* red gradient */}

尺寸

三种尺寸 - 中号(36 像素,默认)、小号(32 像素)和 xs(24 像素)。仅图标按钮在每种尺寸下都会变成方形。

<Button size="medium">Medium</Button> {/* 36px (default) */}<Button size="small">Small</Button> {/* 32px */}<Button size="xs">Xs</Button> {/* 24px */}

图标

将任何 Remix Icon 组件引用传递给 leadingIcon / trailingIcon。结合 iconOnly 与一个 aria-label 用于方形图标按钮。

import { RiAddLine, RiArrowRightLine } from "@remixicon/react"; {/* Pass component references, not rendered elements */}<Button leadingIcon={RiAddLine}>New project</Button><Button trailingIcon={RiArrowRightLine}>Continue</Button> {/* Icon-only requires an aria-label */}<Button iconOnly leadingIcon={RiAddLine} aria-label="Add" />

禁用

原生 disabled 属性将每个变体切换到其静音禁用表面。