Tag HTML <html>
A tag <html> define um documento escrito em HyperText Markup Language. Ela contém todos os elementos básicos de um documento HTML.
A tag <html> é o elemento raiz de um documento HTML — ela fica no topo da árvore do documento e envolve todos os outros elementos da página. "Raiz" significa que ela não possui elemento pai: quando o navegador analisa a página e constrói o DOM (Document Object Model, a árvore de nós criada na memória), o elemento <html> é o único nó do qual todos os outros nós descendem. Como tudo está dentro dela, a tag <html> é também onde você define atributos que afetam a página inteira, como o idioma do documento e a direção do texto.
A única coisa que pode aparecer antes de <html> é a declaração <!DOCTYPE>, que informa ao navegador qual versão de HTML o documento utiliza e o coloca em modo de padrões.
O elemento <html> possui exatamente dois filhos diretos, e eles devem aparecer nesta ordem:
- A tag
<head>, que contém metadados para o navegador e os motores de busca — as tags<title>,<link>,<script>e similares. Nada dentro de<head>é exibido diretamente na página. - A tag
<body>, que contém tudo o que o visitante realmente vê: texto, imagens, links e assim por diante.
Sempre defina o atributo lang em <html>. Ele informa ao navegador, aos motores de busca e às tecnologias assistivas em qual idioma a página está escrita. Isso melhora a indexação, ajuda os navegadores a escolherem as fontes e a renderização corretas para caracteres nacionais, e permite que leitores de tela selecionem a pronúncia e a voz adequadas.
Tag HTML <html> com o atributo "lang"
<html lang="en">O atributo lang
O valor de lang é uma tag de idioma BCP 47 — um código curto e padronizado para um idioma humano. A forma mais comum é uma subtag de idioma de duas letras (da ISO 639), opcionalmente seguida de uma subtag de região ou script separada por um hífen.
<html lang="en"> <!-- English -->
<html lang="en-US"> <!-- English, United States -->
<html lang="fr"> <!-- French -->
<html lang="de"> <!-- German -->
<html lang="zh-Hans"> <!-- Chinese, Simplified script -->
<html lang="zh-Hant"> <!-- Chinese, Traditional script -->
<html lang="ar"> <!-- Arabic -->Defina lang uma vez em <html> para declarar o idioma principal do documento. Se uma seção da página estiver em um idioma diferente, você pode substituí-lo em qualquer elemento interno (por exemplo, <p lang="fr">).
O atributo dir
O atributo dir define a direção do texto base do documento. Ele é essencial para idiomas que são lidos da direita para a esquerda, como árabe e hebraico.
| Valor | Significado |
|---|---|
ltr | Da esquerda para a direita (padrão; usado para inglês, francês, etc.) |
rtl | Da direita para a esquerda (usado para árabe, hebraico, persa) |
auto | Deixa o navegador decidir com base no conteúdo |
<html lang="ar" dir="rtl">Definir dir="rtl" em <html> inverte o alinhamento padrão da página, de modo que o texto, as barras de rolagem e muitos recursos de layout se espelhem corretamente para scripts da direita para a esquerda.
Sintaxe
A tag <html> vem em pares. Todo o conteúdo da página é escrito entre a tag de abertura <html> e a tag de fechamento </html>.
No HTML5, a tag de fechamento </html> é tecnicamente opcional — o analisador consegue inferir o fim do documento. No entanto, você deve sempre incluí-la. Um </html> explícito mantém a estrutura do documento clara, evita surpresas quando a página é processada por ferramentas e é obrigatório se a página for servida como XHTML.
Exemplo da tag HTML <html>:
Tag HTML <html>
<!DOCTYPE html>
<html lang="en">
<head>
<title>Title of the document</title>
</head>
<body>
The content of the page
</body>
</html>Edite o exemplo acima no editor e execute-o para ver o resultado no seu navegador.
Atributos
| Atributo | Valor | Descrição |
|---|---|---|
| lang | Tag de idioma BCP 47 | Declara o idioma principal do documento (por exemplo, en, fr, zh-Hans). Recomendado em todas as páginas para acessibilidade e SEO. |
| dir | ltr / rtl / auto | Define a direção do texto base. Use rtl para idiomas da direita para a esquerda, como árabe e hebraico. |
| id | texto | Atribui um identificador único ao elemento, usado principalmente como gancho para CSS ou scripts. |
| xmlns | https://www.w3.org/1999/xhtml | Namespace XML para o documento. Necessário apenas para XHTML; ignorado quando a página é servida como text/html, portanto não é necessário no HTML5. |
| manifest | URL | Apontava para um manifesto de cache de aplicativo para visualização offline. Obsoleto — removido do padrão; use service workers em vez disso. |
Os atributos lang, dir e id acima são os mais usados, e <html> também aceita o conjunto completo de Atributos Globais e Atributos de Evento.