Comment commenter en CSS?

Familiarisez-vous avec le code de commentaire CSS.

L'utilisation de commentaires lors de l'écriture de code CSS est utile pour vous et pour toute autre personne susceptible de travailler ou d'apprendre du code. Vous pouvez utiliser des commentaires pour expliquer des fonctions potentiellement déroutantes, empêcher rapidement l'exécution de blocs de code et créer une documentation sur les fonctionnalités et l'objectif du code. Vous n'avez pas besoin de commenter pour chaque morceau de code que vous écrivez, mais de bons commentaires peuvent aider toutes les personnes impliquées.

Pas

1
Familiarisez-vous avec le code de commentaire CSS. CSS utilise les commentaires de style "bloc de commentaires" de type C: /* - -*/. Cela permet des commentaires sur plusieurs lignes et vous pouvez rapidement l'utiliser pour désactiver des parties de votre code.
```
/* Tout ce qui se trouve entre les balises de début et de fin sera un commentaire */ 
```

2

Utilisez le commentaire dans les sections CSS de votre code. Seules les parties de votre page traitées en CSS prendront en charge les commentaires. Cela signifie qu'ils fonctionneront dans votre page de style CSS, ainsi que dans le bloc <style> de votre page HTML. Ils ne fonctionneront pas sur d'autres parties de la page HTML. Si vous devez commenter dans un bloc HTML, utilisez des commentaires HTML.

<!DOCTYPE html> <html> <head> <style> p { color: #777; /*Vous pouvez créer des commentaires à la fin des lignes */ /* Ou vous pouvez créer des commentaires entre les lignes */ font-family: "times"; } /* Vous pouvez créer des commentaires sur plusieurs lignes. Tout ce qui se trouve entre les deux balises de commentaire ne sera pas traité lors de l'affichage de la page */ </style> </head> <body> <p> Ceci est un paragraphe HTML standard. Les commentaires ci-dessus n'apparaîtront pas sur la page. </p> </body> </html>

3
Utilisez des commentaires pour empêcher l'exécution du code. L'une des utilisations les plus importantes des commentaires est d'empêcher le traitement de morceaux de code. C'est idéal pour tester les modifications et déboguer le code.
```
<style> p { couleur: #777; /* font-family: "times"; */ } /* Les balises de commentaire ci-dessus empêcheront l'application de l'attribut "font-family" */ </style> 
```
Utilisez le commentaire dans les sections CSS de votre code.
4
Utilisez des commentaires pour expliquer un morceau de code potentiellement déroutant. Vous n'avez pas besoin de commenter chaque ligne de code que vous entrez, car CSS est assez explicite, mais il est utile d'inclure des commentaires pour le code qui peuvent ne pas être immédiatement évidents à première vue. Cela aide non seulement les personnes susceptibles de collaborer ou d'apprendre de votre code, mais cela peut également vous aider à vous rappeler la fonction du code.
```
<style> img { opacité: 0,5; filtre: alpha(opacité=50); /* Pour IE6-8 */ } /* Le commentaire ci-dessus indique que le code sur cette ligne est pour Internet Explorer 6, 7 et 8 */ </style> 
```
5
Utilisez des commentaires pour créer de la documentation dans le code. Vous pouvez créer une documentation détaillée pour votre code à l'aide de commentaires CSS et d'autres caractères. Cela vous permet d'expliquer la fonction du programme et de fournir des instructions aux autres codeurs/utilisateurs. La compression CSS supprimera automatiquement cela au moment d'exécuter le code, vous n'avez donc pas à vous soucier de la longueur affectant la taille du fichier.
```
/****************************************** ************** ********************** Cela fait un bon en-tête de titre ********************* ************* ************************************* / /*========En-tête de section=========*/ /* - - - En-tête de sous-section - - - -*/ /*Ceci peut être le texte pour chacun des * pour chacun de vos paragraphes. * L'ajout d'un * au début de * chaque ligne facilite un peu * l'analyse du lecteur */ 
```
6
Utilisez un CSS non valide pour créer des commentaires temporaires sur une seule ligne. CSS n'a pas de fonction de commentaire "à une seule ligne", comme // en JavaScript. Vous pouvez cependant utiliser un CSS invalide au début d'une ligne pour empêcher le traitement de la fonction suivante. Ce n'est pas considéré comme une bonne pratique pour un débogage majeur, mais cela peut être utile en un clin d'œil.
```
<style> p { couleur: #777; XXXXfont-famille: "fois"; } /* Le "XXXX" ci-dessus empêchera le traitement de "font-family". Les hacks de code comme celui-ci ne doivent pas être laissés sur un site Web en direct, car ils pourraient potentiellement causer des problèmes au lecteur */ </style> 
```

Lisez aussi: Comment éditer des fichiers HTML?