使用SVG symbols建立图标系统

发布于 彦子

在实现Web项目的图标系统时,SVG是一个不错的选择。虽然使用SVG创建图标系统有多种方式。在这篇文章中,我们只看其中一种:SVG symbols。这项技术基于两个元素的使用:<symbol><use>

<symbol>元素用来对元素进行分组;它不会被直接显示,大概相当于定义一个模板,然后使用<use>元素引用并进行渲染。

我们使用Illustrator创建并导出SVG图标:

<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="24px" height="24px" viewBox="0 0 24 24">
    <path fill="#E86C60" d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
</svg>

然后将内容包裹在<symbol>元素中:

<svg>
    <symbol viewBox="0 0 24 24" id="heart">
        <path fill="#E86C60" d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
    </symbol>
</svg>

现在如果我们把这段代码插入到我们的页面中,我们会看到图标并不显示,因为要显示图标,我们还需要使用<use>元素:

<body>
    <svg style="display: none;">
        <symbol viewBox="0 0 24 24" id="heart">
            <path fill="#E86C60" d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
        </symbol>
    </svg>

    <svg>
        <use xlink:href="#heart"/> <!-- this is our visible icon -->
    </svg>
</body>

结果如下:

SVG

换句话说,就是你定义了一组图形对象(使用<symbol>元素)之后,可以使用<use>元素来对它进行无限次实例化展示。你使用xlink:href属性来指定你想要展示哪一组图标,这里,我们要展示的是id#heart<symbol>元素。

你可能注意到了我们给包裹<symbol>元素的SVG标签加了一个style="display: none;"的样式:这是因为即使<symbol>本身没有显示,但是包裹它的<svg>元素依旧会渲染并占用一些页面空间,这就是为什么我们需要隐藏svg元素。

现在我们知道了<symbol><use>元素分别是什么,以及它们是如何工作的,我们可以来建立我们的SVG sprite了。

首先,你需要准备好所有图标,每个图标放一个单独的.svg文件。然后再创建一个新的(空白的).svg文件(我把它命名为myicons.svg)。

在这个新的svg文件中,插入一个<svg>标签,然后,对于每一个你要放进去的图标,分别用一个<symbol>元素来包裹。

<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
    <symbol viewBox="0 0 24 24" id="heart">
        <path fill="#E86C60" d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
    </symbol>

    <symbol viewBox="0 0 32 32" id="arrow">
        <path fill="#0f0f0f" d="M16,0C7.2,0,0,7.2,0,16s7.2,16,16,16s16-7.2,16-16S24.8,0,16,0z M22.8,13.6l-6,8C16.6,21.9,16.3,22,16,22 s-0.6-0.1-0.8-0.4l-6-8c-0.2-0.3-0.3-0.7-0.1-1S9.6,12,10,12h12c0.4,0,0.7,0.2,0.9,0.6S23,13.3,22.8,13.6z"></path>
    </symbol>
</svg>

每个<symbol>元素都设置一个id,这个id用来在后面使用<use>的时候引用。

我们还给每个<symbol>元素指定了一个viewBox属性。这个viewBox属性定义了图标的宽高比;它包含4个值,前面2个值通常为0(但它其实是依赖于图标是如何绘制的),另外两个值分别是SVG的宽和高(如果你对于viewBox属性不熟悉,可以看看这篇关于SVG缩放的文章)。

这样你的图标不需要保持相同的宽高比,因为你可以给每个图标分别定义不同的viewBox属性。

最后一步,我们可以给每个图标添加一个<title>标签,提升它的可访问性。

<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
    <symbol viewBox="0 0 24 24" id="heart">
        <title>Heart</title>
        <path fill="#E86C60" d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
    </symbol>

    <symbol viewBox="0 0 32 32" id="arrow">
        <title>Arrow</title>
        <path fill="#0f0f0f" d="M16,0C7.2,0,0,7.2,0,16s7.2,16,16,16s16-7.2,16-16S24.8,0,16,0z M22.8,13.6l-6,8C16.6,21.9,16.3,22,16,22 s-0.6-0.1-0.8-0.4l-6-8c-0.2-0.3-0.3-0.7-0.1-1S9.6,12,10,12h12c0.4,0,0.7,0.2,0.9,0.6S23,13.3,22.8,13.6z"></path>
    </symbol>
</svg>

我们的SVG sprite现在可以投入使用了。你可以保存文件为myicons.svg,放在资源文件夹中(我通常把这个文件夹明明为img)。

接下来展示我们的图标,你需要做的就是在文档中你想要放置图标的位置插入下面这一小段:

<svg>
    <use xlink:href="img/myicons.svg#heart"/>
</svg>

就这样,so easy!

浏览器兼容性如何呢?在IE中通过<use>引用外部SVG文件的方法是不可行的,IE9以上也不行(不过,这个问题在Edge中已经解决了)。

那要如何解决呢?我们来看看两种可能的解决方案。

我们可以在文档的顶部引入SVG sprite,然后使用<use>标签引用图标:

<svg style="display: none;"> <!-- this is our svg sprite -->
    <symbol viewBox="0 0 24 24" id="heart">
        <path fill="#E86C60" d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
    </symbol>

    <symbol viewBox="0 0 32 32" id="arrow">
        <!-- ... -->
    </symbol>
</svg>

<svg>
    <use xlink:href="#heart"/> <!-- this is our visible icon -->
</svg>

注意xlink:href属性和id标识符是唯一对应的(它不能引用外部资源中的id)。

这种方法非常好用,但缺点是SVG sprite不能缓存。

我们可以使用一个polyfill;举个例子,svgxuse。这个polyfill可以根据<use>元素的引用,获取外部SVG资源中的id,而浏览器本身并不能这样做。基本远离就是,这个polyfill遍历文档中的<use>元素,然后如果它引用的是浏览器无法加载的外部SVG文件,它就在外部SVG中抓取并预置到文档中的<body>中。good!

你可以在Github repo中下载这个polyfill,在文档中引入,就ok了。

注意:SVG只在IE9以上支持;所以如果你需要支持IE8及以下的浏览器,你需要另外再写一套降级(例如,使用png图片方案)。

接下来,怎么给SVG添加样式呢?给SVG <use>元素添加样式需要一点技巧。这是因为SVG 图标引用这种方式有自己单独的DOM结构(也就是shadow DOM),CSS选择器并不能获取到,所以假设我们有如下的图标:

<svg class="icon">
    <use xlink:href="img/myicons.svg#heart"/>
</svg>

然后这样添加样式:

.icon path {
    fill: #000000;
}

是没有办法工作的。

如何解决这个问题呢?比如说你想要改变图标的填充颜色。首先,确保fill属性不是svg文件中内联定义的。所以,如果图标 sprite如下:

<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
    <symbol viewBox="0 0 24 24" id="heart">
        <title>Heart</title>
        <path fill="#E86C60" d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
    </symbol>

    <symbol viewBox="0 0 32 32" id="arrow">
        <title>Arrow</title>
        <path fill="#0f0f0f" d="M16,0C7.2,0,0,7.2,0,16s7.2,16,16,16s16-7.2,16-16S24.8,0,16,0z M22.8,13.6l-6,8C16.6,21.9,16.3,22,16,22 s-0.6-0.1-0.8-0.4l-6-8c-0.2-0.3-0.3-0.7-0.1-1S9.6,12,10,12h12c0.4,0,0.7,0.2,0.9,0.6S23,13.3,22.8,13.6z"></path>
    </symbol>
</svg>

把内联fill属性删除,如下:

<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
    <symbol viewBox="0 0 24 24" id="heart">
        <title>Heart</title>
        <path d="M17,0c-1.9,0-3.7,0.8-5,2.1C10.7,0.8,8.9,0,7,0C3.1,0,0,3.1,0,7c0,6.4,10.9,15.4,11.4,15.8 c0.2,0.2,0.4,0.2,0.6,0.2s0.4-0.1,0.6-0.2C13.1,22.4,24,13.4,24,7C24,3.1,20.9,0,17,0z"></path>
    </symbol>

    <symbol viewBox="0 0 32 32" id="arrow">
        <title>Arrow</title>
        <path d="M16,0C7.2,0,0,7.2,0,16s7.2,16,16,16s16-7.2,16-16S24.8,0,16,0z M22.8,13.6l-6,8C16.6,21.9,16.3,22,16,22 s-0.6-0.1-0.8-0.4l-6-8c-0.2-0.3-0.3-0.7-0.1-1S9.6,12,10,12h12c0.4,0,0.7,0.2,0.9,0.6S23,13.3,22.8,13.6z"></path>
    </symbol>
</svg>

然后在你的css代码中,加入:

.icon {
    fill: #00000; /* this will be your icons default color */
}

因为你没有在SVG中给path元素指定fill,所以它们会继承父级元素,即SVG的fill属性,这样你可以直接使用CSS选择器修改这个属性。

现在,如果我们只想改变一个图标的fill,怎么办呢?我们给这个图标再单独指定一个class即可:

<svg class="icon my-class-name">
    <use xlink:href="img/myicons.svg#heart"></use>
<svg>

然后使用CSS改变它的fill值:

.my-class-name {
    fill: red;
}

使用Nucleo创建SVG symbol sprite

手动创建一个SVG symbol sprite是非常麻烦的,特别是如果你有相对多的图标。Nucleo自动化SVG symbol sprites构建工具可以帮助你省下很多琐碎活。

从Nucleo的网站上,选择你想要下载图标,然后点击下载按钮。在弹出的设置窗口中,勾上‘Export as <symbol>选项,然后填写你的资源文件夹的路径(这里会为<use>元素设置一个xlink:href值);填写一个文件名(这是你的SVG sprite文件的名字)。然后点击保存。完成啦!你的sprite就可以用了。

SVG

你下载的文件夹中会包含几样东西:

  • 你的SVG sprite;
  • 一个style.css文件(在css文件夹中):它包含基本的SVG样式(例如,你在app中设置的fill/stroke属性);你需要复制这块内容到你的样式文件中(或者作为一个额外的css文件引入);
  • 一个svgxuse.min.js文件(在js文件夹中),这是针对IE9+的polyfill;你需要在你的文档中引入这个文件,如果你希望图标在IE9+的浏览器中可以正确显示的话;
  • 最后,一个demo.html文件。

基本上,这个demo文件列出了所有你下载的图标,你可以直接在你的文档中引入它们:点击你想要引入的图标,它就会选中你需要复制的代码片段,然后在你的文档中粘贴即可。

SVG

图标也会按照你在Nucleo app中设置的样式显示。

怎么给单个图标添加样式呢?你可以给图标指定一个class

<svg class="nc-icon grid-32 glyph my-class-name">
    <use xlink:href="img/myicons.svg#double-left"/>
</svg>

然后在CSS中修改:

.my-class-name {
    color: purple;
}

OK。但是,Nucleo图标是双色的....如果我想改变的是其中的第二种颜色的?这也好办,加上:

.my-class-name use {
    color: orange;
}

OK啦。

我们的symbols有一些额外的技巧。

  • 我们的内联图标有可定制的stroke。如果你想要改变某个图标的stroke-width属性呢?假设你下载的图标stroke-width2px,那么stroke-2类会自动添加到SVG元素上。如果你想要把stroke切换为3px,只需要把stroke-2类改为stroke-3类就可以啦。
  • 那如何让图标和文本对齐呢?在demo文件中,在顶部,可以选择‘align to text’;然后复制SVG片段并粘贴到你的文档中(感谢Cloud Four提供的'align to text'样式)。 注意,在这里,SVG会继承文本的颜色;但是,你同样可以使用一个自定义类,给它添加自定义样式,和前面一样。
  • 如果你更倾向于在文档中引入SVG sprite(而不是作为一个外部的SVG文件引用),不要勾选'Reference external SVG'选项(在demo文件的顶部);这会自动将xlink;href属性设置为和<symbol>的唯一标识符id相等的名字。

使用SVG symbols真的是管理图标的非常智能的方法;这是为什么我们在Nucleo中加入了'symbol export'功能。

使用Nucleo管理图标也是非常方便的,即使你手头有多个项目:你需要做的只是创建一个项目,添加你需要的图标,然后点击几下,下载即可。

本文根据@Claudia Romano的《How to create an icon system using SVG symbols》所译,整个译文带有我们自己的理解与思想,如果译得不好或有不对之处还请同行朋友指点。如需转载此译文,需注明英文出处:https://nucleoapp.com/how-to-create-an-icon-system-using-svg-symbols/

彦子

在校学生,本科计算机专业。逗比一枚,热爱前端热爱生活,喜欢CSS喜欢JavaScript喜欢SVG,爱玩PS玩AI玩啊逗比的软件。努力向上,厚积薄发。

如需转载,烦请注明出处:https://www.fedev.cn/svg/how-to-create-an-icon-system-using-svg-symbols.htmlCULTURE KINGS PARRAMATTA IS NOW HERE!