Els comentaris s'utilitzen en CSS (Fulls d'estil en cascada) per afegir aclariments o recordatoris al codi que el navegador ignora quan representa la pàgina web. Els comentaris es poden utilitzar per explicar el vostre codi CSS, donar context a altres desenvolupadors o a vosaltres mateixos i desactivar temporalment fragments de codi específics sense eliminar-los completament.

Els comentaris CSS s'escriuen entre /* i */. Aquí teniu un exemple:

 /* This is a CSS comment */ 

Els comentaris poden aparèixer en una o diverses línies:

 /* This is a multi-line CSS comment */ /* This is another multi-line comment */ /* This is a single-line CSS comment */ 

Qualsevol part del codi CSS, com ara selectors, declaracions de propietat o blocs, pot contenir comentaris:

 /* This is a comment inside a selector */ h1 { /* This is a comment within a property declaration */ color: blue; font-size: 24px; /* This is a comment after a property */ } /* This is a comment before a block */ /* h2 { color: red; } */ 

Com ja s'ha esmentat, els comentaris són ignorats pel navegador i no tenen cap impacte en com es representa la pàgina web. Només estan presents per a l'organització del codi i la llegibilitat humana. Utilitzeu els comentaris per aclarir seccions complicades, explicar el raonament darrere de regles CSS específiques o donar instruccions per als propers canvis.

NOTA: els comentaris encara són visibles per a qualsevol persona que miri el codi font de la pàgina. Per tant, absteniu-vos d'incloure informació delicada o privada als comentaris.

Per què fem servir els comentaris en CSS?

Hi ha diversos usos per als comentaris CSS, com ara:

Documentació:Els comentaris CSS s'utilitzen per proporcionar documentació. Us permeten explicar per què s'utilitzen determinats estils, donar instruccions o notes a altres programadors que puguin treballar a la base de codi, o fins i tot recordar-vos idees o seccions específiques del codi. El vostre codi CSS és més fàcil de llegir i mantenir quan s'utilitzen comentaris.Codi d'inhabilitació temporal:El codi CSS es pot desactivar temporalment sense eliminar-lo mitjançant els comentaris. Això pot ser útil quan s'aïllen components CSS específics per provar diferents opcions d'estil o resoldre un problema. Comenteu-lo per veure com afecta el codi a la pàgina web sense eliminar-la.Col·laboració:Els comentaris ajuden els desenvolupadors a treballar junts. Quan es treballa en grup, els comentaris es poden utilitzar per compartir idees, oferir suggeriments o discutir segments de codi CSS específics. Faciliten la capacitat dels membres de l'equip per comprendre i avaluar el treball dels altres.Referència futura:Quan reviseu el codi en el futur, els comentaris us ajuden a recordar l'objectiu o la justificació d'estils concrets. Donen context, que us pot ajudar a fer ajustos o solucionar problemes i estalviar-vos temps.Organització i llegibilitat:Podeu utilitzar els comentaris per dividir el vostre codi CSS en seccions lògiques o per emfatitzar passatges crítics. Fan que el vostre codi CSS sigui més llegible i ben organitzat, facilitant la navegació i la comprensió.

El vostre codi CSS serà més fàcil de llegir, mantenir i col·laborar-hi si feu servir els comentaris de manera eficaç. Són una eina d'organització i documentació crucial per al codi.

Inconvenients dels comentaris CSS

Tot i que els comentaris CSS tenen molts avantatges, però també tenen diversos inconvenients, com ara:

Codi Bloat:Els comentaris addicionals o innecessaris poden augmentar la mida del fitxer del vostre codi CSS. És possible que les velocitats de la xarxa modernes no es vegin afectades significativament, però encara poden provocar temps de càrrega més lents, especialment per a fitxers CSS grans.Comentaris obsolets:A mesura que el codi es desenvolupa i canvia amb el temps, els comentaris poden quedar antics o deixar de descriure amb precisió l'estat del codi tal com està actualment. Els comentaris obsolets poden ser enganyosos i causar confusió o suposicions errònies quan es treballa amb la base de codi.Costos de manteniment:Mantenir els comentaris requereix temps i esforç. Els desenvolupadors han d'assegurar-se que els comentaris són actuals i pertinents quan es fan canvis al codi.Desordre potencial del codi:L'organització o l'excés de comentaris poden provocar que el codi es desordena, dificultant la lectura i la comprensió. Pot ser difícil separar la informació important del soroll si els comentaris estan mal estructurats o formatats o tenen massa comentaris innecessaris.Duplicació de codi:Quan s'explica un codi evident als comentaris, pot provocar una duplicació innecessària i disminuir la concisió del codi. Idealment, els comentaris haurien d'oferir informació addicional o justificacions que han de ser més evidents a partir del codi.