A interfaceHTMLInputElement fornece propriedades e métodos especiais para manipular as opções, layout e apresentação de elementos<input>.

Propriedades da instância

Algumas propriedades se aplicam apenas a tipos de elemento de entrada que suportam os atributos correspondentes.

alignDeprecated

string:Representa o alinhamento do elemento.Em vez disso, use CSS.

autocapitalizeExperimental

string:Define o comportamento de capitalização para a entrada do usuário. Os valores válidos sãonone,off,characters,words ousentences.

defaultValue

string:Retorna / Define o valor padrão como originalmente especificado no HTML que criou este objeto.

dirName

string:Retorna / Define a direcionalidade do elemento.

inputmode

Fornece uma dica aos navegadores quanto ao tipo de configuração do teclado virtual a ser usado ao editar este elemento ou seu conteúdo.

labelsSomente leitura

NodeList array:Retorna uma lista de elementos<label> que são rótulos para este elemento.

listSomente leitura

HTMLElement:Retorna o elemento apontado pelo atributolist. A propriedade pode sernull se nenhum elemento HTML for encontrado na mesma árvore.

multiple

boolean:Retorna / Define o atributomultiple do elemento, indicando se mais de um valor é possível (ex. , vários arquivos).

name

string:Retorna / Define o atributoname do elemento, contendo um nome que identifica o elemento ao enviar o formulário.

step

string:Retorna / Define o atributostep do elemento, que funciona commin emax para limitar os incrementos nos quais um número ou data - valor de tempo pode ser definido. Pode ser a stringany ou um número de ponto flutuante positivo. Se isso não for definido comoany, o controle aceitará apenas valores em múltiplos do valor da etapa maior que o mínimo.

type

string:Retorna / Define o atributotype do elemento, indicando o tipo de controle a ser exibido. Para valores possíveis, consulte a documentação do atributotype.

useMapDeprecated

string:Representa um mapa de imagem do lado do cliente.

value

string:Retorna / Define o valor atual do controle. Se o usuário inserir um valor diferente do valor esperado, isso pode retornar uma string vazia.

valueAsDate

Date:Retorna / Define o valor do elemento, interpretado como uma data, ounull se a conversão não for possível.

valueAsNumber

double:Retorna o valor do elemento, interpretado como um dos seguintes, em ordem: Um valor de tempo, um número ouNaN se a conversão for impossível

Propriedades de instância relacionadas ao formulário pai

formSomente leitura

HTMLFormElement:Retorna uma referência ao elemento pai<form>.

formAction

string:Retorna / Define o atributoformaction do elemento, contendo a URL de um programa que processa as informações enviadas pelo elemento. Isso substitui o atributoaction do formulário pai.

formEnctype

string:Retorna / Define o atributoformenctype do elemento, contendo o tipo de conteúdo que é usado para enviar o formulário para o servidor. Isso substitui o atributoenctype do formulário pai.

formMethod

string:Retorna / Define o atributoformmethod do elemento, contendo o método HTTP que o navegador usa para enviar a forma. Isso substitui o atributomethod do formulário pai.

formNoValidate

boolean:Retorna / Define o atributoformnovalidate do elemento, indicando que o formulário não deve ser validado quando ele é submetido. Isso substitui o atributonovalidate do formulário pai.

formTarget

string:Retorna / Define o atributoformtarget do elemento, contendo um nome ou palavra-chave indicando onde exibir o resposta recebida após o envio do formulário. Isso substitui o atributotarget do formulário pai.

Propriedades de instância que se aplicam a qualquer tipo de elemento de entrada que não esteja oculto

autofocus

boolean:Retorna / Define o atributoautofocus do elemento, que especifica que um controle de formulário deve ter foco de entrada quando a página é carregada, a menos que o usuário a substitua, por exemplo, digitando um controle diferente. Apenas um elemento de formulário em um documento pode ter o atributoautofocus.

disabled

boolean:Retorna / Define o atributodisabled do elemento, indicando que o controle não está disponível para interação. Os valores de entrada não serão enviados com o formulário. Veja tambémreadonly.

required

boolean:Retorna / Define o atributorequired do elemento, indicando que o usuário deve preencher um valor antes de enviar um formulário.

validationMessageSomente leitura

string:Retorna uma mensagem localizada que descreve as restrições de validação que o controle não atende (se houver). Esta é a string vazia se o controle não for um candidato para validação de restrição (willValidate éfalse), ou se satisfizer suas restrições. Este valor pode ser definido pelo métodosetCustomValidity().

validitySomente leitura

ValidityState:Retorna o estado de validade atual do elemento.

willValidateSomente leitura

boolean:Retorna se o elemento é um candidato para validação de restrição. Éfalse se alguma condição o impedir de validação de restrição, incluindo: seutype é um doshidden,reset oubutton, tem um ancestral<datalist> ou sua propriedadedisabled étrue.

Propriedades de instância que se aplicam apenas a elementos do tipo caixa de seleção ou rádio

checked

boolean:Retorna / Define o estado atual do elemento.

defaultChecked

boolean:Retorna / Define o estado padrão de um botão de rádio ou caixa de seleção conforme originalmente especificado no HTML que criou este objeto.

indeterminate

boolean:Retorna se a caixa de seleção ou o botão de opção está em estado indeterminado. Para caixas de seleção, o efeito é que a aparência da caixa de seleção é obscurecida/acinzentada de alguma forma para indicar que seu estado é indeterminado (não marcado, mas não desmarcado). Não afeta o valor do atributochecked, e clicar na caixa de seleção definirá o valor como falso.

Propriedades de instância que se aplicam apenas a elementos do tipo imagem

alt

string:Retorna / Define o atributoalt do elemento, contendo texto alternativo a ser usado.

height

string:Retorna / Define o atributoheight do elemento, que define a altura da imagem exibida para o botão.

src

string:Retorna / Define o atributosrc do elemento, que especifica um URI para a localização de uma imagem para exibir no botão gráfico de envio.

width

string:Retorna / Define o atributowidth do elemento, que define a largura da imagem exibida para o botão.

Propriedades de instância que se aplicam apenas a elementos do tipo arquivo

accept

string:Retorna / Define o atributoaccept do elemento, contendo uma lista separada por vírgulas de tipos de arquivos que podem ser selecionado.

allowdirsNão padrão

boolean: Parte da API de upload de diretório não padrão. Indica se permite ou não que diretórios e arquivos sejam selecionados na lista de arquivos. Implementado apenas no Firefox e está oculto atrás de uma preferência.

files

FileList:Retorna / Define uma lista de objetosFile representando os arquivos selecionados para upload.

webkitdirectory

boolean:Retorna o atributowebkitdirectory. Se for verdadeiro, a interface do seletor do sistema de arquivos aceita apenas diretórios em vez de arquivos.

webkitEntries

FileSystemEntry array:Descreve os arquivos ou diretórios atualmente selecionados.

Propriedades de instância que se aplicam apenas a elementos visíveis contendo texto ou números

autocomplete

string:Retorna / Define o atributoautocomplete do elemento, indicando se o valor do controle pode ser automaticamente preenchido pelo navegador.

max

string:Retorna / Define o atributomax do elemento, contendo o valor (numérico ou data-hora) máximo para este item, que não deve ser menor que seu valor mínimo (atributomin).

maxLength

unsigned long:Retorna / Define o atributomaxlength do elemento, contendo o número máximo de caracteres (em pontos de código Unicode) que o valor pode ter.

min

string:Retorna / Define o atributomin do elemento, contendo o valor (numérico ou data-hora) mínimo para este item, que não deve ser maior que seu valor máximo (atributomax).

minLength

unsigned long:Retorna / Define o atributominlength do elemento, contendo o número mínimo de caracteres (em Unicode pontos de código) que o valor pode ter.

pattern

string:Retorna / Define o atributopattern do elemento, contendo uma expressão regular em que o valor do controle é verificado contra. Use o atributotitle para descrever o padrão para ajudar o usuário. Este atributo só se aplica quando o valor do atributotype étext,search,tel,url oue-mail.

placeholder

string:Retorna / Define o atributoplaceholder do elemento, contendo uma dica para o usuário do que pode ser inserido no controle. O texto do espaço reservado não deve conter retornos de carro ou avanços de linha. Este atributo só se aplica quando o valor do atributotype étext,search,tel,url oue-mail.

readOnly

boolean:Retorna / Define o atributoreadonly do elemento, indicando que o usuário não pode modificar o valor do controle. Isso é ignorado se otype forhidden,range,color,checkbox,radio,file, ou um tipo de botão.

selectionEnd

unsigned long:Retorna / Define o índice final do texto selecionado. Quando não há seleção, isso retorna o deslocamento do caractere imediatamente após a posição atual do cursor de entrada de texto.

selectionStart

unsigned long:Retorna / Define o índice inicial do texto selecionado. Quando nada é selecionado, retorna a posição do cursor de entrada de texto (caret) dentro do elemento<input>.

selectionDirection

string:Retorna / Define a direção em que a seleção ocorreu. Os valores possíveis são:forward (a seleção foi realizada na direção de início a fim do local atual),backward (a direção oposta) ounone (a direção é desconhecida).

size

unsigned long:Retorna / Define o atributosize do elemento, contendo o tamanho visual do controle. Este valor está em pixels, a menos que o valor detype sejatext oupassword, caso em que é um número inteiro indicando o número de caracteres. Aplica-se somente quandotype é definido comotext,search,tel,url,email ousenha.

Métodos de instância

blur()

Remove o foco do elemento de entrada; as teclas digitadas subsequentemente não irão a lugar nenhum.

click()

Simula um clique no elemento de entrada.

focus()

Foca no elemento de entrada; os pressionamentos de tecla irão posteriormente para este elemento.

select()

Seleciona todo o texto no elemento de entrada e o foca para que o usuário possa substituir posteriormente todo o seu conteúdo.

setSelectionRange()

Seleciona um intervalo de texto no elemento de entrada (mas não o focaliza).

setRangeText()

Substitui um intervalo de texto no elemento de entrada por um novo texto.

setCustomValidity()

Define uma mensagem de validação personalizada para o elemento. Se esta mensagem não for a string vazia, o elemento está sofrendo de um erro de validade personalizado e não é validado.

showPicker()

Mostra um seletor de navegador para data, hora, cor e arquivos.

checkValidity()

Retorna um valor booleano que éfalse se o elemento for um candidato para validação de restrição e não satisfizer suas restrições. Nesse caso, ele também dispara um eventoinvalid no elemento. Ele retornatrue se o elemento não for um candidato para validação de restrição ou se satisfizer suas restrições.

reportValidity()

Executa o métodocheckValidity() e, se retornar falso (para uma entrada inválida ou nenhum atributo de padrão fornecido), ele relata ao usuário que a entrada é inválida da mesma maneira como se você enviasse um formulário.

stepDown()

Decrementa ovalue em (step * n), em que n é padronizado como 1 se não for especificado. Lança uma exceçãoInvalidStateError:

• se o método não for aplicável para o valortype atual,
• se o elemento não tiver valorstep,
• se ovalue não puder ser convertido em um número,
• se o valor resultante estiver acima demax ou abaixo demin.

stepUp()

Incrementa ovalue em (step * n), em que n é padronizado como 1 se não for especificado. Lança uma exceçãoInvalidStateError:

• se o método não for aplicável para o valor atual detype,
• se o elemento não tiver valorstep,
• se ovalue não puder ser convertido em um número,
• se o valor resultante estiver acima demax ou abaixo demin.

Eventos

Ouça esses eventos usandoaddEventListener() ou atribuindo um ouvinte de evento à propriedadeoneventname desta interface:

input

Dispara quando ovalue de um elemento<input>,<select> ou<textarea> foi alterado. Observe que na verdade isso é acionado na interfaceHTMLElement e também se aplica a elementoscontenteditable, mas também listamos aqui porque é mais comumente usado com elementos de entrada de formulário.

invalid

Disparado quando um elemento não satisfaz suas restrições durante a validação da restrição.

searchNão padrão

Disparado quando uma pesquisa é iniciada em um<input> detype="search".

selectionchange eventoExperimental

Dispara quando a seleção de texto em um elemento<input> foi alterada.

Especificações

Compatibilidade com navegadores

Veja também

• Elemento HTML implementando esta interface:<input>