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

CKTIS / HTML

autocomplete: explicar ao navegador o significado de um campo

Descreve a finalidade do campo e distingue entrega, faturação e grupos de preenchimento.

Versão: HTML Living Standard

Sintaxe

<input name="shippingCity" autocomplete="section-order shipping address-level2">

O atributo autocomplete fornece ao navegador informações de preenchimento automático nos controlos de formulário. Aceita on, off ou uma lista ordenada de tokens que descreve o valor esperado. A lista pode começar com um grupo section-, depois shipping ou billing e uma finalidade como address-level2. Estes tokens identificam o significado; não mudam o nome do campo enviado.

Usa tokens válidos, na ordem indicada e adequados ao controlo. Um campo oculto só aceita tokens de detalhe, não as palavras gerais de ativação e desativação. Sem uma definição própria, o formulário pode fornecer a predefinição. Desativar o preenchimento não constitui uma barreira de segurança nem uma proibição fiável para gestores de palavras-passe; continuam a importar as regras do navegador e as escolhas do utilizador.

O exemplo separa as cidades de entrega e faturação, mas serializa-as sob os seus nomes de campo distintos. Atribui diretamente valores de teste sem aceder a um perfil guardado. Por isso, o teste confirma a serialização do formulário e a marcação correta dos grupos, não que todos os navegadores preencham automaticamente a mesma morada.

Exemplos

<!doctype html><meta charset="utf-8">
<form id="order">
<label>Delivery city <input name="shippingCity" autocomplete="section-order shipping address-level2"></label>
<label>Billing city <input name="billingCity" autocomplete="section-order billing address-level2"></label>
</form><output id="result"></output><script>
const form = document.querySelector('#order');
// Fixture values; this example does not access a saved autofill profile.
form.elements.shippingCity.value = 'Paris';
form.elements.billingCity.value = 'Berlin';
document.querySelector('#result').textContent = JSON.stringify(Object.fromEntries(new FormData(form)));
</script>

Resultado

{"shippingCity":"Paris","billingCity":"Berlin"}

As duas cidades vêm dos dados de teste; não são usadas moradas guardadas nem um perfil pessoal do navegador.

Fontes