Input

Ingresa datos usando el ratón o teclado.

WARNING

Input es un componente controlado, que siempre muestra el valor de enlace con Vue.

Bajo circunstancias normales, el evento input debe ser manejado. Su handler debe actualizar el valor de enlace del componente (o usar v-model). De lo contrario, el valor del input no cambiará.

No admite modificadores v-model.

Uso básico

Deshabilitar

Deshabilite el Input con el atributo disabled.

Limpiable

Marque que el input puede ser limpiable con el atributo clearable.

Formato

Muestre el valor, según la situación, con formatter, y normalmente se usa parser al mismo tiempo.

Contraseña

Puede hacer un input de contraseña conmutable con el atributo show-password.

Input con icono

Añada un icono para indicar el tipo de Input.

Para añadir iconos en el Input, puede utilizar los atributos prefix-icon y suffix-icon. Además, los slots con nombre prefix y suffix también funcionan.

Using attributes
Using slots

Textarea

Redimensionable para introducir múltiples líneas de información de texto. Agregue el atributo type="textarea" para cambiar el input al tipo nativo textarea.

Controle la altura ajustando la propiedad rows.

Textarea de tamaño automático

El ajuste de la propiedad autosize en el tipo de Input textarea hace que la altura se ajuste automáticamente en función del contenido. Se pueden proporcionar opciones en un objeto para autosize y especificar el número mínimo y máximo de líneas que el textarea puede ajustar automáticamente.

Mezclando elementos con input

Añada un elemento antes o después del input, generalmente será una etiqueta o un botón.

Utilice el slot para seleccionar si el elemento se colocara antes (prepend) o después (append) del Input.

Http://
.com
Select
Select

Tamaños

Añada el atributo size para cambiar el tamaño del Input. Además del tamaño predeterminado, hay otras dos opciones: large, small.

Limitar el tamaño

los atributos maxlength y minlength del input, declaran el límite en el número de caracteres que un usuario puede introducir. El "número de caracteres" se mide usando la longitud de la cadena de JavaScript. Establecer la propiedad maxlength para un tipo de texto o textarea del Input puede limitar la longitud del valor de entrada, permite mostrar el conteo de palabras estableciendo show-word-limit a true al mismo tiempo.

0 / 10
0 / 30

API

Atributos

NombreDescripciónTipoPor defecto
typetipo de inputstring native input typestext
model-value / v-modelvalor enlazadostring / number
maxlengthsame as maxlength in native inputstring / number
minlengthigual que minlength en el input nativostring / number
show-word-limitsi se muestra el contador de palabras, solamente funciona cuando type es 'text' o 'textarea'booleanfalse
placeholderplaceholder del Inputstring
clearablesi mostrar el botón limpiar, solo funciona cuando type no es 'textarea'booleanfalse
formatterespecifica el formato del valor presentado en el input.(solo funciona cuando type es 'text')Function
parserespecifica el valor extraído del input formateado.(solo funciona cuando type es 'text')Function
show-passwordsi debe mostrar la posibilidad de conmutación en el input de tipo passwordbooleanfalse
disabledsi esta deshabilitadobooleanfalse
sizetamaño del input, esto funciona cuando type no es 'textarea'enum
prefix-iconcomponente de icono prefijostring / Component
suffix-iconcomponente de icono sufijostring / Component
rowsnúmero de filas, solo funciona cuando type es 'textarea'number2
autosizesi textarea tiene una altura adaptativa, solo funciona cuando type es 'textarea'. Puede aceptar un objeto, por ejemplo, { minRows: 2, maxRows: 6 }boolean / objectfalse
autocompleteigual que autocomplete en el input nativostringoff
namecomo name en el input nativostring
readonlyigual que readonly en el input nativobooleanfalse
maxigual que max en el input nativo
minigual que min en el input nativo
stepigual que step en el input nativo
resizecontrolar la resizabilidadenum
autofocusigual que autofocus en el input nativobooleanfalse
formigual que form en el input nativostring
aria-label a11y 2.7.2igual que aria-label en el input nativostring
tabindexorden de tabulación para el Inputstring / number
validate-eventsi se debe lanzar la validación de formulariobooleantrue
input-styleel estilo del elemento input o elemento textareastring / object{}
label a11y deprecatedsame as aria-label in native inputstring

Eventos

NombreDescripciónTipo
blurse dispara cuando el input pierde el focoFunction
focusse lanza cuando el input se enfocaFunction
changese dispara cuando el input pierde el foco o el usuario presiona Enter, solo si el modelValue ha cambiadoFunction
inputse dispara cuando el valor del input cambiaFunction
clearse dispara cuando el input se borra haciendo clic en el botón de borrarFunction

Slots

NombreDescripción
prefixcontenido como prefijo del input, solo funciona cuando type no es 'textarea'
suffixcontenido como sufijo del input, solo funciona cuando type no es 'textarea'
prependcontenido a añadir antes del input, solo funciona cuando type no es 'textarea'
appendcontenido para añadir después del input solo funciona cuando type no es 'textarea'

Expuesto

NombreDescriciónTipo
blurquita el foco en el inputFunction
clearborra contenido del inputFunction
focuscoloca el foco en el inputFunction
inputElemento HTML inputobject
refElemento HTML, input o textareaobject
resizeTextarearedimensiona textareaFunction
selectselecciona el texto del inputFunction
textareaElemento HTML textareaobject
textareaStyleestilo de textareaobject
isComposing 2.8.0is input composingobject

FAQ

Why is the width of the ElInput component expanded by clearable?

Typical issue: #7287

PS: Since the ElInput component does not have a default width, when the clearable icon is displayed, the width of the component will be expanded, which can be solved by setting width.

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

Fuente

ComponentesStyleDocumentación

Contribuidores