vite-plugin-svg-spritemap

vite-plugin-svg-spritemap

This vite plugin generates a single SVG spritemap containing multiple elements from all .svg files in a directory.

Features

• Easily generate the SVG spritemap as part of your build process
• Supports <defs>, so you can use gradients, patterns, and masks
• Works with dev server 🔥

If you find this plugin useful, why not

Installation

# using npm
npm install -D vite-plugin-svg-spritemap
# using pnpm
pnpm install -D vite-plugin-svg-spritemap
# using yarn
yarn add --dev vite-plugin-svg-spritemap

Usage

Vite config

import { svgSpritemap } from 'vite-plugin-svg-spritemap';

export default defineConfig({
  plugins: [
    svgSpritemap({
      pattern: 'src/icons/*.svg',
    }),
  ],
});

SVG element

<svg>
  <use xlink:href="/spritemap.svg#example"></use>
</svg>

React component example

export const Icon: React.FC<{ name: string }> = ({ name }) => (
  <svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <use xlinkHref={`/spritemap.svg#${name}`} />
  </svg>
);

const App = () => {
  return <Icon name="arrow" />;
};

Options

Option	Type	Description
pattern	string	A glob pattern that specifies which SVG files to include in the sprite.
prefix	string (optional)	A string that is added to the beginning of each SVG icon's ID when it is added to the sprite.
filename	string (optional)	The name of the output file that contains the SVG sprite. Default is spritemap.svg.
currentColor	boolean (optional)	Replace colors in the SVGs with the currentColor value by SVGO. Default is false.
svgo	SVGOConfig or boolean (optional)	Use SVGO for optimization. Default is true.
emit	boolean (optional)	Additionally emit the file so that other vite plugins can process it (eg. compression). Default is false.