Label
对原生 label 的轻量封装,透传所有标准属性,并提供与 peer-disabled 状态一致的文字颜色和 cursor。
@neumorphism-ui/label预览
点击标签会将焦点移到关联的输入控件。
安装
安装: label
npx shadcn@latest add @neumorphism-ui/labelCLI 会依次处理 npm 依赖、base token、utils 和组件源码。
首次使用此 Registry?请先完成 namespace 配置 。
用法
Import
Label import 代码
import { Label } from "@/components/ui/label"Example
Label 用法代码
<div className="grid gap-2"> <Label htmlFor="project-name">项目名称</Label> <Input id="project-name" name="projectName" /> </div>
API 参考
| 组件 | 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
Label | htmlFor | string | — | 要关联的 form control id。 |
Label | children必填 | React.ReactNode | — | 说明 control 用途的文本。 |
Label | className | string | — | 扩展布局和状态样式。 |
无障碍
- 01
htmlFor 必须与目标 control 的 id 完全一致。
- 02
为 RadioGroup 等多个 control 命名时,应使用 fieldset/legend 或 aria-labelledby,而不是单独的 Label。
- 03
必填状态和辅助说明不仅要有视觉标识,还应通过 required、aria-describedby 传达。