非常教程

Webpack参考手册

装载 | Loaders

less-loader

编译成 CSS。

使用 css-loader 或 raw-loader 将其转换为 JS 模块,然后使用 ExtractTextPlugin 将其提取到单独的文件中。

安装

npm install --save-dev less-loader less

越少装载机需要较少的peerDependency。因此,您可以准确控制版本。

例子

将 css-loader、style-loader 和 less-loader 链式调用,可以把所有样式立即应用于 DOM。

// webpack.config.js
module.exports = {
    ...
    module: {
        rules: [{
            test: /\.less$/,
            use: [{
                loader: "style-loader" // creates style nodes from JS strings
            }, {
                loader: "css-loader" // translates CSS into CommonJS
            }, {
                loader: "less-loader" // compiles Less to CSS
            }]
        }]
    }
};

您可以通过加载器选项将任何 Less 特定选项传递给tless-loader。请参阅 Less 文档以查看破折号中的所有可用选项。由于我们将这些选项以编程方式传递给 Less,所以您需要在这里将它们传递给 camelCase:

// webpack.config.js
module.exports = {
    ...
    module: {
        rules: [{
            test: /\.less$/,
            use: [{
                loader: "style-loader"
            }, {
                loader: "css-loader"
            }, {
                loader: "less-loader", options: {
                    strictMath: true,
                    noIeCompat: true
                }
            }]
        }]
    }
};

不幸的是,Less 不会将所有选项一对一地映射到tcamelCase。如有疑问,请检查其可执行文件并搜索破折号选项。

通常,建议使用 ExtractTextPlugin 将样式表抽取到生产中的专用文件中。这样你的样式就不依赖于 JavaScript:

const ExtractTextPlugin = require("extract-text-webpack-plugin");

const extractLess = new ExtractTextPlugin({
    filename: "[name].[contenthash].css",
    disable: process.env.NODE_ENV === "development"
});

module.exports = {
    ...
    module: {
        rules: [{
            test: /\.less$/,
            use: extractLess.extract({
                use: [{
                    loader: "css-loader"
                }, {
                    loader: "less-loader"
                }],
                // use style-loader in development
                fallback: "style-loader"
            })
        }]
    },
    plugins: [
        extractLess
    ]
};

用法

进口

从tless-loader 4开始,您现在可以选择 Less 的内置解析器和 webpackt的解析器。默认情况下,使用 webpackt的解析器。

webpack 解析器

webpack 提供了一种解析文件的高级机制。less-loader 应用一个 Less 插件,并且将所有查询参数传递给 webpack resolver。所以,你可以从 node_modules 导入你的 less 模块。只要加一个 ~ 前缀,告诉 webpack 去查询模块

@import "~bootstrap/less/bootstrap";

重要的是只使用 ~ 前缀,因为 ~/ 会解析为主目录。webpack 需要区分bootstrap〜bootstrap,因为 CSS 和 Less 文件没有用于导入相对文件的特殊语法。@import "file"@import "./file"; 写法相同

Non-Less imports

使用 webpack resolver,你可以引入任何文件类型。你只需要一个导出有效的 Less 代码的 loader。通常,你还需要设置 issuer 条件,以确保此规则仅适用于 Less 文件的导入:

// webpack.config.js
module.exports = {
    ...
    module: {
        rules: [{
            test: /\.js$/,
            issuer: /\.less$/,
            use: [{
                loader: "js-to-less-loader"
            }]
        }]
    }
};

解决方案较少

如果你指定了这个paths选项,less-loader 不会使用 webpack 的解析器。在本地文件夹中无法解析的模块将在给定的内容中进行搜索paths。这是较少'的默认行为。paths应该是一个绝对路径的数组:

// webpack.config.js
module.exports = {
    ...
    module: {
        rules: [{
            test: /\.less$/,
            use: [{
                loader: "style-loader"
            }, {
                loader: "css-loader"
            }, {
                loader: "less-loader", options: {
                    paths: [
                        path.resolve(__dirname, "node_modules")
                    ]
                }
            }]
        }]
    }
};

在这种情况下,所有的 webpack 功能,如导入 non-Less 文件或别名,当然不会起作用。

插件

为了使用插件,只需像下面这样简单设置 plugins 选项:

// webpack.config.js
const CleanCSSPlugin = require("less-plugin-clean-css");

module.exports = {
    ...
            {
                loader: "less-loader", options: {
                    plugins: [
                        new CleanCSSPlugin({ advanced: true })
                    ]
                }
            }]
    ...
};

提取样式表

使用 webpack 捆绑 CSS 具有一些很好的优点,如引用图像和带有散列URL的字体或开发中的热模块替换。另一方面,在生产中,根据 JS 执行来应用样式表不是一个好主意。渲染可能会延迟,甚至可能会看到 FOUC。因此,将它们作为最终生产版本中的单独文件通常更好。

有两种可能性从捆绑中提取样式表:

  • extract-loader(更简单,但专门用于 css-loader 的输出)
  • extract-text-webpack-plugin(更复杂,但适用于所有使用情况)

源地图

要启用 CSS 源地图,您需要将sourceMap选项传递给 less-loader 和 css-loader。你webpack.config.js应该看起来像这样:

module.exports = {
    ...
    module: {
        rules: [{
            test: /\.less$/,
            use: [{
                loader: "style-loader"
            }, {
                loader: "css-loader", options: {
                    sourceMap: true
                }
            }, {
                loader: "less-loader", options: {
                    sourceMap: true
                }
            }]
        }]
    }
};

还要检查 sourceMaps 示例。

如果您想编辑 Chrome 内部的原始 Less 文件,那么有一篇很好的博文。这篇博文是关于 Sass 的,但它也适用于 Less。

CSS 模块陷入困境

语句中有关 Less 和 CSS 模块的相关文件路径存在已知问题url(...)。请参阅此问题以获取解释。