Comentários HTML
Já consegue escrever títulos e parágrafos que o visitante vê. Por vezes precisa de uma nota para si ou para a equipa que não deve aparecer na página. Os comentários HTML resolvem isso. Esta lição mostra a sintaxe do comentário e quando usá-lo com cuidado.
O que é um comentário HTML?
Um comentário HTML é texto envolvido entre <!-- e -->. O navegador analisa-o como comentário e não o mostra como conteúdo visível da página. Os comentários são úteis para lembretes curtos, rótulos de secção na fonte, ou para desativar temporariamente um pedaço de markup enquanto testa.
Resposta direta
Escreva um comentário assim: <!-- a sua nota aqui -->. Tudo entre o <!-- de abertura e o --> de fecho fica no ficheiro-fonte mas não é renderizado como texto, título ou parágrafo normal para os visitantes. Abra View Source ou DevTools se precisar de confirmar que o comentário ainda está no ficheiro.
Um comentário simples
html<!-- Esta nota é só para programadores -->
<p>Este parágrafo é visível na página.</p>Ler o exemplo
- A primeira linha é um comentário — os visitantes não veem essa frase na página
- O parágrafo abaixo é conteúdo visível normal
- Ambas as linhas permanecem no ficheiro HTML ao guardar
Comentários multi-linha e ocultação temporária
Os comentários podem abranger mais de uma linha. Um uso comum de principiantes é envolver um bloco que quer desativar temporariamente, em vez de o apagar. Depois pode remover os marcadores do comentário para trazer o markup de volta. Mantenha os blocos temporários curtos para o ficheiro continuar legível.
Comentar um bloco
html<h1>Título visível</h1>
<!--
<p>Este parágrafo fica oculto enquanto testa.</p>
<p>Este também.</p>
-->
<p>Este parágrafo continua a aparecer.</p>Comentários não são segurança
Qualquer pessoa pode abrir View Source e ler os seus comentários. Não coloque palavras-passe, chaves privadas ou tokens secretos de API em comentários HTML. Comentários são para notas de desenvolvimento, não para esconder dados sensíveis.
Experimente você mesmo
- Abra o seu ficheiro de prática HTML
- Adicione um comentário curto acima de um parágrafo a explicar o objetivo
- Envolva um parágrafo num comentário multi-linha para o ocultar temporariamente
- Guarde e abra a página — confirme que só o conteúdo não comentado é visível
- Use View Source (ou o editor) para confirmar que o texto do comentário ainda está no ficheiro
Erros comuns
- Esquecer o
-->de fecho de modo que o conteúdo seguinte desaparece ou parte - Colocar palavras-passe ou segredos dentro de comentários
- Deixar blocos comentados enormes durante muito tempo em páginas de produção
- Esperar que os comentários escondam o conteúdo do View Source (não escondem)
- Usar comentários em vez de títulos ou parágrafos reais para texto do visitante
Resumo
- Comentários HTML usam
<!--e--> - O texto do comentário não é mostrado como conteúdo visível da página
- Use comentários para notas, dicas de secção ou ocultação temporária curta
- Comentários multi-linha podem envolver um bloco pequeno durante os testes
- Comentários são visíveis na fonte — nunca guarde segredos aí
- Prefira markup vivo e claro para o texto que os visitantes devem ler
🧠 Teste Seu Conhecimento
Teste Seu Conhecimento
Desafie-se com este questionário interativo e veja o quão bem você entende o tópico
📝 Instruções
- Leia cada pergunta cuidadosamente
- Selecione a melhor resposta para cada pergunta
- Você pode refazer o quiz quantas vezes quiser
- Seu progresso será mostrado no topo