Skip to main content

Como adicionar comentários a folhas de estilos em cascata (CSS)

#30. DIY : CROCHET BRAID , FREETRESS DEEP TWIST (Abril 2025)

#30. DIY : CROCHET BRAID , FREETRESS DEEP TWIST (Abril 2025)
Anonim

Cada site é composto de elementos estruturais (que são ditados por HTML), funcionais e estilísticos. Folhas de estilo em cascata (CSS) são usadas para ditar a aparência (a aparência e a aparência) de um site. Esses estilos são mantidos separados da estrutura HTML para permitir a atualização e a aderência aos padrões da Web.

O problema com folhas de estilo

Com o tamanho e a complexidade de muitos sites hoje, as folhas de estilo podem se tornar bastante demoradas e complicadas. Isso é especialmente verdadeiro agora que as consultas de mídia para estilos de site responsivos são uma parte essencial do design, garantindo que um site seja exibido como deveria, independentemente do dispositivo. Essas consultas de mídia podem adicionar um número significativo de novos estilos a um documento CSS, dificultando ainda mais o trabalho. É aqui que os comentários CSS podem se tornar uma ajuda inestimável para designers e desenvolvedores de sites.

Comentários Adicionar estrutura e clareza

Adicionar comentários aos arquivos CSS de um site é uma ótima maneira de organizar seções desse código para um leitor humano que está revisando o documento. Ele também garante consistência quando um profissional da web pega onde o outro deixa de fora, ou quando equipes de pessoas trabalham em um site.

Comentários bem formatados podem comunicar aspectos importantes da folha de estilo a membros de uma equipe que talvez ainda não estejam familiarizados com o código. Esses comentários também são muito úteis para pessoas que trabalharam no site antes, mas não recentemente; os web designers normalmente trabalham em muitos sites, e lembrar de estratégias de design de um para o outro é difícil.

Apenas para os olhos dos profissionais

Comentários CSS não são exibidos quando a página é renderizada em navegadores da web. Esses comentários são apenas informativos, assim como os comentários HTML (embora a sintaxe seja diferente). Esses comentários CSS não afetam a exibição visual de um site de forma alguma.

Adicionando comentários CSS

Adicionando um comentário CSS é muito fácil. Você simplesmente registra seu comentário com as tags corretas de abertura e fechamento:

  • Comece seu comentário adicionando

    /*

  • Feche seu comentário adicionando

    */

Qualquer coisa que apareça entre essas duas tags é o conteúdo do comentário, visível apenas no código e não processado pelo navegador.

Um comentário CSS pode ocupar qualquer número de linhas. Aqui estão dois exemplos:

/ * exemplo de borda vermelha * / div # border_red { borda: vermelho sólido fino; }/*******************************************************Estilo para texto de código*******************************************************/

Quebrando seções

Muitos projetistas organizam folhas de estilo em pequenos blocos facilmente digeríveis que são fáceis de digitalizar durante a leitura. Normalmente, você verá comentários precedidos e seguidos por uma série de hífens que criam intervalos grandes e óbvios na página que são fáceis de ver. Aqui está um exemplo:

/ * ----------------------- Estilos de cabeçalho ----------------------- ------- * /

Esses comentários indicam o início de uma nova seção de codificação.

Código "Comentando"

Como as tags de comentário dizem ao navegador para ignorar tudo entre elas, você pode usá-las para desativar temporariamente determinadas partes do código CSS. Isso pode ser útil ao depurar ou ao ajustar a formatação da página da Web. Na verdade, os designers costumam usá-los para "comentar" ou "desativar" áreas de código para ver o que acontece se essa seção não fizer parte da página.

Para fazer isso, basta adicionar a tag de comentário de abertura antes do código que você deseja comentar (desabilitar); coloque a tag de fechamento onde você deseja que a parte desativada termine. Nada entre essas tags afetará a exibição visual de um site, permitindo que você depure o CSS para ver onde um problema está acontecendo. Você pode, então, corrigir esse problema e remover os comentários do código.

Dicas de comentário CSS

Como recapitular, aqui estão algumas dicas para lembrar de usar comentários no seu CSS:

  1. Comentários podem abranger várias linhas.
  2. Os comentários podem incluir elementos CSS que você não deseja que um navegador processe, mas que você não deseja excluir completamente. Lembre-se de remover os estilos não usados ​​(em vez de deixá-los comentados) se você decidir que não precisa deles no site.
  3. Use comentários sempre que você escrever CSS complicado para adicionar estrutura, esclarecer decisões de design e informar futuros desenvolvedores (ou lembre-se) sobre considerações importantes. Isso economiza tempo no futuro para todos os envolvidos.
  4. Os comentários também podem incluir informações meta, como:
    1. Autor
    2. Data Criada
    3. direito autoral

atuação

Embora a adição de muitos comentários possa afetar a velocidade e o desempenho de download de um site, você não deve hesitar em usá-los. Seria preciso muitas linhas de comentários para ter um impacto negativo significativo. Como muitos aspectos do web design, tudo se resume ao equilíbrio.