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.