icon-sprite-generator
v1.0.0
Published
User-friendly SVG sprite generation
Downloads
3
Readme
icon-sprite-generator
User-friendly SVG sprite generation
Features
- Promise API
- Supports glob file matching (patterns based on globby)
- SVG cleaner built-in (removes unneeded attributes and tags)
- Exports sprite on disk
- Optional wrapping with JavaScript Loader (for browsers)
Install
$ npm install icon-sprite-generator --saveUsage
const generator = require("icon-sprite-generator");
/* async/await */
(async () => {
const sprite = await generator({
output: "file.svg",
});
console.log(sprite);
})();
/* Promises */
generator({
output: "file.svg",
}).then(sprite => {
console.log(sprite);
});API
generator([options])
Returns a Promise of generated sprite.
options
Type: Object
input
Type: globby pattern (string Array)
Path/s to your directory with icons (supports multiple patterns).
output
Type: string
Default: false
Provide output path and full filename (with extension) if you want to save it on disk.
Note: Sprite will be wrapped with JS loader in case of extension equals ".js".
mode
Type: string
Default: auto
You can natively set mode to jsLoader if you want wrap sprite with JS Loader.
JS Loader
This additional option can wrap generated sprite with JavaScript code for browsers.
It inserts your sprite into DOM on DOMContentLoaded event.
You can include this file into <head>.
That's how it looks:
(function() {
var ready = false;
var inject = function() {
if (ready) { return; }
ready = true;
var svgHolder = document.createElement("div");
svgHolder.className += "svg-sprites-holder";
svgHolder.innerHTML = "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\....";
document.body.appendChild(svgHolder);
};
if (document.readyState === "complete") { inject(); }
else { document.addEventListener("DOMContentLoaded", inject); }
})();Tests
In order to test this module - run npm test
License
MIT © Denis Kalinichenko