欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

CSS的注釋部分編程引申

segmentfault   發(fā)布時(shí)間：2015-08-25 19:15:04   作者：Noodles001   我要評(píng)論
這篇文章主要介紹了CSS的注釋部分編程引申,包括對(duì)注釋風(fēng)格的一些建議以有利于團(tuán)隊(duì)協(xié)作編程,需要的朋友可以參考下

CSS注釋

就像HTML教程中描述的一樣,在CSS文檔中注釋也起到很重要的作用,可以幫助我們記起CSS的含義,加載在HTML文檔的位置等.

CSS注釋的開(kāi)始使用/*,結(jié)束使用*/

CSS注釋語(yǔ)法

CSS Code復(fù)制內(nèi)容到剪貼板
  1. /* 注釋內(nèi)容 */  
  2. 示例   
  3.   
  4. /* ----------文字樣式開(kāi)始---------- */  
  5. /* 夢(mèng)之都白色12象素文字 */  
  6. .dreamduwhite12px  
  7. {   
  8.  color:white;   
  9.  font-size:12px;   
  10. }   
  11.   
  12. /* 夢(mèng)之都黑色16象素文字 */  
  13. .dreamdublack16px  
  14. {   
  15.  color:black;   
  16.  font-size:16px;   
  17. }   
  18. /* ----------文字樣式結(jié)束---------- */  

風(fēng)格建議
我使用行寬不超過(guò) 80 字節(jié)的文檔塊風(fēng)格注釋：

CSS Code復(fù)制內(nèi)容到剪貼板
  1. /**  
  2.  * This is a docBlock style comment  
  3.  *   
  4.  * This is a longer description of the comment, describing the code in more  
  5.  * detail. We limit these lines to a maximum of 80 characters in length.  
  6.  *   
  7.  * We can have markup in the comments, and are encouraged to do so:  
  8.  *   
  9.    <div class=foo>  
  10.        <p>Lorem</p>  
  11.    </div>  
  12.  *   
  13.  * We do not prefix lines of code with an asterisk as to do so would inhibit  
  14.  * copy and paste.  
  15.  */  
  16.   
  17.   
  18. /**  
  19.  * 這是一個(gè)文檔塊（DocBlock）風(fēng)格的注釋。  
  20.  *  
  21.  * 這里開(kāi)始是描述更詳細(xì)、篇幅更長(zhǎng)的注釋正文。當(dāng)然，我們要把行寬控制在 80 字節(jié)以內(nèi)。  
  22.  *  
  23.  * 我們可以在注釋中嵌入 HTML 標(biāo)記，而且這也是個(gè)不錯(cuò)的辦法：  
  24.  *  
  25.     <div class=foo>  
  26.         <p>Lorem</p>  
  27.     </div>  
  28.  *  
  29.  * 如果是注釋內(nèi)嵌的標(biāo)記的話，在它前面不加星號(hào)，以免被復(fù)制進(jìn)去。  
  30.  */  

在注釋中應(yīng)當(dāng)盡量詳細(xì)描述代碼，因?yàn)閷?duì)你來(lái)說(shuō)清晰易懂的內(nèi)容對(duì)其他人可能并非如此。每寫(xiě)一部分代碼就要專門(mén)寫(xiě)注釋以詳解。

注釋的拓展用法

注釋有許多很高級(jí)的用法，例如：

準(zhǔn)修飾選擇器（Quasi-qualified selectors）
代碼標(biāo)簽
繼承標(biāo)記
準(zhǔn)修飾選擇器（Quasi-qualified selectors）

你應(yīng)當(dāng)避免過(guò)分修飾選擇器，例如如果你能寫(xiě) .nav{} 就盡量不要寫(xiě) ul.nav{}。過(guò)分修飾選擇器將影響性能，影響 class 復(fù)用性，增加選擇器私有度。這些都是你應(yīng)當(dāng)竭力避免的。

不過(guò)有時(shí)你可能希望告訴其他開(kāi)發(fā)者 class 的使用范圍。以 .product-page 為例，這個(gè) class 看起來(lái)像是一個(gè)根容器，可能是 html 或者 body 元素，但是僅憑 .product-page 則無(wú)法判斷。

我們可以在選擇器前加上準(zhǔn)修飾（即將前面的類型選擇器注釋掉）來(lái)描述我們規(guī)劃的 class 作用范圍：

CSS Code復(fù)制內(nèi)容到剪貼板
  1. /*html*/.product-page{}  

這樣我們就能準(zhǔn)確獲知該 class 的作用范圍而不會(huì)影響復(fù)用性。

其它例子如：

CSS Code復(fù)制內(nèi)容到剪貼板
  1. /*ol*/.breadcrumb{}   
  2. /*p*/.intro{}   
  3. /*ul*/.image-thumbs{}  

這樣我們就能在不影響代碼私有度的前提下獲知 class 作用范圍。

代碼標(biāo)簽

如果你寫(xiě)了一組新樣式的話，可以在它上面加上標(biāo)簽，例如：

這些標(biāo)簽可以使得其他開(kāi)發(fā)者快速找到相關(guān)代碼。如果一個(gè)開(kāi)發(fā)者需要查找和列表相關(guān)的部分，他只要搜索 ^lists 就能快速定位到 .nav，.matrix 以及其它相關(guān)部分。

繼承標(biāo)記

將面向?qū)ο蟮乃悸酚糜?CSS 編寫(xiě)的話，你經(jīng)常能找到兩部分 CSS 密切相關(guān)（其一為基礎(chǔ)，其一為拓展）卻分列兩處。我們可以用繼承標(biāo)記來(lái)在原元素和繼承元素之間建立緊密聯(lián)系。這些在注釋中的寫(xiě)法如下：

在元素的基本樣式中：

CSS Code復(fù)制內(nèi)容到剪貼板
  1. /**  
  2.  * Extend `.foo` in theme.css  
  3.  */  
  4.  .foo{}  

在元素的拓展樣式中：

CSS Code復(fù)制內(nèi)容到剪貼板
  1. /**  
  2.  * Extends `.foo` in base.css  
  3.  */  
  4.  .bar{}  

這樣一來(lái)我們就能在兩塊相隔很遠(yuǎn)的代碼間建立緊密聯(lián)系。


 

相關(guān)文章

最新評(píng)論