Field 表单字段

使用 Field 包裹 Input、Textarea 或原生 Select，自动关联标签、说明与错误。需要组合触发器、清空按钮等多个交互元素时启用 compound，不要把它们全部塞进一个 label。

安装复制章节链接

首次使用请先完成 Registry 与主题接入。

状态与组合复制章节链接

<Field label="工作区名称" hint="显示给协作者的名称" error={error}>
  <Input name="workspaceName" required maxLength={60} />
</Field>

Field 显示调用方错误、表单字段错误或本地约束反馈。Input、Textarea、Select 使用相同边界、焦点和禁用语义；ChoiceRow 将原生选择项与说明组合。

Props复制章节链接

键盘与约束复制章节链接

保持原生输入键盘行为。name 是提交和字段错误映射的共同键；复合控件要让可见触发器被正确标记并接收焦点。external 模式下调用方必须渲染相同 errorId 的错误节点。

避免这样使用复制章节链接

占位符不能代替 label；不要把多个互不相关字段包进同一个 Field；不要只标红边框而不说明如何改正。

来源与版本复制章节链接

0.1.0，来自 Subtic apps/web/components/ui/field.tsx 与 form-context.ts。保留语义关联，去除产品平台与翻译依赖。