unplugin-imagemin
v0.5.20
Published
π¦ π¦ unplugin compression Image Compression plugin based on squoosh and sharp
Downloads
2,234
Maintainers
Readme
π¦π¦ unplugin Imagemin Picture compression
β¨β¨ Continuous iterative development in testing
β¨ : unplugin-imagemin
β : Process start with mode squoosh
β
: [test1.png] [12.39 MB] -> [102.54 KB]
β : Process start with mode squoosh
β
: [test2.png] [16.38 MB] -> [76.79 KB]
π Features
- π° Support png jpeg webp avif svg tiff Format
- π¦Ύ High Performance based on squoosh
- β¨ Multiple picture formats can be configured
- πͺ Compress the code at build time
- π Caching Mechanism Tips: TODO
- π You can convert different picture types at build time
Squoosh && Sharp && Svgo
Unplugin-imagemin supports two compression modes
Sharp The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP, GIF and AVIF images of varying dimensions.
Squoosh is an image compression web app that reduces image sizes through numerous formats. Squoosh with rust & wasm
Svgo Support compression of pictures in svg format
β¨Warning
Although squoosh has done a good job, there will be all kinds of problems in future node versions, so don't use squoosh mode for the time being.
Due to the loading problem of squoosh
, unplugin-imagmin currently only supports versions below node 18.
Due to the rapid update of vite version and squoosh stop maintenance and other unstable factors
It is recommended that mode choose sharp
.
π° Effect display
https://github.com/unplugin/unplugin-imagemin/assets/66500121/49169b22-7f5b-4cdc-b023-302003b15522
π¦ Installation
pnpm add unplugin-imagemin@latest -D
support vite and rollup.
import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
import imagemin from 'unplugin-imagemin/vite';
// https://vitejs.dev/config/
export default defineConfig({
plugins: [vue(), imagemin()],
});
iimport { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
import imagemin from 'unplugin-imagemin/vite';
import path from 'path';
// https://vitejs.dev/config/
export default defineConfig({
plugins: [
vue(),
imagemin({
// Default mode sharp. support squoosh and sharp
mode: 'squoosh',
beforeBundle: true,
// Default configuration options for compressing different pictures
compress: {
jpg: {
quality: 10,
},
jpeg: {
quality: 10,
},
png: {
quality: 10,
},
webp: {
quality: 10,
},
},
conversion: [
{ from: 'jpeg', to: 'webp' },
{ from: 'png', to: 'webp' },
{ from: 'JPG', to: 'jpeg' },
],
}),
],
});
πΈ DefaultConfiguration
Squoosh DefaultConfiguration and sharp DefaultConfiguration
DefaultConfiguration see DefaultConfiguration
Plugin property configuration see configuration
export interface PluginOptions {
/**
* @description Picture compilation and conversion
* @default []
*/
conversion?: ConversionItemType[];
/**
* @description Whether to turn on caching
* @default true
*/
cache?: boolean;
/**
* @description Cache folder directory read
* @default node_modules/unplugin-imagemin/cache
*
*/
cacheDir?: string;
/**
* @description Compilation attribute
* @default CompressTypeOptions
*/
compress?: CompressTypeOptions;
/**
* @description mode
* @default squoosh
* @description squoosh or sharp
*/
mode?: 'squoosh' | 'sharp';
/**
* @description Whether to compress before packing
* @default false
*/
beforeBundle?: boolean;
}