通过鼠标或键盘输入内容,是最基础的表单域的包装。
何时使用
- 需要用户输入表单域内容时。
 
- 提供组合型输入框,带搜索的输入框,还可以进行大小选择。
 
API
Input
| 参数 | 
说明 | 
类型 | 
默认值 | 
版本 | 
| addonAfter | 
带标签的 input,设置后置标签 | 
string|slot | 
 | 
 | 
| addonBefore | 
带标签的 input,设置前置标签 | 
string|slot | 
 | 
 | 
| bordered | 
是否有边框 | 
boolean | 
true | 
3.0 | 
| defaultValue | 
输入框默认内容 | 
string | 
 | 
 | 
| disabled | 
是否禁用状态,默认为 false | 
boolean | 
false | 
 | 
| id | 
输入框的 id | 
string | 
 | 
 | 
| maxlength | 
最大长度 | 
number | 
 | 
1.5.0 | 
| prefix | 
带有前缀图标的 input | 
string|slot | 
 | 
 | 
| size | 
控件大小。注:标准表单内的输入框大小限制为 large。可选 large default small | 
string | 
default | 
 | 
| suffix | 
带有后缀图标的 input | 
string|slot | 
 | 
 | 
| type | 
声明 input 类型,同原生 input 标签的 type 属性,见:MDN(请直接使用 <a-textarea /> 代替 type="textarea")。 | 
string | 
text | 
 | 
| value(v-model) | 
输入框内容 | 
string | 
 | 
 | 
| allowClear | 
可以点击清除图标删除内容 | 
boolean | 
 | 
 | 
Input 事件
| 事件名称 | 
说明 | 
回调参数 | 
 | 
| change | 
输入框内容变化时的回调 | 
function(e) | 
 | 
| pressEnter | 
按下回车的回调 | 
function(e) | 
 | 
如果 Input 在 Form.Item 内,并且 Form.Item 设置了 id 和 options 属性,则 value defaultValue 和 id 属性会被自动设置。
TextArea
| 参数 | 
说明 | 
类型 | 
默认值 | 
版本 | 
 | 
| autosize | 
自适应内容高度,可设置为 `true | 
false 或对象:{ minRows: 2, maxRows: 6 }` | 
boolean|object | 
false | 
 | 
| defaultValue | 
输入框默认内容 | 
string | 
 | 
 | 
 | 
| value(v-model) | 
输入框内容 | 
string | 
 | 
 | 
 | 
| allowClear | 
可以点击清除图标删除内容 | 
boolean | 
 | 
1.5.0 | 
 | 
| showCount | 
是否展示字数 | 
boolean | 
false | 
 | 
 | 
TextArea 事件
| 事件名称 | 
说明 | 
回调参数 | 
| pressEnter | 
按下回车的回调 | 
function(e) | 
Textarea 的其他属性和浏览器自带的 textarea 一致。
Input.Search
| 参数 | 
说明 | 
类型 | 
默认值 | 
版本 | 
| enterButton | 
是否有确认按钮,可设为按钮文字。该属性会与 addon 冲突。 | 
boolean|slot | 
false | 
 | 
| loading | 
搜索 loading | 
boolean | 
 | 
1.5.0 | 
Input.Search 事件
| 事件名称 | 
说明 | 
回调参数 | 
| search | 
点击搜索或按下回车键时的回调 | 
function(value, event) | 
其余属性和 Input 一致。
Input.Group
| 参数 | 
说明 | 
类型 | 
默认值 | 
| compact | 
是否用紧凑模式 | 
boolean | 
false | 
| size | 
Input.Group 中所有的 Input 的大小,可选 large default small | 
string | 
default | 
<a-input-group>
  <a-input />
  <a-input />
</a-input-group>
Input.Password (1.14.0 中新增)
| 参数 | 
说明 | 
类型 | 
默认值 | 
| visibilityToggle | 
是否显示切换按钮 | 
boolean | 
true |