HTMLInputElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.

* Some parts of this feature may have varying levels of support.

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

Propiedades de instancia

Algunas propiedades solo se aplican a los tipos de elementos de entrada que admiten los atributos correspondientes.

alignObsoleto: string:Representa la alineación del elemento.Use CSS en su lugar.
autocapitalizeExperimental: string:Define el comportamiento de uso de mayúsculas para la entrada del usuario. Los valores válidos sonnone,off,characters,words osentences.
defaultValue: string:Devuelve/Establece el valor predeterminado como se especificó originalmente en el código HTML que creó este objeto.
dirName: string:Devuelve/Establece la direccionalidad del elemento.
inputmode: Proporciona una pista a los navegadores sobre el tipo de configuración de teclado virtual que se debe usar al editar este elemento o su contenido.
labelsRead only: Arreglo deNodeList:Devuelve una lista de elementos<label> que son etiquetas para este elemento.
listRead only: HTMLElement:Devuelve el elemento al que apunta el atributolist. La propiedad puede sernull si no se encuentra ningún elemento HTML en el mismo árbol.
multiple: boolean:Devuelve/Establece el atributomultiple del elemento, indicando si es posible más de un valor (por ejemplo, varios archivos).
name: string:Devuelve/Establece el atributoname del elemento, que contiene un nombre que identifica al elemento al enviar el formulario.
popoverTargetAction: Obtiene y establece la acción que se realizará ("hide","show", o"toggle") en un elemento emergente controlado por un elemento<input> de tipotype="button". Refleja el valor del atributo HTMLpopovertargetaction.
popoverTargetElement: Obtiene y establece el control del elemento popover a través de un elemento<input> detype="button". El equivalente JavaScript del atributo HTMLpopovertarget.
step: string:Devuelve/Establece el atributostep del elemento, que funciona conmin ymax para limitar los incrementos en los que se puede establecer un valor numérico o de fecha y hora. Puede ser la cadenaany o un número de punto flotante positivo. Si esto no se establece enany, el control solo acepta valores en múltiplos del valor de paso mayor que el mínimo.
type: string:Devuelve/Establece el atributotype del elemento, indicando el tipo de control a mostrar. Para conocer los posibles valores, consulte la documentación del atributotype.
useMapObsoleto: string:Representa un mapa de imagen del lado del cliente.
value: string:Devuelve/Establece el valor actual del control. Si el usuario ingresa un valor diferente del valor esperado, esto puede devolver una cadena vacía.
valueAsDate: Date:Devuelve/Establece el valor del elemento, interpretado como una fecha, onull si la conversión no es posible.
valueAsNumber: double:Devuelve el valor del elemento, interpretado como uno de los siguientes, en orden: un valor de tiempo, un número oNaN si la conversión es imposible

Propiedades de instancia relacionadas con el formulario padre

formRead only: HTMLFormElement:Devuelve una referencia al elemento<form> padre.
formAction: string:Devuelve/Establece el atributoformaction del elemento, que contiene la URL de un programa que procesa la información enviada por el elemento. Esto anula el atributoaction del formulario padre.
formEnctype: string:Devuelve/Establece el atributoformenctype del elemento, que contiene el tipo de contenido que se utiliza para enviar el formulario al servidor. Esto anula el atributoenctype del formulario padre.
formMethod: string:Devuelve/Establece el atributoformmethod del elemento, que contiene el método HTTP que utiliza el navegador para enviar el formulario. Esto anula el atributomethod del formulario padre.
formNoValidate: boolean:Devuelve/Establece el atributoformnovalidate del elemento, indicando que el formulario no debe validarse cuando se envía. Esto anula el atributonovalidate del formulario padre.
formTarget: string:Devuelve/Establece el atributoformtarget del elemento, 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 atributotarget del formulario padre.

Propiedades de instancia que se aplican a cualquier tipo de elemento de entrada que no esté oculto

autofocus: boolean:Devuelve/Establece el atributoautofocus del elemento, 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 anula, por ejemplo, escribiendo en un control diferente. Solo un elemento de formulario en un documento puede tener el atributoautofocus.
disabled: boolean:Devuelve/Establece el atributodisabled del elemento, indicando que el control no está disponible para la interacción. Los valores de entrada no se enviarán con el formulario. Vea tambiénreadonly.
required: boolean:Devuelve/Establece el atributorequired del elemento, indicando que el usuario debe llenar un valor antes de enviar un formulario.
validationMessageRead only: string:Devuelve un mensaje específico que describe las restricciones de validación que el control no cumple (si las hay). Esta es la cadena vacía si el control no es candidato para la validación de restricciones (willValidate esfalse), o cumple sus restricciones. Este valor se puede establecer mediante el métodosetCustomValidity().
validityRead only: ValidityState:Devuelve el estado de validez actual del elemento.
willValidateRead only: boolean:Devuelve si el elemento es candidato para la validación de restricciones. Esfalse si alguna condición le impide la validación de restricciones, incluyendo: sitype eshidden,reset obutton, tiene un antecesor<datalist> o su propiedaddisabled estrue.

Propiedades de instancia que se aplican solo a elementos de tipo checkbox o radio

checked: boolean:Devuelve/Establece el estado actual del elemento.
defaultChecked: boolean:Devuelve/Establece el estado predeterminado de un botón de radio o casilla de verificación como se especificó originalmente en el HTML que creó este objeto.
indeterminate: boolean:Devuelve si la casilla de verificación o el botón de opción están en un estado indeterminado. Para las casillas de verificación, el efecto es que la apariencia de la casilla de verificación está oscurecida o atenuada de alguna manera para indicar que su estado es indeterminado (no está marcada pero tampoco no está marcada). No afecta el valor del atributochecked y al hacer clic en la casilla de verificación se establecerá el valor en falso.

Propiedades de instancia que se aplican solo a elementos de tipo imagen

alt: string:Devuelve/Establece el atributoalt del elemento, que contiene texto alternativo a utilizar.
height: string:Devuelve/Establece el atributoheight del elemento, que define la altura de la imagen mostrada para el botón.
src: string:Devuelve/Establece el atributosrc del elemento, que especifica un URI para la ubicación de una imagen que se mostrará en el botón de envío gráfico.
width: string:Devuelve/Establece el atributowidth del elemento, que define el ancho de la imagen mostrada para el botón.

Propiedades de instancia que se aplican solo a elementos de tipo archivo

accept: string:Devuelve/Establece el atributoaccept del elemento, que contiene una lista separada por comas de los tipos de archivos que se pueden seleccionar.
allowdirsNo estándar: boolean: Parte de la API de carga de directorios no estándar. Indica si se permite o no la selección de directorios y archivos en la lista de archivos. Implementado solo en Firefox y está oculto detrás de una preferencia.
files: FileList:Devuelve/Establece una lista de objetosFile que representan los archivos seleccionados para cargar.
webkitdirectory: boolean:Devuelve el atributowebkitdirectory. Si estrue, la interfaz del selector del sistema de archivos solo acepta directorios en lugar de archivos.
webkitEntries: Arreglo deFileSystemEntry:Describe los archivos o directorios actualmente seleccionados.

Propiedades de instancia que se aplican solo a elementos visibles que contienen texto o números

autocomplete: string:Devuelve/Establece el atributoautocompletar del elemento, indicando si el valor del control puede ser completado automáticamente por el navegador.
max: string:Devuelve/Establece el atributomax del elemento, que contiene el valor máximo (numérico o de fecha y hora) para este elemento, que no debe ser menor que su valor mínimo (atributomin).
maxLength: unsigned long:Devuelve/Establece el atributomaxlength del elemento, que contiene el número máximo de caracteres (en puntos de código Unicode) que puede tener el valor.
min: string:Devuelve/Establece el atributomin del elemento, que contiene el valor mínimo (numérico o de fecha y hora) para este elemento, que no debe ser mayor que su valor máximo (atributomax).
minLength: unsigned long:Devuelve/Establece el atributominlength del elemento, que contiene el número mínimo de caracteres (en puntos de código Unicode) que puede tener el valor.
pattern: string:Devuelve/Establece el atributopattern del elemento, que contiene una expresión regular con la que se compara el valor del control. Use el atributotitle para describir el patrón para ayudar al usuario. Este atributo solo aplica cuando el valor del atributotype estext,search,tel,url oemail `.
placeholder: string:Devuelve/Establece el atributoplaceholder del elemento, 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 solo aplica cuando el valor del atributotype estext,search,tel,url oemail `.
readOnly: boolean:Devuelve/Establece el atributoreadonly del elemento, indicando que el usuario no puede modificar el valor del control. Esto se ignora sitype eshidden,range,color,checkbox,radio,file, o un tipo de botón.
selectionEnd: unsigned long:Devuelve/Establece el índice final del texto seleccionado. Cuando no hay selección, esto devuelve el desplazamiento del carácter que sigue inmediatamente a la posición actual del cursor de entrada de texto.
selectionStart: unsigned long:Devuelve/Establece el índice inicial del texto seleccionado. Cuando no se selecciona nada, esto devuelve la posición del cursor de entrada de texto (signo de intercalación^) dentro del elemento<input>.
selectionDirection: string:Devuelve/Establece la dirección en la que ocurrió la selección. Los valores posibles son:forward (la selección se realizó en la dirección de principio a fin de la ubicación actual),backward (la dirección opuesta) onone (la dirección es desconocida).
size: unsigned long:Devuelve/Establece el atributosize del elemento, que contiene el tamaño visual del control. Este valor está en píxeles a menos que el valortype seatext opassword, en cuyo caso, es un número entero de caracteres . Se aplica solo cuandotype se establece entext,search,tel,url,email opassword.

Instance methods

blur()

Elimina el foco del elemento de entrada; las pulsaciones de teclas no irán a ninguna parte.

click()

Simula un clic en el elemento de entrada.

focus()

Se enfoca en el elemento de entrada; las pulsaciones de teclas irán posteriormente a este elemento.

select()

Selecciona todo el texto en el elemento de entrada y lo enfoca para que el usuario pueda reemplazar todo su contenido posteriormente.

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 validación personalizado para el elemento. Si este mensaje no es la cadena vacía, entonces el elemento sufre un error de validación personalizado y no se valida.

showPicker()

Muestra un selector del navegador para fecha, hora, color y archivos.

checkValidity()

Devuelve un valor booleano que esfalse si el elemento es candidato para la validación de restricciones y no satisface sus restricciones. En este caso, también activa un eventoinvalid en el elemento. Devuelvetrue si el elemento no es candidato para la validación de restricciones, o si satisface sus restricciones.

reportValidity()

Ejecuta el métodocheckValidity() y, si devuelve falso (por una entrada no válida o porque no se proporcionó ningún atributo de patrón), informa al usuario que la entrada no es válida de la misma manera que si hubiera enviado un formulario.

stepDown()

Decrementavalue en (step * n) , donde n por defecto es 1 si no se especifica. Lanza una excepciónInvalidStateError:

si el método no es aplicable para el valor actual detype,
si el elemento no tiene valorstep,
sivalue no se puede convertir a un número,
si el valor resultante está por encima demax o por debajo de [min](/es/docs/Web/HTML/Element/input #min).

stepUp()

Incrementavalue en (step * n) , donde n por defecto es 1 si no se especifica. Lanza una excepciónInvalidStateError:

si el método no es aplicable para el valor actual detype,
si el elemento no tiene valorstep,
sivalue no se puede convertir a un número,
si el valor resultante está por encima demax o por debajo de [min](/es/docs/Web/HTML/Element/input #min).