Komentarji v CSS služijo pojasnilom v kodi. Z njimi lahko opišemo posamezni del slogovne datoteke, dodamo opombo ali začasno izključimo del pravil med preizkušanjem. Komentarji se pri prikazu strani ne pokažejo, zato vplivajo na berljivost kode, ne pa na videz dokumenta.
Pomni: Komentar v CSS se začne z /* in konča z */. Enak zapis uporabljamo za kratke in daljše komentarje.
Osnovna pravila
Začetek komentarja v CSS označimo z /*, nato zapišemo komentar in ga zaključimo z */. Komentar je lahko enovrstičen ali večvrstičen. V zunanji slogovni datoteki je to standardni način zapisovanja komentarjev.
/* to je komentar */Komentarje pogosto uporabljamo za:
- opis posameznega sklopa slogov,
- lažje iskanje delov kode,
- dodajanje opomb pri kasnejšem urejanju,
- začasno izključitev določenega pravila med preizkušanjem.
Komentarjev v CSS ni mogoče gnezditi. To pomeni, da prvi zapis */, ki sledi zapisu /*, zaključi komentar.
Primerjave
Enovrstični in večvrstični komentarji
Isti zapis komentarja uporabimo tako za krajše kot za daljše opombe. Razlika je predvsem v količini besedila.
| Vrsta komentarja | Primer uporabe |
|---|---|
| enovrstični komentar | kratka opomba ob posameznem pravilu ali deklaraciji |
| večvrstični komentar | opis večjega sklopa slogov ali ločevanje delov datoteke |
Pozor: Če komentarja ne zaključimo pravilno, lahko brskalnik preostanek kode razume kot del komentarja, zato se nadaljnja pravila ne bodo pravilno uporabila.
Zgledi
Spodaj je primer komentarjev v slogovni datoteki. Prvi komentar označuje večji sklop kode, drugi komentar pa pojasnjuje posamezno deklaracijo.
/* -----------------------------
to je prvi komentar
-------------------------------*/
h1 {
text-align: center;
/* to je drugi komentar */
color: black;
font-family: Arial, sans-serif;
}Glavni naslov
Komentarji so namenjeni pojasnilom v kodi in se v prikazu strani ne vidijo. Uporabni so na primer za opis posameznega sklopa slogov ali kot opomnik pri kasnejšem urejanju datoteke CSS.
S komentarjem lahko tudi začasno izključimo del kode. To je uporabno pri preizkušanju, kadar želimo preveriti, kako se stran obnaša brez določenega pravila.
Priporočila
- Komentarje uporabljaj za označevanje pomembnih delov slogovne datoteke.
- Daljše slogovne datoteke razdeli na pregledne sklope z večvrstičnimi komentarji.
- Komentarje piši jasno in kratko, da ostane koda pregledna.
- Pred shranjevanjem preveri, ali so vsi komentarji pravilno zaključeni.
Pogoste napake
- Manjkajoč zaključek komentarja
*/. - Prepričanje, da se komentarji pokažejo tudi na spletni strani.
- Pretirana količina komentarjev, ki oteži branje kode.
- Poskus gnezdenja komentarjev znotraj komentarja.
Komentarji pomagajo pri razumevanju kode, vendar niso nadomestilo za pregledno zapisane slogovne predloge. Najbolj uporabni so takrat, ko dopolnjujejo jasno in urejeno kodo.