CSS 編碼規範

時間 2019-12-08
標籤 css 編碼規範欄目 CSS 简体版
原文原文鏈接
在編寫CSS時也存在一些編碼規範，平時注意這些基本的規範，可以使代碼更易閱讀和維護。css
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title></title>

    <style>

        /* 語法
        用兩個空格來代替製表符（tab） -- 這是惟一能保證在全部環境下得到一致展示的方法。
        爲選擇器分組時，將單獨的選擇器單獨放在一行。
        爲了代碼的易讀性，在每一個聲明塊的左花括號前添加一個空格。
        聲明塊的右花括號應當單獨成行。
        每條聲明語句的 : 後應該插入一個空格。
        爲了得到更準確的錯誤報告，每條聲明都應該獨佔一行。
        全部聲明語句都應當以分號結尾。最後一條聲明語句後面的分號是可選的，可是，若是省略這個分號，你的代碼可能更易出錯。
        對於以逗號分隔的屬性值，每一個逗號後面都應該插入一個空格（例如，box-shadow）。
        不要在 rgb()、rgba()、hsl()、hsla() 或 rect() 值的內部的逗號後面插入空格。這樣利於從多個屬性值（既加逗號也加空格）中區分多個顏色值（只加逗號，不加空格）。
        對於屬性值或顏色參數，省略小於 1 的小數前面的 0 （例如，.5 代替 0.5；-.5px 代替 -0.5px）。
        十六進制值應該所有小寫，例如，#fff。在掃描文檔時，小寫字符易於分辨，由於他們的形式更易於區分。
        儘可能使用簡寫形式的十六進制值，例如，用 #fff 代替 #ffffff。
        爲選擇器中的屬性添加雙引號，例如，input[type="text"]。只有在某些狀況下是可選的，可是，爲了代碼的一致性，建議都加上雙引號。
        避免爲 0 值指定單位，例如，用 margin: 0; 代替 margin: 0px;。*/

        /* Bad CSS */
        .selector, .selector-secondary, .selector[type=text] {
            padding: 15px;
            margin: 0px 0px 15px;
            background-color: rgba(0, 0, 0, 0.5);
            box-shadow: 0px 1px 2px #CCC, inset 0 1px 0 #FFFFFF
        }

        /* Good CSS */
        .selector,
        .selector-secondary,
        .selector[type="text"] {
            padding: 15px;
            margin-bottom: 15px;
            background-color: rgba(0, 0, 0, .5);
            box-shadow: 0 1px 2px #ccc, inset 0 1px 0 #fff;
        }

        /* 聲明順序
       相關的屬性聲明應當歸爲一組，並按照下面的順序排列：
       Positioning
       Box model
       Typographic
       Visual
       因爲定位（positioning）能夠從正常的文檔流中移除元素，而且還能覆蓋盒模型（box model）相關的樣式，所以排在首位。盒模型排在第二位，由於它決定了組件的尺寸和位置。
       其餘屬性只是影響組件的內部（inside）或者是不影響前兩組屬性，所以排在後面。*/

        .declaration-order {
            /* Positioning */
            position: absolute;
            top: 0;
            right: 0;
            bottom: 0;
            left: 0;
            z-index: 100;

            /* Box-model */
            display: block;
            float: right;
            width: 100px;
            height: 100px;

            /* Typography */
            font: normal 13px "Helvetica Neue", sans-serif;
            line-height: 1.5;
            color: #333;
            text-align: center;

            /* Visual */
            background-color: #f5f5f5;
            border: 1px solid #e5e5e5;
            border-radius: 3px;

            /* Misc */
            opacity: 1;
        }

    </style>

    <!-- 不要使用 @import
    與 <link> 標籤相比，@import 指令要慢不少，不光增長了額外的請求次數，還會致使不可預料的問題。替代辦法有如下幾種：
    使用多個 <link> 元素
    經過 Sass 或 Less 相似的 CSS 預處理器將多個 CSS 文件編譯爲一個文件
    經過 Rails、Jekyll 或其餘系統中提供過 CSS 文件合併功能 -->

    <!-- Use link elements -->
    <link rel="stylesheet" href="core.css">

    <!-- Avoid @imports -->
    <style>
        @import url("more.css");
    </style>

    <!-- class 命名
    class 名稱中只能出現小寫字符和破折號（dashe）（不是下劃線，也不是駝峯命名法）。破折號應當用於相關 class 的命名（相似於命名空間）（例如，.btn 和 .btn-danger）。
    避免過分任意的簡寫。.btn 表明 button，可是 .s 不能表達任何意思。
    class 名稱應當儘量短，而且意義明確。
    使用有意義的名稱。使用有組織的或目的明確的名稱，不要使用表現形式（presentational）的名稱。
    基於最近的父 class 或基本（base） class 做爲新 class 的前綴。
    使用 .js-* class 來標識行爲（與樣式相對），而且不要將這些 class 包含到 CSS 文件中。 -->

    <style>
        /* Bad example */
        .t { ... }
        .red { ... }
        .header { ... }

        /* Good example */
        .tweet { ... }
        .important { ... }
        .tweet-header { ... }
    </style>

</head>
<body>

</body>
</html>