数据录入与表单组合组件有已知边界

NnFormItem 表单项

标签、控件、帮助和状态布局。

示例

API

Props

名称	类型	默认值	说明
label	string | number	''	标签内容。
name	string | number | unknown[]	—	当前仅作为公开占位属性，不参与取值或校验。
help	string | number | array | object	''	控件下方的状态帮助内容。
extra	string | number | array | object	''	帮助内容之后的补充说明。
validateStatus	string	''	error、warning、success 会设置对应状态样式；其他非空值只设置反馈类。
required	boolean	false	只显示必填视觉标记，不执行校验。
labelCol	FormColumn	—	覆盖表单级标签列配置。结构见 NnForm。
wrapperCol	FormColumn	—	覆盖表单级控件列配置。结构见 NnForm。
colon	boolean	—	覆盖表单级冒号设置；纵向布局始终不显示冒号。
htmlFor	string	—	标签原生 for 属性。
labelAlign	string	'right'	left 使用左对齐类，其他值使用默认对齐。

Slots

名称	作用域参数	说明
label	—	替换标签。
default	—	表单控件。
help	—	替换 help。
extra	—	替换 extra。

当前限制

name、required 和 validateStatus 不会注册字段或运行校验；它们目前分别作为元数据占位和视觉状态使用。