Input 单行输入

组合与状态归属

Input 是一个原生 input。Label 与 id/htmlFor 关联可见标签；Form 或应用管理提交、校验和错误文本。ref 指向 HTMLInputElement，即使存在 prefix / suffix 也不指向外层壳。

prefix / suffix 接受 ReactNode；至少一个不是 undefined 时渲染前后缀壳，null 仍会创建对应槽位。外观 className 在有壳时落在壳上，原生属性与 style 仍传给 input。交互后缀由应用管理事件、可访问名称和 disabled 状态，不会自动继承输入框禁用状态。

值、事件与表单

受控文本使用 value 并在 onChange 中同步更新状态；刻意只读时声明 readOnly。非受控文本使用 defaultValue，由浏览器管理后续输入。不要混用 value 与 defaultValue，也不要在同一个实例生命周期内切换受控模式。

onChange 接收 React 原生 ChangeEvent<HTMLInputElement>，从 event.currentTarget.value 读取字符串。type="number" 的输入事件也不是自动转换后的 number；需要数字时由应用解析。没有 onValueChange 或自动格式化回调。组件不拦截组合输入、不更改选区，外部 value 更新不会合成一次用户输入事件。

带 name 的非禁用输入参与 FormData；readOnly 文本仍可提交，disabled 输入不参与且不能聚焦编辑。原生表单 reset 恢复非受控 defaultValue；受控值需要应用在 onReset 中恢复自己的状态。invalid 只设置错误语义，不阻止提交、不生成错误文本，也不替代 required、type、min 等原生校验。

文件选择

type="file" 的值由浏览器管理，禁止 value 和 defaultValue。onChange 从 event.currentTarget.files 读取 FileList；accept 仅提示选择器允许的类型，multiple 允许多选，不执行上传或安全校验。服务端仍需验证实际文件内容。

清空文件选择使用原生表单 reset，并同步清空应用展示的文件名。不要以受控文本值模拟文件路径。文件示例只显示所选名称，不读取文件内容、不发送网络请求。

Input

基础输入。ref 指向原生 input。

(props: InputProps & React.RefAttributes<HTMLInputElement>) => React.ReactNode

其余 289 个 React 原生属性按继承汇总；关键原生属性已展开。

InputFileType

文件选择与文本类型分开。

"file"

InputProps

在无样式输入上增加视觉档与前/后衬槽。 size 不再表示原生字符宽度；prefix 收编原生 RDFa 同名属性，交给衬槽。 条件类型逐成员 Omit，保持受控/非受控/文件联合的判别结构。

(Omit<InputControlledProps, "prefix"> | Omit<InputUncontrolledProps, "prefix"> | Omit<InputFileProps, "prefix">) & { size?: InputSize; prefix?: ReactNode; suffix?: ReactNode; }

其余 288 个 React 原生属性按继承汇总；关键原生属性已展开。

InputSize

六档视觉尺寸。默认档来自 ConfigProvider，无配置时为 md。

"xs" | "sm" | "md" | "lg" | "xl" | "2xl"

InputTextType

首轮公开的文本类型。

"number" | "search" | "text" | "tel" | "url" | "email" | "date" | "time" | "password"

InputType

组件公开的 type 并集。

"file" | InputTextType

InputVariantOptions

inputVariants 接受的尺寸和附加类。

InputVariantOptions

其余 0 个 React 原生属性按继承汇总；关键原生属性已展开。