Aprenda como comentar no HTML e em outras linguagens

Os comentários no HTML são usados para explicar o que o código faz ou para deixar notas sobre o que precisa ser feito. Conheça mais detalhes

Está desenvolvendo códigos e quer saber como comentar no HTML? Que tal aprender agora?

Se você está aqui é porque tem uma noção de programação, ainda assim, antes de explicarmos como comentar no HTML, é fundamental que fique claro que os comentários são linhas que não fazem parte de um programa, mas são utilizados para fornecer informações dos códigos para os programadores, de maneira “oculta”.

Tecnicamente, os comentários no HTML são usados para explicar o que o código faz, ou servem para deixar notas sobre a programação. Geralmente, os comentários são escritos em uma linha separada do código, começando com um caractere de comentário especial que indica que a linha contém uma informação.

Para que você entenda melhora o que é e como comentar no HTML, continue essa leitura e aproveite nossas dicas.

O que é HTML?

Tecnicamente, o HTML é uma linguagem de marcação usada para criar páginas na Internet. Ele permite que os desenvolvedores criem páginas com texto, imagens, vídeos e outros conteúdos. Além disso, os desenvolvedores também podem criar links para outras páginas e para arquivos em outros sites.

O que são comentários HTML?

Os comentários em HTML são códigos que não são exibidos na página Web, mas são úteis para a organização do código-fonte. Eles ajudam a documentar o código, para que outras, além do desenvolvedor criador, possam entendê-lo. Além disso, esse tipo de comentário não afeta em nada o funcionamento do script.

A prática serve para deixar uma nota para você mesmo ou para outros desenvolvedores. Geralmente, são pontos de atenção ou informações importantes, especialmente quando o código é complexo.

Sem bug na cabeça e no código

Apesar de os comentários no HTML serem muito uteis, é importante ter cuidado com a quantidade e o tipo de comentários incluídos no código.

Comentários muito longos e detalhados, assim como marcações repetitivas e irrelevantes, podem tornar um código simples em algo complexo.

Ademais, é importante lembrar que comentários no HTML não se tornam parte do código, por isso, quando for preciso modificar um código-fonte, não basta somente comentar no HTML, é necessário atualizar o código.

<Confira: saiba tudo sobre Internet das Coisas />

Como incluir comentários no HTML?

Entenda que incluir comentários no HTML não é um bicho de sete cabeças. Para isso, basta usar a tag de comentário, que pode ser de linha única:

<!-- comentário -->

Ou de várias linhas:

<!--

Insira aqui

O conteúdo

Que deseja

-->

Viu como é simples?

Além de HTMLs, onde mais é possível incluir comentários?

Comentários podem ser inseridos em qualquer linguagem de programação e em algumas linguagens de marcação.

Em síntese, as linguagens de programação mais populares permitem que os comentários sejam inseridos no código usando um caractere ou uma série de caracteres especiais. Logo, cada uma tem sua sintaxe própria.

JavaScript

JavaScript é uma linguagem de programação interpretada que foi originalmente criada com o nome Mocha, depois foi renomeada para LiveScript e, finalmente, JavaScript.

Ela é usada principalmente para criar páginas web interativas e dinâmicas.

Existem dois tipos de comentários no JavaScript. Saiba como fazer abaixo:

Insira na linha apenas duas barras //, assim:

// Comentário de uma linha

Ou

Para várias linhas, use /* e */, veja abaixo:

/* Comentário

 De

 Múltiplas

 linhas */


CSS

O CSS é o acrônimo para Cascading Style Sheets, que em português significa Folha de Estilo em Cascata. É um formato usado para definir a formatação e o layout de um documento HTML ou XML. Ou seja, ele é responsável pelo estilo da página.

Ele é um dos pilares da Web semântica, pois permite que o conteúdo seja separado da forma. Isso facilita a manutenção e a reutilização do código, além de tornar as páginas mais acessíveis e de melhorar a experiência do usuário.

Então, como fazer? Para incluir comentários no css basta utilizar o símbolo de /* antes do comentário e */ após o comentário.

Ficará bem assim:

/* insira aqui algum comentário sobre o conteúdo */

PHP

O PHP é uma linguagem de programação de script open source de alto nível, muito utilizada, principalmente, para o desenvolvimento web e pode ser embutida em HTML.

Para incluir comentários no código php, utilize os caracteres // para um comentário de uma linha ou /* … */ para um comentário de múltiplas linhas.

Exemplo:

// Comentário de uma linha

ou

/* Comentário

 De

 várias linhas */ ?>

 Dicas na hora de fazer comentários no HTML

Boas práticas são fundamentais ao desenvolver e ajustar um código. Confira abaixo algumas dicas para você aplicar!

  1. Sempre utilize as tags de comentário corretamente;
  2. Evite comentar códigos que já estejam bem explicados;
  3. Sinalizou um erro no código e já foi consertado? Retire imediatamente para não confundir os especialistas;
  4. Seja conciso e objetivo nos seus comentários, pois pode interferir no tamanho final do documento (em bits);
  5. Utilize a linguagem de comentário correta para o seu projeto;
  6. Evite brincadeira nos comentários, seja profissional.

Área de desenvolvimento

Você sabia que o desenvolvedor pode trabalhar em diversos setores? Desde o desenvolvimento de software para computadores até a criação de aplicativos para celulares. Ele também pode atuar como analista de sistemas, desenvolvendo e implantando projetos de tecnologia da informação.

Desenvolvedores no Brasil enfrentam um mercado de trabalho cada vez mais competitivo. A demanda por profissionais qualificados está crescendo, enquanto o número de pessoas formadas nas áreas de TI não acompanha o ritmo. Como resultado, os salários estão cada vez mais altos e as empresas estão cada vez mais exigentes com os candidatos.

Para se destacar, os desenvolvedores precisam ter um bom conhecimento técnico, além de experiência na área. As habilidades de comunicação e colaboração também são cada vez mais valorizadas, já que muitos projetos envolvem equipes multidisciplinares.

Quer aprofundar seus conhecimentos na área? Participe da DEV SUMMIT! Um evento online e gratuito para você aprender sobre tecnologias, ferramentas e práticas na área de desenvolvimento de software.

Ah, você ainda ganhará um certificado de graça! Garanta sua vaga!

Conheça a assinatura Multi Mais e tenha acesso imediato aos cursos e bootcamps oferecidos pela XP Educação!


spot_img

Continue Aprendendo

spot_img