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

CKTIS / HTML

charset: declarar UTF-8 logo no início

Faz coincidir a codificação declarada com os bytes reais e a resposta HTTP.

Versão: HTML Living Standard

Sintaxe

<meta charset="utf-8">

Num elemento de metadados, charset declara a codificação dos caracteres do documento HTML. A marcação moderna conforme usa utf-8; coloca toda a declaração nos primeiros 1024 bytes, normalmente perto do início do cabeçalho. Usa no máximo uma declaração de metadados deste tipo e guarda o ficheiro na codificação declarada. Mudar apenas o rótulo não repara bytes codificados incorretamente.

O navegador também considera uma marca de ordem de bytes e metadados de transporte, como o charset do Content-Type HTTP. Uma declaração contraditória do servidor pode alterar a descodificação, pelo que deves configurar servidor e documento de forma coerente. Este atributo não escolhe a língua da página, não traduz texto nem fornece a declaração de codificação de um documento XML.

O ambiente de teste envia bytes UTF-8 reais sem marca de ordem de bytes nem charset HTTP. O navegador lê a declaração inicial e preserva letras acentuadas e um emoji. O script apresenta a codificação resultante e o texto do documento, tornando visíveis erros de descodificação em vez de apenas verificar o texto do atributo.

Exemplos

<!doctype html><meta charset="utf-8">
<p id="word">Zażółć 🙂</p><output id="result"></output><script>
document.querySelector('#result').textContent = document.characterSet + '; ' + document.querySelector('#word').textContent;
</script>

Resultado

UTF-8; Zażółć 🙂

A resposta HTTP de teste omite intencionalmente o charset para testar efetivamente a declaração HTML inicial.

Fontes