los HTMLInputElement La interfaz proporciona propiedades y métodos especiales para manipular las opciones, el diseño y la presentación de <input> elementos.

Propiedades

Propiedades relacionadas con el formulario principal
form Solo lectura HTMLFormElement objeto: Devoluciones una referencia al padre <form> elemento.
formAction string: Devoluciones / Conjuntos los elementos formaction atributo, que contiene el URI de un programa que procesa la información enviada por el elemento. Esto anula el action atributo de la forma padre.
formEnctype string: Devoluciones / Conjuntos los elementos formenctype atributo, que contiene el tipo de contenido que se utiliza para enviar el formulario al servidor. Esto anula el enctype atributo de la forma padre.
formMethod string: Devoluciones / Conjuntos los elementos formmethod atributo, que contiene el método HTTP que utiliza el navegador para enviar el formulario. Esto anula el method atributo de la forma padre.
formNoValidate Boolean: Devoluciones / Conjuntos los elementos formnovalidate atributo, que indica que el formulario no se validará cuando se envíe. Esto anula el novalidate atributo de la forma padre.
formTarget string: Devoluciones / Conjuntos los elementos formtarget atributo, que contiene un nombre o palabra clave que indica dónde mostrar la respuesta que se recibe después de enviar el formulario. Esto anula el target atributo de la forma padre.
Propiedades que se aplican a cualquier tipo de elemento de entrada que no esté oculto
name string: Devoluciones / Conjuntos los elementos name atributo, que contiene un nombre que identifica el elemento al enviar el formulario.
type string: Devoluciones / Conjuntos los elementos type atributo, que indica el tipo de control a mostrar. Ver type atributo de <input> para posibles valores.
disabled Boolean: Devoluciones / Conjuntos los elementos disabled atributo, que indica que el control no está disponible para la interacción. Los valores de entrada no se enviarán con el formulario. Ver también readonly
autofocus Boolean: Devoluciones / Conjuntos los elementos autofocus atributo, que especifica que un control de formulario debe tener el foco de entrada cuando se carga la página, a menos que el usuario lo anule, por ejemplo, escribiendo un control diferente. Solo un elemento de formulario en un documento puede tener la autofocus atributo. No se puede aplicar si el type el atributo está establecido en hidden (es decir, no puede establecer automáticamente el enfoque en un control oculto).
required Boolean: Devoluciones / Conjuntos los elementos required atributo, que indica que el usuario debe completar un valor antes de enviar un formulario.
value string: Devoluciones / Conjuntos el valor actual del control.

Nota: Si el usuario ingresa un valor diferente al valor esperado, esto puede devolver una cadena vacía.
validity Solo lectura ValidityState object: Devoluciones el estado de validez actual del elemento.
validationMessage Solo lectura string: Devoluciones un mensaje localizado que describe las restricciones de validación que el control no satisface (si las hubiera). Esta es la cadena vacía si el control no es candidato para la validación de restricciones (willvalidate es false), o satisface sus limitaciones. Este valor puede ser establecido por el setCustomValidity método.
willValidate Solo lectura Boolean: Devoluciones si el elemento es candidato para la validación de restricciones. Está false si alguna condición le impide la validación de restricciones, incluyendo: su type es hidden, reset, o button; tiene un <datalist> antepasado; su disabled la propiedad es true.
Propiedades que se aplican solo a elementos de tipo checkbox o radio
checked Boolean: Devoluciones / Conjuntos el estado actual del elemento cuando type es checkbox o radio.
defaultChecked Boolean: Devoluciones / Conjuntos el estado predeterminado de un botón de opción o casilla de verificación como se especificó originalmente en HTML que creó este objeto.
indeterminate Boolean: Devoluciones si la casilla de verificación o el botón de opción están en estado indeterminado. Para las casillas de verificación, el efecto es que la apariencia de la casilla de verificación está oscurecida / atenuada de alguna manera como para indicar que su estado es indeterminado (no marcado pero no desmarcado). No afecta el valor de la checked atributo, y hacer clic en la casilla de verificación establecerá el valor en falso.
Propiedades que se aplican solo a elementos de tipo image
alt string: Devoluciones / Conjuntos los elementos alt atributo, que contiene texto alternativo para usar cuando type es image.
height string: Devoluciones / Conjuntos los elementos height atributo, que define la altura de la imagen mostrada para el botón, si el valor de type es image.
src string: Devoluciones / Conjuntos los elementos src atributo, que especifica un URI para la ubicación de una imagen para mostrar en el botón de envío gráfico, si el valor de type es image; de lo contrario, se ignora.
width string: Devoluciones / Conjuntos los elementos width atributo, que define el ancho de la imagen mostrada para el botón, si el valor de type es image.
Propiedades que se aplican solo a elementos de tipo file
accept string: Devoluciones / Conjuntos los elementos accept atributo, que contiene una lista separada por comas de los tipos de archivos aceptados por el servidor cuando type es file.
allowdirs Esta API no se ha estandarizado. Boolean: Parte de la API de carga de directorios no estándar; indica si permitir o no que tanto los directorios como los archivos se seleccionen en la lista de archivos. Implementado solo en Firefox y está oculto detrás de una preferencia.
files Devoluciones / acepta a FileList objeto, que contiene una lista de File objetos que representan los archivos seleccionados para cargar.
webkitdirectory Esta API no se ha estandarizado. Boolean: Devoluciones los webkitdirectory atributo; si es verdadero, la interfaz del selector del sistema de archivos solo acepta directorios en lugar de archivos.
webkitEntries Esta API no se ha estandarizado. Gama de FileSystemEntry objetos: Describe los archivos o directorios seleccionados actualmente.
Propiedades que se aplican solo a text/number-conteniendo o elementos
autocomplete string: Devoluciones / Conjuntos los elementos autocomplete atributo, que indica si el navegador puede completar automáticamente el valor del control. Ignorado si el valor del type atributo es hidden, checkbox, radio, file, o un tipo de botón (button, submit, reset, image). Los posibles valores son:
on: el navegador puede autocompletar el valor usando el valor almacenado previamente
off: el usuario debe ingresar explícitamente un valor
max string: Devoluciones / Conjuntos los elementos max atributo, que contiene el valor máximo (numérico o fecha-hora) para este artículo, que no debe ser menor que su mínimo (min valor de atributo.
maxLength long: Devoluciones / Conjuntos los elementos maxlength atributo, que contiene el número máximo de caracteres (en puntos de código Unicode) que puede tener el valor. (Si establece esto en un número negativo, se lanzará una excepción).
min string: Devoluciones / Conjuntos los elementos min atributo, que contiene el valor mínimo (numérico o de fecha y hora) para este artículo, que no debe ser mayor que su máximo (max valor de atributo.
minLength long: Devoluciones / Conjuntos los elementos minlength atributo, que contiene el número mínimo de caracteres (en puntos de código Unicode) que puede tener el valor. (Si establece esto en un número negativo, se lanzará una excepción).
pattern string: Devoluciones / Conjuntos los elementos pattern atributo, que contiene un expresión regular contra el que se comprueba el valor del control. Utilizar el title atributo para describir el patrón para ayudar al usuario. Este atributo se aplica cuando el valor del type atributo es text, search, tel, url o email; de lo contrario, se ignora.
placeholder string: Devoluciones / Conjuntos los elementos placeholder atributo, que contiene una pista para el usuario de lo que se puede ingresar en el control. El texto del marcador de posición no debe contener retornos de carro ni saltos de línea. Este atributo se aplica cuando el valor del type atributo es text, search, tel, url o email; de lo contrario, se ignora.
readOnly boolean: Devoluciones / Conjuntos los elementos readonly atributo, que indica que el usuario no puede modificar el valor del control.
Esto se ignora si el valor de la type atributo es hidden, range, color, checkbox, radio, fileo un tipo de botón.
selectionStart unsigned long: Devoluciones / Conjuntos el índice inicial del texto seleccionado. Cuando no se selecciona nada, esto devuelve la posición del cursor de entrada de texto (símbolo de intercalación) dentro del <input> elemento.
selectionEnd unsigned long: Devoluciones / Conjuntos el índice final del texto seleccionado. Cuando no hay selección, esto devuelve el desplazamiento del carácter inmediatamente después de la posición actual del cursor de entrada de texto.
selectionDirection string: Devoluciones / Conjuntos la dirección en la que ocurrió la selección. Los posibles valores son:
forward si la selección se realizó en la dirección de principio a fin de la ubicación actual
backward para la dirección opuesta
none si la dirección es desconocida
size unsigned long: Devoluciones / Conjuntos los elementos size atributo, que contiene tamaño visual del control. Este valor está en píxeles a menos que el valor de type es text o password, en cuyo caso, es un número entero de caracteres. Se aplica solo cuando type se establece en text, search, tel, url, email, o password; de lo contrario, se ignora.
Propiedades aún no categorizadas
defaultValue string: Devoluciones / Conjuntos el valor predeterminado como se especificó originalmente en el HTML que creó este objeto.
dirName string: Devoluciones / Conjuntos la direccionalidad del elemento.
accessKey string: Devoluciones una cadena que contiene un solo carácter que cambia el foco de entrada al control cuando se presiona.
list Solo lectura HTMLElement object: Devoluciones el elemento apuntado por el list atributo. La propiedad puede ser null si no se encuentra ningún elemento HTML en el mismo árbol.
multiple Boolean: Devoluciones / Conjuntos los elementos multiple atributo, que indica si es posible más de un valor (por ejemplo, varios archivos).
files FileList array: Devoluciones la lista de archivos seleccionados.
HTMLInputElement.labels Solo lectura NodeList array: Devoluciones una lista de <label> elementos que son etiquetas para este elemento.
step string: Devoluciones / Conjuntos los elementos step atributo, que funciona con min y max para limitar los incrementos en los que se puede establecer un valor numérico o de fecha y hora. Puede ser la cuerda any o un número de coma flotante positivo. Si esto no se establece en any, el control acepta solo valores en múltiplos del valor de paso mayor que el mínimo.
valueAsDate Date object: Devoluciones / Conjuntos el valor del elemento, interpretado como una fecha, o null si la conversión no es posible.
valueAsNumber double: Devoluciones el valor del elemento, interpretado como uno de los siguientes, en orden:

  • Un valor de tiempo
  • Un número
  • NaN si la conversión es imposible
autocapitalize Esta es una API experimental que no debe usarse en código de producción. string: Define el comportamiento de uso de mayúsculas para la entrada del usuario. Los valores válidos son none, off, characters, words, o sentences.
inputmode Proporciona una pista a los navegadores sobre el tipo de configuración de teclado virtual que se debe utilizar al editar este elemento o su contenido.
HTMLInputElement.align Esta API obsoleta ya no debería usarse, pero probablemente seguirá funcionando.
string: Representa la alineación del elemento. Utilice CSS en su lugar.
HTMLInputElement.useMap Esta API obsoleta ya no debería usarse, pero probablemente seguirá funcionando.
string: Representa un mapa de imágenes del lado del cliente.

Métodos

blur() Elimina el foco del elemento de entrada; posteriormente, las pulsaciones de teclas no irán a ninguna parte.
click() Simula un clic en el elemento de entrada.
focus() Se centra en el elemento de entrada; las pulsaciones de teclas irán posteriormente a este elemento.
select() Selecciona todo el texto del elemento de entrada y lo enfoca para que el usuario pueda reemplazar posteriormente todo su contenido.
setSelectionRange() Selecciona un rango de texto en el elemento de entrada (pero no lo enfoca).
setRangeText() Reemplaza un rango de texto en el elemento de entrada con texto nuevo.
setCustomValidity() Establece un mensaje de validez personalizado para el elemento. Si este mensaje no es la cadena vacía, entonces el elemento sufre un error de validez personalizado y no se valida.
checkValidity() Devuelve un Boolean es decir false si el elemento es candidato para la validación de restricciones y no satisface sus restricciones. En este caso, también dispara un invalid evento en el elemento. Vuelve true si el elemento no es candidato para la validación de restricciones, o si satisface sus restricciones.
reportValidity() Ejecuta el checkValidity() y si devuelve falso (para una entrada no válida o ningún atributo de patrón proporcionado), informa al usuario que la entrada no es válida de la misma manera que si hubiera enviado un formulario.
HTMLInputElement.stepDown()
Disminuye el value por (step * n), donde n toma el valor predeterminado de 1 si no se especifica. Lanza una excepción INVALID_STATE_ERR:

  • si el método no es aplicable a la actual type valor,
  • si el elemento no tiene step valor,
  • Si el value no se puede convertir a un número,
  • si el valor resultante está por encima del max o debajo del min.
HTMLInputElement.stepUp()
Incrementa el value por (step * n), donde n toma el valor predeterminado de 1 si no se especifica. Lanza una excepción INVALID_STATE_ERR:

  • si el método no es aplicable a la actual type valor.,
  • si el elemento no tiene step valor,
  • Si el value no se puede convertir a un número,
  • si el valor resultante está por encima del max o debajo del min.
HTMLInputElement.mozSetFileArray() Esta API no se ha estandarizado.
Establece los archivos seleccionados en la entrada a la matriz dada de File objetos. Esta es una alternativa a mozSetFileNameArray() que se puede utilizar en scripts de marcos: un script de Chrome puede abrir archivos como objetos de archivo y enviarlos a través de administrador de mensajes.
HTMLInputElement.mozGetFileNameArray() Esta API no se ha estandarizado.
Devuelve una matriz de todos los nombres de archivo de la entrada.
HTMLInputElement.mozSetFileNameArray() Esta API no se ha estandarizado.
Establece los nombres de archivo para los archivos seleccionados en la entrada. No apto para uso en secuencias de comandos de marco, porque accede al sistema de archivos.

Eventos

Escuche estos eventos usando addEventListener() o asignando un detector de eventos al oneventname propiedad de esta interfaz:

input
Dispara cuando el value de un <input>, <select>, o <textarea> se ha cambiado el elemento. Tenga en cuenta que esto en realidad se dispara en el HTMLElement interfaz y también se aplica a contenteditable elementos, pero lo hemos enumerado aquí porque se usa más comúnmente con elementos de entrada de formulario.
También disponible a través de oninput propiedad del controlador de eventos.
invalid
Se activa cuando un elemento no satisface sus restricciones durante la validación de restricciones.
También disponible a través de oninvalid propiedad del controlador de eventos.
search
Se activa cuando se inicia una búsqueda en un <input> de type="search".
También disponible a través de onsearch propiedad del controlador de eventos.

Especificaciones

Especificación Estado Comentario
Estándar de vida HTML
La definición de ‘HTMLInputElement’ en esa especificación.		 Estándar de vida
HTML5
La definición de ‘HTMLInputElement’ en esa especificación.		 Recomendación Técnicamente, el tabindex y accesskey propiedades, así como blur(), click(), y focus() métodos, ahora se definen en HTMLElement.
Las siguientes propiedades ahora están obsoletas: align y useMap.
Se han agregado las siguientes propiedades: autocomplete, autofocus, dirName, files, formAction, formEnctype, formMethod, formNoValidate, formTarget, height, indeterminate, labels, list, max, min, multiple, pattern, placeholder, required, selectionDirection, selectionEnd, selectionStart, step, validationMessage, validity, valueAsDate, valueAsNumber, width, y willValidate.
Se han agregado los siguientes métodos: checkValidity(), setCustomValidity(), setSelectionRange(), stepUp(), y stepDown().
Especificación HTML de nivel 2 del modelo de objetos de documento (DOM)
La definición de ‘HTMLInputElement’ en esa especificación.		 Obsoleto los size la propiedad es ahora un unsigned long. los type La propiedad se debe dar enteramente en minúsculas.
Especificación de nivel 1 del modelo de objetos de documento (DOM)
La definición de ‘HTMLInputElement’ en esa especificación.		 Obsoleto Definición inicial.

Compatibilidad del navegador

Escritorio Móvil
Cromo Borde Firefox explorador de Internet Ópera Safari WebView Android Chrome Android Firefox para Android Opera Android Safari en IOS Internet de Samsung
HTMLInputElement 1 12 1 5.5 8 1 1 18 4 10.1 1 1.0
accept 1 12 1 6 ≤12,1 1 1 18 4 ≤12,1 1 1.0
align 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
alt 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
autocomplete 14 12 4 10 ≤12,1 6 ≤37 18 4 ≤12,1 6 1.0
autofocus 1 12 4 10 ≤12,1 4 1 18 4 ≤12,1 3.2 1.0
capture No No No No No No sí sí sí sí sí sí
checked 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
checkValidity 4 12 4 10 ≤12,1 5 ≤37 18 4 ≤12,1 4 1.0
defaultChecked 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
defaultValue 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
dirName 17 79 No No ≤12,1 6 ≤37 18 No ≤12,1 6 1.0
disabled 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
files 1 12 3

10 Esta propiedad es solo lectura.

≤12,1 4 1 18 4 ≤12,1 3 1.0
form 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
formAction 9 12 4 10 ≤12,1 5.1 ≤37 18 4 ≤12,1 5 1.0
formEnctype 9 12 4 sí ≤12,1 5.1 ≤37 18 4 ≤12,1 5.1 1.0
formMethod 9 12 4 10 ≤12,1 5.1 ≤37 18 4 ≤12,1 5 1.0
formNoValidate 4 12 4 10 ≤12,1 5 ≤37 18 4 ≤12,1 4 1.0
formTarget 9 12 4 10 ≤12,1 5.1 ≤37 18 4 ≤12,1 5 1.0
height 21 12 dieciséis 5.5 ≤12,1 6.1 ≤37 25 dieciséis ≤12,1 6 1,5
incremental 10 79 No No 15 5.1 ≤37 18 No 14 5 1.0
indeterminate 1 12 3.6 5.5 ≤12,1 3 1 18 4 ≤12,1 1 1.0
invalid_event 10 12 4 10 10 5 4 18 64 12 5 4.0
labels 6 18 56 No ≤12,1 5.1 ≤37 18 56 ≤12,1 5 1.0
list 20 12 4 10 ≤12,1 12,1 ≤37 25 4 ≤12,1 12,2 1,5
max 4 12 dieciséis 10 ≤12,1 5 ≤37 18 dieciséis ≤12,1 4 1.0
maxLength 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
min 4 12 dieciséis 10 ≤12,1 5 ≤37 18 dieciséis ≤12,1 4 1.0
minLength 40 17 51 No 27 10.1 40 40 51 27 10,3 4.0
multiple 2 12 3.6 10 ≤12,1 4 ≤37 18 4 ≤12,1 3.2 1.0
name 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
onsearch 1 79 No No 15 1.3 1 18 No 14 1 1.0
pattern 4 12 4 10 ≤12,1 5 ≤37 18 4 ≤12,1 4 1.0
placeholder 3 12 4 10 ≤12,1 4 ≤37 18 4 ≤12,1 3.2 1.0
readOnly 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
reportValidity 40 17 49 No 27 10.1 40 40 64 27 10,3 4.0
required 4 12 4 10 ≤12,1 5 ≤37 18 4 ≤12,1 4 1.0
search_event sí 79 No No sí sí sí sí No ? ? sí
select 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
selectionDirection 15 13 8 No ≤12,1 6 ≤37 18 8 ≤12,1 6 1.0
selectionEnd 1 12 1 9 ≤12,1 1.3 1 18 4 ≤12,1 1 1.0
selectionStart 1 12 1 9 ≤12,1 1.3 1 18 4 ≤12,1 1 1.0
setCustomValidity 4 12 4 10 ≤12,1 5 ≤37 18 4 ≤12,1 4 1.0
setRangeText 24 79 27 No 15 6.1 ≤37 25 27 14 7 1,5
setSelectionRange 1 12 1 9 8 3 1 18 4 10.1 1 1.0
size 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
src 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
step 5 12 dieciséis 10 ≤12,1 5 ≤37 18 dieciséis ≤12,1 4 1.0
stepDown 5 12

16 No tiene una interfaz de usuario específica. Todavía hay diferencias con la última especificación; ver error 835773.

10 ≤12,1 5 ≤37 18

16 No tiene una interfaz de usuario específica. Todavía hay diferencias con la última especificación; ver error 835773.

≤12,1 4 1.0
stepUp 5 12

16 No tiene una interfaz de usuario específica. Todavía hay diferencias con la última especificación; ver error 835773.

10 ≤12,1 5 ≤37 18

16 No tiene una interfaz de usuario específica. Todavía hay diferencias con la última especificación; ver error 835773.

≤12,1 4 1.0
type 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
useMap 1 12 1 6 ≤12,1 1 1 18 4 ≤12,1 1 1.0
validationMessage 5 12 4 10 ≤12,1 5 ≤37 18 4 ≤12,1 4 1.0
validity 3 12 4 10 ≤12,1 5 ≤37 18 4 ≤12,1 4 1.0
value 1 12 1 5.5 ≤12,1 1 1 18 4 ≤12,1 1 1.0
valueAsDate 5 12

57 20-24

No ≤12,1 5 ≤37 18

57 20-24

≤12,1 4 1.0
valueAsNumber 5 12 dieciséis 10 ≤12,1 5 ≤37 18 dieciséis ≤12,1 4 1.0
webkitdirectory 6 13 50 No 15 11,1 ≤37 18 50 14 11,3 1.0
webkitEntries 22 79 50 No 15 11,1 ≤37 25 No 14 11,3 1,5
width 21 12 dieciséis 5.5 ≤12,1 6.1 ≤37 25 dieciséis ≤12,1 6 1,5
willValidate 1 12 4 10 ≤12,1 4 1 18 4 ≤12,1 3 1.0

Ver también

  • Elemento HTML que implementa esta interfaz: <input>