HTML semântico na prática

A tag certa entrega teclado, leitor de tela e formulários funcionando sem código extra.

6 min de leitura · Iniciante · Revisado em

Por que a tag certa importa

Uma <div> com cara de botão parece um botão, mas não se comporta como um. HTML semântico é usar o elemento que já tem o significado e o comportamento de que você precisa. O navegador entrega de graça foco pelo teclado, anúncio no leitor de tela, envio de formulário e leitura por buscadores.

Sem semântica

Parece, mas não é

Não recebe foco com Tab, não responde ao Enter e o leitor de tela anuncia só "texto".

<div class="botao" onclick="salvar()">
  Salvar
</div>

Com semântica

Funciona sozinho

Foco, Enter, Espaço e o papel "botão" já vêm prontos. Basta estilizar.

<button type="button" onclick="salvar()">
  Salvar
</button>

A estrutura de uma página

Os pontos de referência que leitores de tela listam para navegar

<header>
  <a href="/">Minha loja</a>
  <nav aria-label="Principal">…</nav>
</header>

<main>
  <h1>Tênis de corrida</h1>
  <article>
    <h2>Modelo Leve 3</h2>
    <p>…</p>
  </article>
  <aside aria-label="Filtros">…</aside>
</main>

<footer>…</footer>
<main>
O conteúdo principal. Um por página. Permite pular direto para ele.
<nav>
Um grupo de links de navegação. Com mais de um, dê um nome com aria-label.
<article>
Algo que faz sentido sozinho: um post, um produto, um comentário.
<section>
Uma parte temática com título. Sem título, prefira uma <div>.
<h1> a <h6>
Os títulos formam o sumário da página. Não pule níveis para mudar o tamanho da fonte: isso é trabalho do CSS.

Escolhas que confundem

Qual elemento usar
SituaçãoUseEvite
Leva para outra página ou âncora<a href="…"><button> com location.href
Executa uma ação na página<button type="button"><a href="#"> ou <div>
Envia um formulário<button type="submit">Clique tratado em <div>
Rótulo de campo<label for="id">Só o placeholder
Lista de itens<ul> ou <ol> com <li>Várias <div> seguidas
Dados com linhas e colunas<table> com <th>Grid de <div>
Imagem que informa<img alt="O que ela mostra">alt com "imagem de"
Imagem decorativa<img alt="">Omitir o atributo alt

Formulários que ajudam

Rótulo, dica, tipo certo e erro ligado ao campo

<label for="email">E-mail</label>
<p id="email-dica">Usaremos só para enviar o recibo.</p>
<input
  id="email"
  type="email"
  autocomplete="email"
  aria-describedby="email-dica email-erro"
  aria-invalid="true"
  required
/>
<p id="email-erro">Informe um e-mail com @.</p>
  • O type certo (email, tel, number, date) abre o teclado adequado no celular.
  • autocomplete permite que o navegador preencha nome, endereço e senha.
  • aria-describedby faz o leitor de tela ler a dica e o erro junto com o campo.
  • Agrupe opções relacionadas, como botões de rádio, em <fieldset> com <legend>.

Revisão rápida

  • A página tem um <h1> e os títulos seguem a ordem, sem pular níveis.
  • Existe um <main>, e a navegação está em <nav>.
  • Tudo que é clicável é <a> ou <button>, e funciona com Tab e Enter.
  • Todo campo tem um <label> visível.
  • Imagens têm alt descritivo, ou alt="" quando são decorativas.
  • O validador do W3C não aponta erros de estrutura.

Referências

Trilhas relacionadas