mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-21 04:48:02 +08:00
3.0 KiB
3.0 KiB
category | subtitle | type | title |
---|---|---|---|
Components | 输入框 | 数据录入 | Input |
通过鼠标或键盘输入内容,是最基础的表单域的包装。
何时使用
- 需要用户输入表单域内容时。
- 提供组合型输入框,带搜索的输入框,还可以进行大小选择。
API
Input
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
addonAfter | 带标签的 input,设置后置标签 | string|ReactNode | |
addonBefore | 带标签的 input,设置前置标签 | string|ReactNode | |
defaultValue | 输入框默认内容 | string | |
disabled | 是否禁用状态,默认为 false | boolean | false |
id | 输入框的 id | string | |
prefix | 带有前缀图标的 input | string|ReactNode | |
size | 控件大小。注:标准表单内的输入框大小限制为 large 。可选 large default small |
string | default |
suffix | 带有后缀图标的 input | string|ReactNode | |
type | 声明 input 类型,同原生 input 标签的 type 属性,见:MDN(请直接使用 Input.TextArea 代替 type="textarea" )。 |
string | text |
value | 输入框内容 | string | |
onChange | 输入框内容变化时的回调 | function(e) | |
onPressEnter | 按下回车的回调 | function(e) | |
allowClear | 可以点击清除图标删除内容 | boolean |
如果
Input
在Form.Item
内,并且Form.Item
设置了id
和options
属性,则value
defaultValue
和id
属性会被自动设置。
Input 的其他属性和 React 自带的 input 一致。
Input.TextArea
2.12
后新增的组件,旧版请使用Input[type=textarea]
。
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
autosize | 自适应内容高度,可设置为 `true | false 或对象: { minRows: 2, maxRows: 6 }` |
boolean|object |
defaultValue | 输入框默认内容 | string | |
value | 输入框内容 | string | |
onPressEnter | 按下回车的回调 | function(e) |
Input.TextArea
的其他属性和浏览器自带的 textarea 一致。
Input.Search
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
enterButton | 是否有确认按钮,可设为按钮文字 | boolean|ReactNode | false |
onSearch | 点击搜索或按下回车键时的回调 | function(value, event) |
其余属性和 Input 一致。
Input.Group
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
compact | 是否用紧凑模式 | boolean | false |
size | Input.Group 中所有的 Input 的大小,可选 large default small |
string | default |
<Input.Group>
<Input />
<Input />
</Input.Group>
Input.Password (3.12.0 中新增)
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
visibilityToggle | 是否显示切换按钮 | boolean | true |