React 组件

UGLabel 标签

为表单控件提供可点击、可访问的名称，并统一必填、禁用和尺寸语义。

导入方式

按需从包入口导入组件，并在应用入口引入一次样式文件。

tsx

import { UGLabel } from '@ug666/ui-react'

使用 htmlFor 对应控件 id；required 只负责展示标记，实际约束仍由控件 required 决定。

用户名

邮箱地址

标签和控件需要同行时，由表单布局决定列宽；UGLabel 仍只负责名称与控件关联。

项目名称

长中文、英文标识和必填标记会自然换行；标签本身不会撑破表单列。

跨区域同步策略与 workspace_member_invitation

标签与对应控件使用同一尺寸体系，可由组件或 ConfigProvider 统一控制。

default

禁用可由组件显式设置或从 ConfigProvider 继承，不依赖标签与控件在 DOM 中的相对顺序。

项目编号

属性	类型	默认值	说明
htmlFor	string	—	关联真实表单控件 id；点击标签会把焦点交给控件。
required	boolean	false	显示不参与读屏重复播报的必填标记。
disabled	boolean	ConfigProvider / false	使用明确的禁用视觉与 aria-disabled 语义，并继承全局禁用配置。
size	'sm' \| 'default' \| 'lg'	ConfigProvider / default	控制标签字号，并继承全局尺寸配置。
children	ReactNode	必填	标签文本或自定义内容。
原生属性 / ref	LabelHTMLAttributes / Ref<HTMLLabelElement>	—	透传其余原生 label 属性和元素引用。