vivian820225 / webp-convert-loader

webp-convert-loader

A webpack loader that can convert small images into base64 format and generate new webp images with the hash of the source file name. It also preserves the source image.

Features

• In development mode, a webp image with the same name will be generated in the cache.
• Supports passing the limit parameter, which limits images under 10k to be converted to base64, while images above that size will be generated as webp images with the same name.

Install

npm install --save-dev webp-convert-loader

Usage

• webpack / vue-cli2.0 configure as follows:

{
  test: /\.(png|jpe?g)(\?.*)?$/,
  use: [{
    loader: "webp-convert-loader",
    options: {
      limit: 8192,
      quality: 90,
      name: 'static/img/[name].[hash:8].[ext]'
    }
  }]
}

• vue-cli3.0 configure as follows:

module.exports = {
  chainWebpack: config => {
    const imageRule = config.module.rule('images')
    imageRule.uses.clear()
    config.module.rule('webp')
      .test(/\.(jpe?g|png)$/i)
      .use('webp-convert-loader')
      .loader('webp-convert-loader')
      .options({
        limit: 8192,
        quality: 80,
        name: `static/img/[name].[hash:8].[ext]`
      })
      .end()
  }
}

API

limit

Type: string|number
Default: 10240
Converts images under 10k to base64 by default.

quality

Type: string|number
Default: 80
The quality of the webp image generated from png or jpg.

name

Type: string
Default: [hash].[ext]
The filename and relative path of the generated webp image.

Other parameters can refer to imagemin-webp.