<input>

Atributos

Este elemento inclui os atributos globais.

type

O tipo de controle a ser exibido. O tipo padrão é text, se este atributo não for especificado. Os valores possíveis são:

• button: Um botão sem comportamento padrão.

• checkbox: Uma caixa de marcação. Você deve usar o atributo value para definir o valor enviado por este item. Use o atributo checked para indicar se o item está selecionado por padrão. Você também pode usar o atributo indeterminate para indicar que a caixa de marcação está em um estado indeterminado (na maioria das plataformas, isso desenha uma linha horizontal cortando a caixa).

• color: Um controle para especificar cores. A interface de um seletor de cores não tem nenhuma funcionalidade obrigatória a não ser aceitar cores simples em texto (mais informações — em inglês).

• date: Um controle para inserir uma data (ano, mês e dia, sem horário).

• datetime: Um controle para inserir data e horário (hora, minuto, segundo e fração de segundo) baseado no fuso horário UTC.

• datetime-local: Um controle para inserir data e horário, sem fuso horário.

• email: Um campo para editar um endereço de e-mail. O valor do campo é validado para estar vazio ou ter um único endereço de e-mail válido antes de ser enviado. As pseudoclasses CSS :valid e :invalid são aplicadas apropriadamente.

• file: Um controle que permite ao usuário selecionar um arquivo. Use o atributoaccept para definir os tipos de arquivo que o controle pode selecionar.

• hidden: Um controle que não é exibido mas cujo valor é enviado ao servidor.

• image: Um botão gráfico para enviar o formulário. Você deve usar o atributo src para definir a fonte da imagem e o atributo alt para definir um texto alternativo. Você pode usar os atributos height e width para definir o tamanho da imagem em pixels.

• month: Um controle para inserir mês e ano, sem fuso horário.

• number: Um controle para inserir um número de ponto flutuante.

• password: Um campo de texto com uma só linha cujo valor é obscurecido. Use o atributo maxlength para especificar o comprimento máximo do valor que pode ser inserido.

• radio: Um botão de escolha. Você deve usar o atributo value para definir o valor a ser enviado por este item. Use o atributo checked para indicar se este item deve estar selecionado por padrão. Botões de escolha que têm o mesmo valor para o atributo name estão no mesmo "grupo de botões de escolha"; apenas um botão de escolha no grupo pode estar selecionado de cada vez..

• range: Um controle para inserir um número cujo valor exato não é importante. Este tipo de controle usa os seguintes valores padrão se os atributos correspondentes não forem especificados:

  • min: 0
  • max: 100
  • value: min + (max-min)/2, ou min se max for menos que min
  • step: 1

• reset: Um botão que faz o conteúdo do formulário voltar a ter seus valores padrão.

• search: Um campo de texto com uma só linha para digitar termos de busca; quebras de linha são automaticamente removidas do valor entrado.

• submit: Um botão que envia o formulário.

• tel: Um controle para inserir um número de telefone; quebras de linha são automaticamente removidas do valor entrado, mas nenhuma outra sintaxe é imposta. Você pode usar atributos como pattern e maxlength para restringir os valores inseridos no controle. As pseudoclasses CSS :valid e :invalid são aplicadas apropriadamente.

• text: Um campo de texto com uma só linha; quebras de linha são automaticamente removidas do valor entrado.

• time: Um controle para inserir um horário sem fuso horário.

• url: Um campo para editar uma URL. O valor inserido é validado para ser vazio ou uma URL absoluta válida antes de ser enviado. Quebras de linha e espaços em branco antes e após o valor inserido são automaticamente removidos. Você pode usar atributos como pattern e maxlength para restringir os valores inseridos no controle. As pseudoclasses CSS :valid e :invalid são aplicadas apropriadamente.

• week: Um controle para inserir uma data consistindo de ano da semana e número da semana sem fuso horário.

accept

Se o valor do atributo type for file, este atributo indica quais tipos de arquivo o servidor aceita; caso contrário, este atributo é ignorado. O valor deve ser uma lista de especificadores de tipo únicos separados por vírgula:

• Uma extensão de arquivo começando com o caractere STOP (U+002E). (Exemplo: ".jpg,.png,.doc")
• Um tipo MIME válido sem extensões
• audio/* representando arquivos de som
• video/* representando arquivos de vídeo
• image/* representando arquivos de imagem

mozactionhint

Especifica uma "dica de ação" usada para determinar como rotular a tecla Enter em dispositivos móveis com teclados virtuais. Os valores suportados são go, done, next, search e send; estes valores são automaticamente mapeados para o texto apropriado (maiúsculas e minúsculas não são diferenciadas).

autocapitalize

Este é um atributo não padronizado usado pelo iOS Safari Mobile que controla se e como o texto deveria ser automaticamente capitalizado conforme o usuário insere/edita. Os valores não obsoletos estão disponíveis no iOS 5 e posteriores. Os valores possíveis são:

• none: Desabilitar completamente a capitalização automática.
• sentences: Capitalizar automaticamente a primeira letra das frases.
• words: Capitalizar automaticamente a primeira letra das palavras.
• characters: Capitalizar automaticamente todas as letras.
• on: Obsoleto desde o iOS 5.
• off: Obsoleto desde o iOS 5.

autocomplete

Este atributo indica se o valor do controle pode ser completado automaticamente pelo navegador. Este atributo é ignorado se o valor do atributo type é hidden, password, checkbox, radio, file ou um tipo de botão (button, submit, reset, image). Os valores possíveis são:

• off: O usuário deve inserir explicitamente um valor neste campo a cada uso, ou o documento implementa seu próprio método de autocompletar; o navegador não completa a entrada automaticamente.
• on: O navegador pode completar automaticamente o valor baseado em valores que o usuário inseriu no passado.

Se o atributo autocomplete não está especificado num elemento <input>, o navegador usa o valor do atributo autocomplete do formulário dono do <input>. O formulário dono deste <input> é o elemento <form> que contém este <input> ou o elemento <form> cujo id é referenciado pelo atributo form do elemento <input>. Para mais informações, veja o atributo autocomplete no elemento <form>.

O atributo autocomplete também controla se o Firefox vai, ao contrário de outros navegadores, persistir o estado dinâmico de desabilitado e marcado (se aplicável) de um <input> entre carregamentos de página. A funcionalidade de persistir é habilitada por padrão. Definir o valor do atributo autocomplete para off desabilita esta funcionalidade; isto funciona mesmo quando o atributo autocomplete não se aplica ao <input> por causa de seu type. Veja Erro do Firefox 654072.

autocorrect

Este é um atributo não padronizado suportado pelo Safari que é usado para controle se a correção automática deveria ser habilitada quando o usuário entra/edita o texto do <input>. Os valores possíveis são:

• on: Habilita correção automática
• off: Desabilita correção automática

autofocus

Este atributo booleano permite que você especifique que um controle de formulário deve ter o foco de entrada de dados assim que a página carrega, a não ser que o usuário sobrescreva este comportamento digitando em um controle diferente, por exemplo. Apenas um elemento de formulário em um documento pode ter o atributo autofocus, que é booleano. Este atributo não pode ser aplicado se o atributo type estiver definido como hidden (isto é, você não pode colocar automaticamente o foco em um controle escondido).

autosave

Este atributo deve ser definido com um valor único. Se o valor do atributo