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

CKTIS / HTML

enterkeyhint: o rótulo do Enter virtual

Descreva a ação prevista sem tratar o rótulo como implementação.

Versão: HTML Living Standard

Sintaxe

<input type="search" enterkeyhint="search">

O atributo global enterkeyhint sugere um rótulo ou ícone para Enter em teclados virtuais. Os valores definidos são enter, done, go, next, previous, search e send. Se faltar ou não for suportado, o navegador escolhe pelo contexto. O aspeto depende da plataforma e do método de introdução.

Não é um processador de eventos, algoritmo de foco nem ordem de envio. Implemente a ação pelo comportamento do formulário ou por código, mantendo um controlo acessível. É separado da disposição dos caracteres. Uma tecla física não tem de mudar a inscrição.

O exemplo rotula Enter num campo de pesquisa e trata explicitamente o envio. Uma pressão real entrega o valor ao processador sem navegação. O teste verifica o formulário, não o ícone mostrado num teclado móvel.

Exemplos

<!doctype html><meta charset="utf-8">
<form id="form"><label>Find <input id="query" type="search" name="q" enterkeyhint="search" value="HTML"></label><button>Search</button></form><output id="result"></output>
<script>
document.querySelector('#form').addEventListener('submit', event => {
  event.preventDefault();
  document.querySelector('#result').textContent = 'submitted=' + new FormData(event.currentTarget).get('q');
});
// Focus the field and press Enter. The form handler implements the action.
</script>

Resultado

submitted=HTML

O teste usa um evento de tecla física; não afirma qual será o aspeto do teclado móvel.

Fontes