Komentáre HTML (<!–?* –>) môžu zväčšovať veľkosť súboru, čo môže ovplyvniť rýchlosť načítanie stránky. Aj keď moderné siete sú rýchle, pri veľkých webových projektoch sa každé zbytočné bajty počítajú. Pri každom načítaní stránky sa HTML kód prenáša zo servera do prehliadača a ak obsahuje nadbytočné komentáre, tento proces môže byť neefektívny. Tak si dajme kávičku ☕ a poďme sa pozrieť na „moju nedeľnú kázeň“, aké sú vaše html zdroje 🔍 a čo môžete urobiť lepšie a efektívnejšie. Tento popis neobsahuje návod ako ⚙️ zakázať samotné komentáre pre články. Tých možností je veľa a pre každý web platí niečo iné. Uvádzam len dôvody, prečo je táto praktika vhodná.
Bezpečnostné riziká
Komentáre HTML v zdrojovom kóde môžu obsahovať citlivé informácie, ktoré vývojári používajú na testovanie alebo popisovanie časti kódu. Ak tieto komentáre zostanú v produkčnom kóde, môžu útočníkom odhaliť dôležité informácie o štruktúre webu, použitých technológiách alebo dokonca heslách či API kľúčoch (v prípade zlej praxe vývojára).
✅ Zbytočné zaťažovanie prehliadača
Hoci prehliadač komentáre ignoruje pri vykresľovaní stránky, stále ich musí spracovať pri analýze HTML kódu. To môže byť najmä pri veľkých stránkach neefektívne a môže viesť k zníženiu výkonnosti.
Komentáre HTML a ich alternatívy
Používanie CSS a JavaScript komentárov len v dev prostredí – Ak potrebujete komentáre, je lepšie ich umiestniť do súborov CSS a JS, ktoré prechádzajú build procesom.
Externá dokumentácia – Udržiavanie dokumentácie v samostatných súboroch alebo v systémoch ako Notion, Confluence či README.md.
Verzionovacie systémy (Git) – Vývojári môžu použiť commit správy a poznámky priamo v repozitári namiesto ukladania informácií do HTML kódu.
✅ SEO optimalizácia
Vyhľadávače analyzujú HTML 🔗 kód a môžu naraziť na zbytočné komentáre HTML. Aj keď ich neindexujú, môžu predĺžiť čas, ktorý robot potrebuje na prehľadanie stránky a tým spomaliť indexáciu dôležitého obsahu. Roboty vyhľadávačov sú limitované časovou sľučkou pre jeden web / stránku, na to netreba zabúdať. Prehliadače tieto praktiky neregistrujú, ale načítať ich musia, keďže sú súčasťou zdrojového kódu. Jednoduché prirovnanie: Urobte všetko preto, aby v zdrojovom kóde bolo čo najmenej obsahu na čítanie robotmi vyhľadávačov, ktoré nie sú potrebné a dôležité.
✅ Čitateľnosť a organizácia kódu
Niektorí vývojári používajú komentáre HTML na organizáciu kódu, no lepšou alternatívou je čistá a dobre štruktúrovaná syntax. Použitie externých dokumentácií (napríklad README súbory alebo špecifikácie v repozitári) môže byť efektívnejšie ako zanechávanie poznámok v samotnom kóde.
✅ Minimalizácia pri build procese
Moderné build nástroje, ako napríklad 🔗 Webpack, Gulp či minifikátory, často odstraňujú komentáre pri produkčných verziách kódu. Ak však vývojári nechávajú komentáre v HTML bez ich odstránenia, výsledný kód môže byť zbytočne veľký.
Prečo pluginy k WordPressu používajú komentáre
Mnohé pluginy pre WordPress využívajú komentáre HTML na rôzne účely, napríklad na detekciu ich prítomnosti na stránke alebo na označenie sekcií, ktoré dynamicky generujú obsah. Niektoré pluginy ich využívajú aj na ladenie alebo testovanie funkcionality. Hoci môžu byť užitočné pre vývojárov, v produkčnom prostredí môžu byť zbytočné a mali by byť odstránené alebo minimalizované, aby sa zabránilo možným bezpečnostným rizikám a zbytočnému nárastu veľkosti HTML kódu.
🛠️ Záver
Aj keď komentáre HTML môžu byť užitočné v dev prostredí, v produkčnej verzii stránky môžu spôsobiť viac škody ako úžitku. Ich odstránenie vedie k menšiemu a bezpečnejšiemu kódu, lepšej výkonnosti a optimalizácii pre vyhľadávače. Ak je potrebné dokumentovať kód, je vhodnejšie použiť externé nástroje namiesto priameho vkladania komentárov do HTML. V mojom prípade po zrušení komentárov som pri testoch ušetril 300ms pri načítaní webu. Aj 300ms je hodnota pre ktorú sa oplatí niečo urobiť pre zlepšenie. Nezabúdajte „každý cent sa ráta“, takže čo všetko dokážeš postupne poupravovať, je vždy dobrá práca ktorá sa oceňuje.
Pre vás pripravil Pavol Knut Navrátil