Kaskaadstiililehtedele (CSS) kommentaaride lisamine

Iga veebisait koosneb struktuurilistest, funktsionaalsetest ja stiililistest elementidest. Kaskaadiga stiililehed dikteerida veebisaidi välimus ("välimus ja tunne"). Need stiilid hoitakse HTML-struktuurist eraldi, et hõlbustada ajakohastamist ja veebistandarditest kinnipidamist.

Stiililehtede probleem

Tänu paljude veebisaitide suurusele ja keerukusele võivad stiililehed muutuda üsna pikaks ja tülikaks. See probleem on nüüdseks muutunud keerulisemaks meediapäringud eest tundlikud veebisaidi stiilid on disaini oluline osa, tagades, et veebisait näeb seadmest olenemata välja selline, nagu peaks. Ainuüksi need meediumipäringud võivad CSS-i dokumendile lisada märkimisväärse hulga uusi stiile, muutes sellega töötamise veelgi raskemaks. Selle keerukuse haldamine on koht, kus CSS-i kommentaarid võivad saada hindamatuks abiks veebisaitide kujundajatele ja arendajatele.

Kommentaarid lisavad struktuuri ja selguse

Kommentaaride lisamine veebisaidi CSS-failidesse korraldab selle koodi jaotised inimese lugeja jaoks, kes dokumendi üle vaatab. See tagab ka järjepidevuse, kui üks veebiprofessionaal jätkab tegevust seal, kus teine ​​pooleli jääb, või kui saidil töötavad inimeste meeskonnad.

instagram viewer

Hästi vormistatud kommentaarid edastavad stiililehe olulisi aspekte meeskonna liikmetele, kes ei pruugi koodiga tuttavad olla. Need kommentaarid on kasulikud ka inimestele, kes on saidil varem töötanud, kuid pole hiljuti seda teinud; veebidisainerid töötavad tavaliselt paljudel saitidel ja disainistrateegiaid ühelt teisele meenutamine on keeruline.

Ainult spetsialistide silmadele

CSS-i kommentaare ei kuvata lehe renderdamisel veebibrauserid. Need kommentaarid on ainult informatiivsed HTML-i kommentaarid on (kuigi süntaks on erinev). Need CSS-i kommentaarid ei mõjuta mingil viisil saidi visuaalset kuvamist.

CSS-i kommentaaride lisamine

CSS-i kommentaari lisamine on üsna lihtne. Lisage oma kommentaar õigete algus- ja sulgemissiltidega:

Alustage oma kommentaari lisamisega /* ja sulgege see */.

Kõik, mis nende kahe sildi vahel ilmub, on kommentaari sisu, mis on nähtav ainult koodis ja mida brauser ei renderdanud.

CSS-i kommentaar võib võtta suvalise arvu ridu. Siin on kaks näidet:

/ * punase äärise näide * /
div # border_red {
äär: õhuke ühtlane punane;
}
/***************************
****************************
Kooditeksti stiil
****************************
***************************/

Jaotiste väljamurdmine

Paljud disainerid korraldavad stiililehti väikeste, kergesti seeditavate tükkidena, mida on lugemisel lihtne skannida. Tavaliselt näete kommentaare, millele eelnevad ja järgnevad sidekriipsud, mis loovad lehele suured ja ilmsed katkestused, mida on lihtne näha. Siin on näide:

/ * Päise stiilid * /

Need kommentaarid näitavad uue kodeerimisjao algust.

Kommenteerimiskood

Kuna kommentaarimärgendid käskivad brauseril eirata kõike nende vahel, saate neid kasutada CSS-koodi teatud osade ajutiseks keelamiseks. See trikk võib olla kasulik silumise ajal või veebilehe vormingu kohandamisel. Tegelikult kasutavad disainerid neid sageli koodivaldkondade "kommenteerimiseks" või "välja lülitamiseks", et näha, mis juhtub, kui see jaotis pole lehe osa.

Lisage avakommentaarimärgend enne koodi, mida soovite kommenteerida (keelake); asetage sulgemismärk sinna, kus soovite, et keelatud osa lõppeks. Miski nende siltide vahel ei mõjuta saidi visuaalset kuvamist, mis aitab teil CSS-i siluda, et näha, kus probleem toimub. Seejärel võite minna sisse ja parandada just selle tõrke ning seejärel eemaldada kommentaarid koodist.

CSS-i kommenteerimisnõuanded

Paljud kooderid sisaldavad kommentaariplokke kõigi koodiga failide ülaosas. Jäljendage seda strateegiat, lisades abiks kommentaariploki koos oma nime, asjakohaste kuupäevade ja seotud teabega inimesed mõistavad projekti konteksti ja mitte ainult otsuseid selle kohta, mis konkreetse koodi suhtes toimub blokeerida.