yibn2008 / fast-css-loader

blazingly fast css loader for webpack

fast-css-loader

Blazingly fast css loader for webpack (about 10 times faster than css-loader when process large css files)

install

npm install fast-css-loader --save-dev

VS css-loader

fast-css-loader has higher performance when processing large css files, here is an example when process a 24200+ lines css file:

-------------------------------------
       CSS_LOADER COST: 1644 ms
  FAST_CSS_LOADER COST: 116 ms
-------------------------------------

Why faster?

fast-css-loader rewrites resolving parts of @import and url(...) with RegExp and some tricks, it's extramely faster than postcss used by css-loader.

Limitations

Compare with css-loader, fast-css-loader has these limitations:

• doesn't support sourceMap
• doesn't support minimize (you can minimize css with mini-css-extract-plugin)
• doesn't support camelCase option
• doesn't support css module

If you really need these features, just use original css-loader :)

Usage

just like css-loader:

module.exports = {
  module: {
    rules: [
      {
        test: /\.(svg|bmp|gif|png|jpe?g)$/,
        loader: require.resolve('file-loader'),
        options: {
          name: '[name].[hash:8].[ext]'
        }
      },
      {
        test: /\.css$/,
        use: [
          'style-loader',
          'fast-css-loader'   // replace you css-loader with fast-css-loader
        ]
      },
    ]
  }
}

Options

Name	Type	Default	Description
root	{String}	/	Path to resolve URLs, URLs starting with / will not be translated
url	{Boolean}	true	Enable/Disable url() handling
alias	{Object}	{}	Create aliases to import certain modules more easily
import	{Boolean}	true	Enable/Disable @import handling
importLoaders	{Number}	0	Number of loaders applied before CSS loader

The above listed options are consistent with css-loader, for more detail please refer to css-loader options

License

MIT

fast-css-loader's Issues

css-module support

I need to share variables within JSX .like this way.

:export {
  varName:"varName"
}

It need support css-module。 https://github.com/css-modules/icss

Url alias is not being resolved properly

Looks like the loader is not being able to resolve url with alias. It's trying to load a module with a duplicated url.

Instead of ../../../sprites/leagues/~sprites/leagues/[email protected]
Should be ../../../sprites/leagues/[email protected]

Resolved	Alias
../../../sprites/leagues/	~sprites/leagues/

ERROR in ./src/ui/base-styles/themes/xxx/index.scss
Module not found: Error: Can't resolve '../../../sprites/leagues/~sprites/leagues/[email protected]' in 

Btw, It's working fine with css-loader

使用element ui时报错。

Can't resolve 'fonts/element-icons.ttf'

使用css-loader 正常。

it said this.getOptions is not a function

Syntax Error: TypeError: this.getOptions is not a function

error in ./src/styles/theme/index.css