Skip to content

Input 输入框

基础表单输入组件。

示例

可访问性

label 会通过 htmlFor 与输入框关联。传入 helperText 时,组件会自动通过 aria-describedby 将说明文本关联到输入框;传入 error 时,输入框会自动设置 aria-invalid="true",并将错误信息作为可访问描述。

如果你同时传入自定义 aria-describedby,组件会保留已有描述并追加内部 helper/error 描述,避免覆盖业务侧已有的说明关系。

API

属性说明类型默认值
value输入值string-
defaultValue默认值string-
onValueChange值变化回调(value: string) => void-
label标签ReactNode-
helperText帮助说明,会自动关联到输入框描述ReactNode-
error错误说明,会自动设置错误状态并关联到输入框描述ReactNode-
placeholder占位文本string-
prefix前缀ReactNode-
suffix后缀ReactNode-
size尺寸'sm' | 'md' | 'lg''md'
disabled禁用booleanfalse