输入

使用鼠标或键盘输入数据。

基本用法

禁用

使用 disabled 属性禁用输入。

可清除

使用 clearable 属性使输入可清除。在版本2.13.4之后,可清除功能也可用于文本区域类型的输入。

自定义清除图标 2.11.0

您可以通过设置 clear-icon 属性来自定义透明图标。

格式化程序

formatter的情况下显示数值,我们通常同时使用parser

密码框

使用 show-password 属性创建可切换的密码输入。从2.13.6开始,支持password-icon插槽覆盖默认图标。

带图标输入

添加一个图标来指示输入类型。

要在输入中添加图标,您可以简单地使用 prefix-iconsuffix-icon 属性。此外,prefixsuffix 命名插槽也可以工作。

Using attributes
Using slots

文本区域

可调整大小以输入多行文本信息。添加属性type="textarea",将input更改为原生textarea

通过设置 rows 属性来控制高度。

自动调整文本区域大小

为输入的文本区域类型设置 autosize 属性可以使高度根据内容自动调整。可以向 autosize 提供选项对​​象,以指定文本区域可以自动调整的最小和最大行数。

混合输入

前置或附加一个元素,通常是标签或按钮。

使用 slot 分发前置或附加到 Input 的元素。

Http://
.com
Select
Select

尺寸

添加 size 属性以更改输入的大小。除了默认尺寸外,还有另外两个选项:largesmall

限制长度

maxlengthminlength input 属性,它们声明用户可以输入的字符数限制。 “字符数”是使用 JavaScript 字符串长度来测量的。为输入的文本或文本区域类型设置 maxlength 属性可以限制输入值的长度,允许您同时通过将 show-word-limit 设置为 true 来显示字数。在2.11.5中,您可以将word-limit-position设置为outside以显示输入之外的字数统计。

0 / 10
0 / 10
0 / 30
0 / 30

计算字素 2.13.7

设置 count-graphemes 来计算文本长度。如果设置了,则不会使用原生 maxlengthminlength

2 / 10
2 / 20

TIP

浏览器支持和后备策略

当使用 count-graphemes 属性时,该组件采用以下方法:

  • 主要:使用 Intl.Segmenter API(Chrome 87+、Firefox 125+、Safari 14.1+)进行正确的字素簇处理。这可以正确处理复杂的表情符号、组合标记和零宽度连接序列。

  • 回退:较旧的浏览器回退到 Array.from() 以进行基于代码点的迭代。请注意,这可能会分割多代码点字素序列(例如,带有肤色修饰符的表情符号)。

在实现您自己的 count-graphemes 函数时,如果您需要对复杂 unicode 字符的强大支持,请考虑使用 Intl.Segmenter

API

属性

名称描述类型默认
类型输入类型,请参阅MDN字符串文字
模型值 / v 模型绑定值字符串 / 数字
模型修饰符 2.11.5v-model 修饰符,参考Vue 修饰符对象
最大长度与本机输入中的 maxlength 相同字符串 / 数字
最小长度与本机输入中的 minlength 相同字符串 / 数字
显示字数限制是否显示字数,仅当 type 为 'text' 或 'textarea' 时有效布尔值
字数限制位置 2.11.5字数位置,show-word-limit 为 true 时有效枚举“里面”
占位符输入的占位符字符串
可清除是否显示清除按钮,仅当 type 不是 'textarea' 时有效布尔值
清除图标 2.11.0自定义透明图标组件字符串 / 对象圆圈关闭
格式化程序指定输入值的格式。(仅当 type 为“文本”时有效)功能
解析器指定从格式化程序输入中提取的值。(仅当 type 为“文本”时有效)功能
显示密码是否显示可切换的密码输入布尔值
已禁用输入是否被禁用布尔值
尺寸输入的大小,当 type 不是 'textarea' 时有效枚举
前缀图标前缀图标组件字符串 / 组件
后缀图标后缀图标组件字符串 / 组件
textarea 的行数,仅当 type 为 'textarea' 时有效数字2
自动调整大小textarea是否具有自适应高度,仅当type为'textarea'时有效。可以接受一个对象,例如{ minRows: 2, maxRows: 6 }布尔值 / 对象
自动完成与本机输入中的 autocomplete 相同字符串关闭
名称与本机输入中的 name 相同字符串
只读与本机输入中的 readonly 相同布尔值
最大与本机输入中的 max 相同
分钟与本机输入中的 min 相同
步骤与本机输入中的 step 相同
调整大小控制大小调整枚举
自动对焦与本机输入中的 autofocus 相同布尔值
表格与本机输入中的 form 相同string
咏叹调标签 a11y 2.7.2与本机输入中的 aria-label 相同字符串
标签索引输入选项卡索引字符串 / 数字
验证事件是否触发表单验证布尔值真实
输入式输入元素或文本区域元素的样式字符串 / 对象{}
标签 a11y 已弃用与本机输入中的 aria-label 相同字符串
输入模式 2.10.3与本机输入中的 inputmode 相同字符串
计数字素 2.13.7自定义函数来计算字素;设置后,本机 maxlength/minlength 约束将被绕过。组件使用 Intl.Segmenter(Chrome 87+、Firefox 125+、Safari 14.1+)进行正确的字素聚类;旧版浏览器回退到 Array.from() 进行代码点迭代功能

活动

名称描述类型
模糊当输入模糊时触发功能
焦点当输入聚焦时触发功能
改变仅当 modelValue 发生变化时,输入框失去焦点或用户按 Enter 时触发功能
输入当输入值改变时触发功能
清除单击清除按钮清除输入时触发功能
按键按下某个键时触发功能
鼠标离开当鼠标离开输入元素时触发功能
鼠标输入当鼠标进入输入元素时触发功能
作文开始合成开始时触发功能
成分更新更新构图时触发功能
作文结束组合结束时触发功能

老虎机

名称描述
前缀content 作为输入前缀,仅当 type 不是 'textarea' 时才有效
后缀内容作为输入后缀,仅在 type 不是 'textarea' 时有效
前置在输入之前添加的内容,仅在 type 不是 'textarea' 时有效
附加输入后附加的内容,仅当 type 不是 'textarea' 时才有效
密码图标 2.13.6内容为输入密码图标,仅在 show-password 为 true 时有效。范围变量是 { visible: boolean }

暴露

名称描述类型
模糊模糊输入元素功能
清除清除输入值功能
焦点聚焦输入元素功能
输入HTML 输入元素对象
参考HTML 元素、输入或文本区域对象
调整文本区域大小调整文本区域大小功能
选择选择输入元素中的文本功能
文本区域HTML 文本区域元素对象
文本区域样式文本区域的样式对象
正在撰写 2.8.0是输入作曲对象
密码可见 2.13.7密码是否可见对象

常见问题解答

####为什么ElInput组件的宽度要通过clearable来扩展?

典型问题:#7287

PS:由于ElInput组件没有默认宽度,当显示可清除图标时,组件的宽度会扩大,可以通过设置宽度来解决。

vue
<el-input v-model="input" clearable style="width: 200px" />