Input 输入框

大约 3 分钟

Input 输入框

何时使用

  • 需要用户输入表单域内容时。
  • 提供组合型输入框,带搜索的输入框,还可以进行大小选择。

代码演示

基本用法
基本用法。









适应文本高度的文本域
属性适用于 textarea 节点,并且只有高度会自动变化。另外 autoSize 可以设定为一个对象,指定最小行数和最大行数。




数字输入框
数字输入框基本用法.




搜索框
带有搜索按钮的输入框。



输入框组合
输入框的组合展现。 注意:使用 compact 模式时,不需要通过 Col 来控制宽度。










密码框
密码框


API

Input

参数说明类型默认值版本
pressLine
新增
组件右上角文本string
type
新增
扩展Input交互类型default|search-cleardefault
addonAfter带标签的 input,设置后置标签string|slot
addonBefore带标签的 input,设置前置标签string|slot
allowClear可以点击清除图标删除内容boolean
bordered是否有边框booleantrue3.0
defaultValue输入框默认内容string
disabled是否禁用状态,默认为 falsebooleanfalse
id输入框的 idstring
maxlength最大长度number1.5.0
prefix带有前缀图标的 inputstring|slot
showCount是否展示字数booleanfalse3.0
size控件大小。注:标准表单内的输入框大小限制为 large。可选 large default smallstringdefault
suffix带有后缀图标的 inputstring|slot
type声明 input 类型,同原生 input 标签的 type 属性,见:MDNopen in new window(请直接使用 <a-textarea /> 代替 type="textarea")。stringtext
value(v-model)输入框内容string

Input 事件

事件名称说明回调参数
change输入框内容变化时的回调function(e)
pressEnter按下回车的回调function(e)
clear
新增
设置allowClear属性后点击清楚按钮触发事件function(e)

如果 InputForm.Item 内,并且 Form.Item 设置了 idoptions 属性,则 value defaultValueid 属性会被自动设置。

TextArea

参数说明类型默认值版本
allowClear可以点击清除图标删除内容boolean1.5.0
autosize自适应内容高度,可设置为 truefalse 或对象:{ minRows: 2, maxRows: 6 }boolean|objectfalse
defaultValue输入框默认内容string
showCount是否展示字数booleanfalse
value(v-model)输入框内容string

TextArea 事件

事件名称说明回调参数
pressEnter按下回车的回调function(e)

Textarea 的其他属性和浏览器自带的 textareaopen in new window 一致。

InputNumber

成员说明类型默认值版本
press-line输入框右上角文本string
addonAfter带标签的 input,设置后置标签slot-3.0
addonBefore带标签的 input,设置前置标签slot-3.0
autofocus自动获取焦点booleanfalse
bordered是否有边框booleantrue3.0
controls是否显示增减按钮booleantrue3.0
decimalSeparator小数点string-
defaultValue初始值number
disabled禁用booleanfalse
formatter指定输入框展示值的格式function(value: number | string, info: { userTyping: boolean, input: string }): string-info: 3.0
keyboard是否启用键盘快捷行为booleantrue3.0
max最大值numberInfinity
min最小值number-Infinity
parser指定从 formatter 里转换回数字的方式,和 formatter 搭配使用function( string): number-
precision数值精度number-
prefix带有前缀图标的 inputslot-3.0
size输入框大小string
step每次改变步数,可以为小数number|string1
stringMode字符值模式,开启后支持高精度小数。同时 change 事件将返回 string 类型booleanfalse3.0
value(v-model)当前值number

InputNumber事件

事件名称说明回调参数版本
change变化回调Function(value: number | string)
pressEnter按下回车的回调function(e)
step点击上下箭头的回调(value: number, info: { offset: number, type: 'up' | 'down' }) => void3.0

InputNumber方法

名称描述
blur()移除焦点
focus()获取焦点
上次编辑于:
贡献者: Xiou.Wang,Noah.Su