HTMLInputElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
A interface HTMLInputElement
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.
align
Deprecated-
string
: Representa o alinhamento do elemento. Em vez disso, use CSS. autocapitalize
Experimental-
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.
labels
Somente leitura-
NodeList
array: Retorna uma lista de elementos<label>
que são rótulos para este elemento. list
Somente 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
. useMap
Deprecated-
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
form
Somente 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. validationMessage
Somente 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()
. validity
Somente leitura-
ValidityState
: Retorna o estado de validade atual do elemento. willValidate
Somente 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. allowdirs
Non-standard-
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étodo
checkValidity()
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 o
value
em (step
* n), em que n é padronizado como 1 se não for especificado. Lança uma exceçãoInvalidStateError
: stepUp()
-
Incrementa o
value
em (step
* n), em que n é padronizado como 1 se não for especificado. Lança uma exceçãoInvalidStateError
:
Eventos
Ouça esses eventos usando addEventListener()
ou atribuindo um ouvinte de evento à propriedade oneventname
desta interface:
input
-
Dispara quando o
value
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.
search
Non-standard-
Disparado quando uma pesquisa é iniciada em um
<input>
detype="search"
. selectionchange
evento Experimental-
Dispara quando a seleção de texto em um elemento
<input>
foi alterada.
Especificações
Specification |
---|
HTML Standard # htmlinputelement |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- Elemento HTML implementando esta interface:
<input>