Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

inputmode — uma indicação do método de introdução

O atributo global inputmode sugere ao navegador um método de introdução, geralmente a disposição de um teclado no ecrã. Não restringe os caracteres nem substitui o tipo do campo ou a validação.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

inputmode="none|text|tel|url|email|numeric|decimal|search"

inputmode é um atributo enumerado que sugere um método de introdução adequado. Pode ser usado em controlos como input e textarea, bem como em conteúdo editável que use contenteditable. É uma indicação, não uma garantia de um teclado específico.

Valores disponíveis: none sugere que não seja apresentado um teclado virtual; text — texto segundo as definições regionais do utilizador; tel — introdução de números de telefone com algarismos, # e *; url — URLs; email — endereços de e-mail; numeric — algarismos, por exemplo, para um PIN; decimal — números fracionários com um separador específico das definições regionais; search — pesquisa. numeric e decimal não são intercambiáveis.

inputmode não valida os dados nem bloqueia letras. type determina o tipo de controlo, enquanto autocomplete descreve o significado dos dados para o preenchimento automático. Um identificador com zeros à esquerda pode continuar a ser um campo type="text" com inputmode="numeric". Defina as regras de validade separadamente.

Se o atributo for omitido ou o seu estado não for suportado, o navegador deverá escolher um teclado com base no contexto, como type e pattern. A propriedade DOM inputMode reflete o atributo e limita a leitura a valores conhecidos. O exemplo apresenta numeric e 0072; o aspeto do teclado depende do dispositivo e do navegador.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>inputmode demo</title>
<label for="code">Code</label>
<input id="code" type="text" inputmode="numeric" value="0072">
<pre id="result"></pre>
<script>
  const field = document.getElementById('code');
  document.getElementById('result').textContent =
    `${field.inputMode}\n${field.value}`;
</script>
</html>

Resultado

numeric
0072

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes