操作与浮层@neumorphism-ui/button

Button

使用原生 button,保留表单与键盘行为。提供五种 variant 和四种 size,active 状态通过 inset shadow 表现按下效果。

@neumorphism-ui/button
Registry JSON

预览

安装

安装: buttonnpx shadcn@latest add @neumorphism-ui/button

CLI 会依次处理 npm 依赖、base token、utils 和组件源码。

首次使用此 Registry?请先完成 namespace 配置 。

用法

Import

Button import 代码
import { Button } from "@/components/ui/button"

Example

Button 用法代码
<div className="flex gap-3">
  <Button variant="primary">保存更改</Button>
  <Button variant="soft">取消</Button>
  <Button variant="ghost">稍后处理</Button>
  <Button size="icon" aria-label="添加项目">+</Button>
</div>

API 参考

组件属性类型默认值说明
Buttonvariant"default" | "primary" | "soft" | "ghost" | "destructive""default"选择按钮的语义和表面强调方式。
Buttonsize"sm" | "default" | "lg" | "icon""default"选择按钮高度和水平内边距。
Buttontype"button" | "submit" | "reset""button"决定原生按钮的行为。
Buttondisabledbooleanfalse禁用点击和键盘操作。

无障碍

  • 01

    由于使用原生 button,会保留 Space、Enter 键行为以及 disabled 语义。

  • 02

    icon 尺寸的按钮必须提供描述操作的 aria-label。

  • 03

    页面跳转应使用语义正确的 anchor 或 Link,不要用 Button 的点击处理器代替。