Includerea comentariilor în codul dvs. CSS este utilă și foarte recomandată.
Fiecare site web este alcătuit din elemente structurale (care sunt dictate de HTML), precum și stilul vizual sau "aspectul" acestui site. Foi de stil cascadă (CSS) sunt ceea ce este folosit pentru a dicta aspectul vizual al unui site Web. Aceste stiluri sunt păstrate separate de structura HTML pentru a permite ușurința actualizării și respectării standardelor Web.
Cu mărimea complexității multor site-uri web de astăzi, foile de stil pot deveni rapid destul de lungi și foarte greoaie pentru a lucra cu. Acest lucru este valabil mai ales atunci când începeți să adăugați în interogări media pentru stiluri de site receptive . Numai acele interogări media pot adăuga un număr semnificativ de stiluri noi unui document CSS și chiar mai greu de colaborat cu acesta. Aici, comentariile CSS pot deveni un ajutor neprețuit pe un site Web.
Adăugarea de comentarii la fișierele CSS ale unui site web este o modalitate excelentă de a adăuga structura secțiunilor acelui cod pentru un cititor uman care examinează documentul. Este, de asemenea, o metodă minunată de a explica acele stiluri pentru un profesionist web care ar putea fi nevoit să lucreze pe site în viitor - inclusiv pe tine însuți!
În final, comentariile CSS adăugate inteligent vor face o foaie de stil mai ușor de procesat. Acest lucru este, într-adevăr, important pentru foile de stil care vor fi editate de echipe. Comentariile pot fi folosite pentru a comunica aspecte importante ale foii de stil unor diferiți membri ai echipei care nu mai cunosc deja codul. Aceste comentarii pot fi, de asemenea, foarte utile pentru persoanele care au lucrat pe site înainte, dacă se reîntorc în cod după ce au fost departe de ea de ceva timp. Am avut de multe ori de a edita un site pe care l-am construit luni sau chiar ani în urmă și având comentarii bine formatate în HTML și CSS este foarte binevenit de ajutor! Amintiți-vă, doar pentru că ați construit un site nu înseamnă că vă veți aminti de ce ați făcut lucrurile pe care le-ați făcut atunci când vă veți întoarce la acel site în viitor! Comentariile pot face intențiile dvs. clare și clare orice neînțelegeri înainte de a se întâmplă chiar.
Un lucru pe care trebuie să-l înțelegeți despre comentariile CSS este că acestea nu sunt afișate atunci când pagina se redă în browserele web. Aceste comentarii sunt doar informaționale, la fel ca și comentariile HTML (deși sintaxa este diferită între cele două). Aceste comentarii CSS nu afectează afișarea vizuală a unui site în niciun fel și sunt pur și simplu prezente în codul propriu-zis.
Adăugarea de comentarii CSS
Adăugarea unui comentariu CSS este destul de ușoară. Vă rezervați pur și simplu comentariul cu etichetele corecte de deschidere și închidere:
- Începeți comentariul adăugând / *
- Închideți comentariul adăugând * /
Orice care apare între aceste două etichete va fi conținutul comentariului, vizibil numai în cod și nu redat de browser.
Un comentariu CSS poate fi un singur rând sau poate dura mai multe linii. Iată un exemplu de linie unică:
div # border_red {margine: subțire roșu solid; } / * exemplu de margine roșie * /Și un exemplu cu mai multe linii:
/ *************************** ********************** ****** Stil pentru codul de text **************************** ************ *************** /Ștergerea secțiunilor
Una dintre modalitățile pe care le folosesc adesea comentariile CSS este de a-mi organiza foaia de stil în bucăți mai mici, mai ușor de manevrat. Îmi place să văd cu ușurință aceste secțiuni atunci când văd fișierul mai târziu. Pentru a face acest lucru, adesea adaug comentarii cu o mulțime de liniuțe în ele, astfel încât acestea să ofere pauze mari, evidente în pagină, care sunt ușor de văzut pe măsură ce derulez repede codul. Iată un exemplu:
/ * ----------------------- Stiluri de antet ----------------------- ------- * /Când văd unul dintre aceste comentarii în codul meu, știu că este începutul unei noi secțiuni a acelui document, permițându-mi să procesez și să utilizez mai ușor codul.
Comentați "& # 34; Cod
Etichetele de comentariu pot fi, de asemenea, utile în procesul actual de codificare și depanare a unei pagini. Comentariile pot fi folosite pentru a "comenta" sau pentru a "dezactiva" zonele din acel cod pentru a vedea ce se întâmplă dacă acea secțiune nu face parte din pagină.
Deci, cum funcționează acest lucru? Ei bine, deoarece etichetele de comentariu spun că browserul ignoră totul între ele, le puteți folosi pentru a dezactiva temporar anumite părți ale codului CSS. Acest lucru poate fi util la depanare sau la ajustarea formatării paginii web.
Pentru a face acest lucru, pur și simplu adăugați eticheta pentru deschiderea comentariului în locul în care doriți să se dezactiveze codul și apoi plasați eticheta de terminare unde doriți să se termine porțiunea dezactivată. Totul între aceste etichete nu va afecta afișarea vizuală a unui site, permițându-vă să depanați CSS pentru a vedea unde se poate întâmpla o problemă. Apoi puteți intra și rezolvați doar acea problemă și eliminați comentariile din cod.
CSS Comentariu sfaturi
Ca o recapitulare, iată câteva sfaturi de reținut pentru utilizarea comentariilor în CSS:
- Comentariile pot cuprinde mai multe linii.
- Comentariile pot include elemente CSS pe care nu le doriți redate de un browser, dar nu doriți să le ștergeți complet. Aceasta este o modalitate frumoasă de a depana foile de stil ale unui site web - pur și simplu asigurați-vă că eliminați stilurile neutilizate (spre deosebire de a le lăsa comentate) dacă decideți că nu aveți nevoie de ele pe site
- Folosiți comentarii ori de câte ori scrieți CSS complicat pentru a adăuga clarificări și pentru a informa dezvoltatorii viitori sau pentru tine în viitor despre lucruri importante pe care ar trebui să le cunoască. Acest lucru va salva viitorul timpului de dezvoltare pentru toți cei implicați.
- Comentariile pot include, de asemenea, informații meta cum ar fi:
- autor
- Data creării
- drepturile de autor
Performanţă
Comentariile pot fi cu siguranță de ajutor, dar trebuie să fiți conștienți de faptul că cu cât veți adăuga mai multe comentarii într-o foaie de stil, cu atât va deveni mai heftier, ceea ce va afecta viteza de descărcare și performanța site-ului. Aceasta este o preocupare reală, dar nu trebuie să ezitați să adăugați comentarii utile și legitime din teamă că performanța va suferi. Linile CSS nu adaugă o dimensiune substanțială unui document. Va trebui să adăugați TONS de linii de comentarii pentru a avea un impact semnificativ asupra dimensiunii fișierului CSS. Adăugarea unui număr de comentarii utile în CSS nu ar trebui să vă ofere un impact negativ net asupra vitezei paginii.
În cele din urmă, veți dori să găsiți echilibrul dintre comentarii utile și prea multe comentarii pentru a obține avantajele ambelor documente CSS.
Articolul original de Jennifer Krynin. Editat de Jeremy Girard pe 7/5/17