gulp-md-svgstore
This is a fork of gulp-svgstore with refactoring to support Angular Material.
Combine svg files into one with <svg>
elements.
Create a Material 2 compatible sprite sheet
to use with Material's addSvgIconSetInNamespace
, see Material 2 demo
Options:
The following options are set automatically based on file data:
keepIds
— keeps theid
attribute of the svg file. If noid
is provide, the filename is used as anid
.outputFilename
— file name of the result file. IfoutputFilename
is not provided,inlineSvg
— output only<svg>
element without<?xml ?>
andDOCTYPE
to use inline, default:false
.
If your workflow is different, please use gulp-rename
to rename sources or result.
A filename
attribute is added to each child svg
to see which file the child came from. This is only for developer reference, and has no functional value.
Install
npm install gulp-md-svgstore --save-dev
Usage
The following script will combine all svg sources into single svg file with <svg>
elements.
The name of result svg is the base directory name of the first file src.svg
.
Additionally pass through gulp-svgmin to minify svg and ensure unique ids.
var gulp = ;var svgstore = ;var svgmin = ;var path = ; gulp;
With the above configuration the files in test/src
:
file: ic_home_24px.svg
file: ic_settings_24px.svg
Will product the result core-icon-set.svg
:
Inlining svgstore result into html body
To inline combined svg into html body I suggest using gulp-inject. The following gulp task will inject svg into
In your html file (using visuallyhidden
from html5-boilerplate to fix the gradients):
<!-- inject:svg --><!-- endinject -->
In your gulp tasks:
var gulp = ;var svgstore = ;var inject = ; gulp;
Generating id attributes
Id of symbol element is calculated from file name. You cannot pass files with the same name, because id should be unique.
If you need to add prefix to each id, please use gulp-rename
:
var gulp = ;var rename = ;var svgstore = ; gulp;
If you need to have nested directories that may have files with the same name, please
use gulp-rename
. The following example will concatenate relative path with the name of the file,
e.g. src/svg/one/two/three/circle.svg
becomes one-two-three-circle
.
var gulp = ;var path = ;var rename = ;var svgstore = ; gulp;
Using svg as external file
There is a problem with <use xlink:href="external.svg#icon-name">
in Internet Explorer,
so you should either inline everything into body with a
simple script like this or
polyfill with svg4everybody.
PNG sprite fallback for unsupported browsers
gulp-svgfallback is a gulp plugin that generates png sprite and css file with background offsets from svg sources. Please check it and leave feedback.
Transform svg sources or combined svg
To transform either svg sources or combined svg you may pipe your files through gulp-cheerio.
Transform svg sources
An example below removes all fill attributes from svg sources before combining them.
Please note that you have to set xmlMode: true
to parse svgs as xml file.
var gulp = ;var svgstore = ;var cheerio = ; gulp
Transform combined svg
The following example sets style="display:none"
on the combined svg:
(beware if you use gradients and masks, display:none breaks those and just show
nothing, best method is to use the method show above )
var gulp = ;var svgstore = ;var cheerio = ; gulp;
Extracting metadata from combined svg
You can extract data with cheerio.
The following example extracts viewBox and id from each symbol in combined svg.
var gulp = ;var gutil = ;var svgstore = ;var through2 = ;var cheerio = ; gulp;
Possible rendering issues with Clipping Paths in SVG
If you're running into issues with SVGs not rendering correctly in some browsers (see issue #47), the issue might be that clipping paths might not have been properly intersected in the SVG file. There are currently two ways of fixing this issue:
Correcting the Clipping Path in the SVG
If you have the source file, simply converting the clipping path to a nice coded shape will fix this issue. Select the object, open up the Pathfinder panel, and click the Intersect icon.
Editing the SVG Code
If you don't have the source file or an SVG Editor (Adobe Illustrator etc.), you can manually edit the SVG code in the file. Wrapping the <clipPath>
into a <defs>
will fix this issue. Here's an example:
<defs>
<path d="M28.4 30.5l5.3 5c0-.1 7-6.9 7-6.9l-4-6.8-8.3 8.7z" id="a"/>
</defs>
<clipPath id="b"><use overflow="visible" xlink:href="#a"/></clipPath>
Becomes:
<defs>
<path d="M28.4 30.5l5.3 5c0-.1 7-6.9 7-6.9l-4-6.8-8.3 8.7z" id="a"/>
<clipPath id="b"><use overflow="visible" xlink:href="#a"/></clipPath>
</defs>
Or you can go further and reduce the size by removing the <use>
element, like this:
<defs>
<clipPath id="b"><path d="M28.4 30.5l5.3 5c0-.1 7-6.9 7-6.9l-4-6.8-8.3 8.7z"/></clipPath>
</defs>
Changelog
-
6.1.0
- Copy preserveAspectRatio attribute from source svg to to symbol #76
-
6.0.0
- Removed cache of the cheerio object #61
-
5.0.5
- Correctly set namespaces of the combined svg
-
5.0.4
- Skip null and invalid files
-
5.0.3
- Updated readme with a way to ensure unique ids
-
5.0.2
- Updated direct dependencies
-
5.0.1
- Removed cheerio from devDependencies #34
-
5.0.0
- Removed prefix and fileName options
-
4.0.3
- Ensure unique file names
- Improved readme with gulp-rename usage to generate id for nested directories
-
4.0.1
- Added cheerio to devDependencies
-
4.0.0
- Removed
transformSvg
, pipe files through gulp-cheerio instead. - Made cheerio 0.* a peer dependency, allows to choose what version to use.
- Uses
file.cheerio
if cached in gulp file object and also sets it for the combined svg. - Improved readme.
- Removed
-
3.0.0
- Used cheerio instead of libxmljs (changes transformSvg syntax)
-
2.0.0
- Added check for inputs before generating SVG.
-
1.0.1
- Added check for missing viewBox in original svg.
-
1.0.0
- Initial release.