Come scrivere un commento CSS
Un commento CSS inizia con /* e finisce con */. Tutto ciò che sta in mezzo viene ignorato dal browser, che occupi una riga o venti.
Esiste solo questa sintassi. Il CSS non ha un commento separato su una riga.
Dove possono stare i commenti
Un commento può stare ovunque sia ammesso uno spazio: tra le regole, tra le dichiarazioni, dopo un valore, dentro un elenco di selettori. Funziona allo stesso modo in un file .css, in un elemento <style> e in un attributo style.
/* Buttons */
.btn, /* default */
.btn-primary { /* variant */
padding: 8px 14px; /* 8px top and bottom, 14px sides */
}
<p style="color: #16a34a; /* inline comments work too */">Hello</p>
I commenti HTML, <!-- ... -->, servono per il markup, non per il CSS. Le due sintassi sono messe a confronto nella pagina sui commenti HTML.
Commentare il codice
L'uso quotidiano dei commenti è disattivare una dichiarazione per vedere cosa fa, senza cancellarla. Racchiudila in /* */:
Cancella /* e */ attorno alla riga del bordo e compare il bordo ambra. Commentare un'intera regola funziona allo stesso modo: metti /* prima del selettore e */ dopo la parentesi graffa di chiusura.
La maggior parte degli editor lo fa per te: seleziona le righe e premi Ctrl + / (Cmd + / su macOS).
Perché // rompe il tuo CSS
// sembra un commento perché lo è in JavaScript, Sass e Less. In CSS sono solo due caratteri, e diventano parte di ciò che segue. Il browser vede allora un selettore non valido e scarta l'intera regola successiva, senza alcun messaggio di errore.
Il browser ha letto // this is NOT a comment .one come un unico selettore, non valido, quindi l'intera regola .one è stata scartata. Cambia la riga in /* this is a comment */ e lo sfondo verde ritorna.
I commenti non si annidano
Un commento finisce al primo */. Racchiudere codice che contiene già un commento fa finire in anticipo il commento esterno:
Per commentare un blocco che contiene commenti, prima togli o accorcia quelli interni.
Organizzare un foglio di stile con i commenti
I fogli di stile lunghi si leggono meglio con dei titoli di sezione. Una convenzione diffusa:
/* ==========================================
Layout
========================================== */
.page { max-width: 960px; margin: 0 auto; }
/* ------------------------------------------
Header
------------------------------------------ */
.header { padding: 16px; }
/*! License: MIT (many minifiers keep comments that start with "!") */
I commenti arrivano a ogni visitatore come parte del file e si vedono in Visualizza sorgente, quindi non metterci mai password, URL interni o note che non pubblicheresti.
Errori comuni
- Usare
//. Cancella senza avvisi la regola successiva. Usa/* */. - Annidare i commenti. Il primo
*/chiude il commento; il resto rompe la regola successiva. - Dimenticare il
*/di chiusura. Tutto ciò che segue/*, fino alla fine del foglio di stile, diventa un commento. - Usare
<!-- -->dentro il CSS. È la sintassi dei commenti HTML e non commenta il CSS. - Lasciare segreti nei commenti. Arrivano al browser insieme al foglio di stile.
Domande frequenti
Come si commenta in CSS?
Racchiudi il testo tra /* e */: /* This is a comment */. La stessa sintassi funziona per una riga o per molte, ovunque in un foglio di stile sia ammesso uno spazio.
Si può usare // per i commenti in CSS?
No. Il CSS non ha commenti su una riga. // viene letto come parte del selettore o della dichiarazione successiva, rendendoli non validi, quindi il browser scarta l'intera regola o dichiarazione. Sass, Less e preprocessori simili accettano //, ma il CSS puro no.
I commenti CSS si possono annidare?
No. Un commento finisce al primo */, quindi /* a /* b */ c */ finisce dopo b, e il c */ che avanza diventa spazzatura che rompe la regola successiva.
Qual è la scorciatoia per commentare in CSS?
Nella maggior parte degli editor di codice, VS Code compreso, Ctrl + / su Windows e Linux o Cmd + / su macOS racchiude le righe selezionate in /* */, e premendola di nuovo il commento viene tolto.
I commenti CSS influiscono sulle prestazioni?
Solo perché aggiungono byte al file. Il browser li scarta durante l'analisi. Gli strumenti di build minimizzano i fogli di stile e tolgono i commenti; molti conservano quelli che iniziano con /*!, che per convenzione si usano per le note di licenza.