API
Input
参数 |
说明 |
类型 |
默认值 |
addonAfter |
带标签的 input,设置后置标签 |
string|slot |
|
addonBefore |
带标签的 input,设置前置标签 |
string|slot |
|
defaultValue |
输入框默认内容 |
string |
|
disabled |
是否禁用状态,默认为 false |
boolean |
false |
id |
输入框的 id |
string |
|
prefix |
带有前缀图标的 input |
string|slot |
|
size |
控件大小。注:标准表单内的输入框大小限制为 large 。可选 large default small |
string |
default |
suffix |
带有后缀图标的 input |
string|slot |
|
type |
声明 input 类型,同原生 input 标签的 type 属性,见:MDN(请直接使用 Input.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
属性会被自动设置。
Input.TextArea
参数 |
说明 |
类型 |
默认值 |
autosize |
自适应内容高度,可设置为 `true |
false 或对象: { minRows: 2, maxRows: 6 }` |
boolean|object |
defaultValue |
输入框默认内容 |
string |
|
value(v-model) |
输入框内容 |
string |
|
Input.TextArea事件
事件名称 |
说明 |
回调参数 |
pressEnter |
按下回车的回调 |
function(e) |
Input.TextArea
的其他属性和浏览器自带的 textarea 一致。
Input.Search
参数 |
说明 |
类型 |
默认值 |
enterButton |
是否有确认按钮,可设为按钮文字。该属性会与 addon 冲突。 |
boolean|slot |
false |
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
参数 |
说明 |
类型 |
默认值 |
visibilityToggle |
是否显示切换按钮 |
boolean |
true |
FAQ
为什么我动态改变 prefix/suffix
时,Input 会失去焦点?
当 Input 动态添加或者删除 prefix/suffix
时,Vue 会重新创建 DOM 结构而新的 input 是没有焦点的。
你可以预设一个空的 <span />
来保持 DOM 结构不变:
const suffix = condition ? <Icon type="smile" /> : <span />;
<Input suffix={suffix} />