输入 ​

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

基本用法 ​

禁用 ​

使用 disabled 属性禁用输入。

可清除 ​

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

自定义清除图标 2.11.0 ​

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

格式化程序 ​

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

密码框 ​

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

带图标输入 ​

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

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

Using attributes
Using slots

文本区域 ​

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

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

自动调整文本区域大小 ​

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

混合输入 ​

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

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

Http://
.com
Select
Select

尺寸 ​

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

限制长度 ​

maxlength 和 minlength 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 来计算文本长度。如果设置了,则不会使用原生 maxlength 和 minlength。

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" />