webpack專案輕鬆混用css module

我是leon發表於2018-06-08
WebCSS

前言

本文講述css-loader開啟css模組功能之後，如何與引用的npm包中樣式檔案不產生衝突。
比如antd-mobilenpm包的引入。在不做特殊處理的前提下，樣式檔案將會被轉譯成css module。

一、產生問題的原因

{ 
    test: /.css$/,
    use: [
        `style-loader`,
        {
            loader: `css-loader`,
            options: {
                modules: true,
                localIdentName: `[hash:base64:6]`
            }
        },
        `postcss-loader`
    ] 
}

以上程式碼片段，摘自webpack配置的module.rule。
可以看出wepack在編譯過程中，遇到.css結尾的檔案，都會交由postcss-loader、css-loader和style-loader依次處理。
因為css-loader開啟了css模組功能，所以，所有經過處理的css檔案，類名都將被改變。

二、初步改進

使用exclude和include進行區分

1.node_module資料夾內的檔案，避免被當前rule處理

{ 
    test: /.css$/,
    use: [
        {
            loader: `style-loader`
        }，
        {
            loader: `css-loader`,
            options: {
                modules: true,
                localIdentName: `[hash:base64:6]`
            }
        },
        {
            loader: `postcss-loader`
        }
    ],
    exclude:[path.resolve(__dirname, `..`, `node_modules`)]
}

如上所示，將node_module資料夾內的檔案，用exclude排除在外，不用當前rule進行處理。

2.單獨處理node_module內的css檔案

{ 
    test: /.css$/,
    use: [
        {
            loader: `style-loader`
        },
        {
            loader: `css-loader`
        },
        {
            loader: `postcss-loader`
        }
    ],
    include:[path.resolve(__dirname, `..`, `node_modules`)]
}

三、升級版，支援css module模式和普通模式混用

1.用檔名區分兩種模式

  • *.global.css 普通模式
  • *.css css module模式

這裡統一用 global 關鍵詞進行識別。

2.用正規表示式匹配檔案

// css module
{ 
    test: new RegExp(`^(?!.*\.global).*\.css`),
    use: [
        {
            loader: `style-loader`
        }，
        {
            loader: `css-loader`,
            options: {
                modules: true,
                localIdentName: `[hash:base64:6]`
            }
        },
        {
            loader: `postcss-loader`
        }
    ],
    exclude:[path.resolve(__dirname, `..`, `node_modules`)]
}

// 普通模式
{ 
    test: new RegExp(`^(.*\.global).*\.css`),
    use: [
        {
            loader: `style-loader`
        }，
        {
            loader: `css-loader`,
        },
        {
            loader: `postcss-loader`
        }
    ],
    exclude:[path.resolve(__dirname, `..`, `node_modules`)]
}

四、其他問題

less在使用css module時，對url的解析存在衝突，可以用resolve-url-loader進行解決，直接上程式碼：


test: /.less/,
use: [
    {
        loader: "style-loader"
    },
    {
        loader: "css-loader", 
        options: {
            sourceMap: true,
            importLoaders: 2
        }
    },
    {
        loader: "postcss-loader", 
        options: {
            sourceMap: true
        }
    },
    {
        loader: "resolve-url-loader", 
        options: {
            sourceMap: true
        }
    },
    {
        loader: "less-loader", 
        options: {
            sourceMap: true
        }
    }
]

參考

[1] Updated README regarding relative filepaths issue #121

相關文章