使用 svg-sprite-loader 批量引入 icon

简介: 使用 svg-sprite-loader 批量引入 icon

1、推荐阿里 iconfont

前端在做项目的过程中,都会频繁使用图标,记得几年前还是流行使用 CSS Sprite 雪碧图,它的好处有减少 HTTP 请求数,提高性能,节省一些流量等等,但是使用 CSS Sprite 雪碧图的方式也有一些缺点,比如图片拼接合成麻烦且耗时,后期如果需要追加小图标,则大的雪碧图维护起来比较繁琐,最好只是往下加图片,而不要更改已有图片,而且对每个需要记录每个图标的精确位置,这就会给设计师和开发人员带来不少的麻烦。


最近几年前端比较流行的是使用 iconfont 图标 symbol 引用方式,这里推荐阿里的 iconfont 矢量图标库,iconfont 有多种引入方式,其中主流的是 svg(本质就是一串xml),它的好处有很多,比如:支持多色图标了,不再受单色限制。支持像字体那样通过 font-size,color 来调整样式。矢量,缩放不失真,而且满足减少HTTP请求次数的需求。

2、使用前的一些配置

第一步:将 svg 格式的图标导入项目中,可以通过 `import svg from '@/assets/icons/home.svg'` 的方式引入,如果你的项目是 TypeScript 开发的话,在你写上面这条语句时会报错,StackOverflow 查一下,需要在 shims-vue.d.ts 文件追加声明:

declare module "*.svg" {  //防止import svg时报错
  const content: string;
  export default content;
}

如果这个时候,在 import 语句后打印 svg 会打印出一个 .svg 的文件路径,这并不是我们所需要的,还需额外的配置才行。


第二步:我们还需要使用一个 svg-sprite-loader 的东西,来加载一下 svg 图标。根据文档 安装 svg-sprite-loader 后,文档上说了需要在 webpack.config.js 文件中配置以下,但是问题是我们使用 Vue CLI 创建的项目没有这个文件,只有 vue.config.js,所以要将 webpack 的配置翻译过来,写在 vue.config.js 文件中。

const path = require('path');  //使用require报错:可改.eslintrc.js配置、可改成import、可写 eslint ignore注释
module.exports = {
  publicPath: process.env.NODE_ENV === 'production'
      ? '/charge-website/'
      : '/',
  lintOnSave: false,
  chainWebpack: config =>{
    const dir = path.resolve(__dirname, 'src/assets/icons') //svg图标的路径
    config.module //vue将webpack封装后暴露出来的config接口
        .rule('svg-sprite') //添加规则
        .test(/\.svg$/)  //匹配.svg为结尾的文件
        .include.add(dir).end() // 只包含 icons 目录的路径
        .use('svg-sprite-loader').loader('svg-sprite-loader').options({extract:false}).end()  //不需要解析成文件
        //.use('svgo-loader').loader('svgo-loader')  //删除svg中的fill填充色、npm install --dev svgo-loader一下
        //.tap(options => ({...options, plugins: [{removeAttrs: {attrs: 'fill'}}]}))  //删除svg中的fill填充色
    config.plugin('svg-sprite').use(require('svg-sprite-loader/plugin'), [{plainSprite: true}])
    config.module.rule('svg').exclude.add(dir) // 其他 svg loader 排除 icons 目录:loader 分功避免冲突
  }
}

这个时候在 import 语句后打印 svg 会打印出一个 <symbol> 标签,而且在 <body> 标签中会出现一个 <svg> 标签的东西,<svg> 内部包裹一些 <symbol> 标签,svg-sprite-loader 会给每个 <symbol> 标签都添加一个 id 属性。

3、svg 图标的引入和使用

通过上述配置,svg-sprite-loader 会把 import 引入的 svg 解析成对应的 symbol,将其插入到页面的 body 标签中的 <svg> 标签下,这时我们就可以使用 svg use 的方式对 svg 格式的图标进行使用,它就会出现在页面上了。

<!--html 部分可以直接引入-->
<svg>
    <use xlink:href="#labeL">
</svg>
<script lang="ts">
  //import svg from '@/assets/icons/home.svg'    //这样每个图标引入一次比较麻烦
  //直接引入/assets/icons目录下的所有svg图片,批量引入更加方便
  const importAll = (requireContext: __WebpackModuleApi.RequireContext) => requireContext.keys().forEach(requireContext);
  try {importAll(require.context('../assets/icons', true, /\.svg$/));} catch (error) {console.log(error);}
<script>

通过 symbol 引用方式,有的图标不能通过 color 修改颜色的解决办法,有的又可以。

<svg class="icon" aria-hidden="true" style="color:red;">
     <use xlink:href="#icon-PDF"></use>
</svg>

原因是,当从阿里图库中图标被添加至项目,如果编辑过项目图标的颜色或者图标本身是有颜色的,那么在通过symbol获取图标时会在 svg 的 path 中增加 fill 属性,导致无法更改颜色,如果需要动态修改颜色,需要从新添加该图标(本身图标无色),获取在 symbol 的 js 文件中程序删除 fill 属性。

目录
相关文章
|
JavaScript
Vue项目中background-image属性设置方法
Vue项目中background-image属性设置方法
539 0
|
10天前
|
前端开发 JavaScript
svg圆形进度条插件svg-gauge
svg-gauge是一款基于SVG的圆形进度条插件。该插件无任何依赖,可以轻松的制作出各种圆形进度条,以及圆形进度条的动画特效。
|
4月前
|
JavaScript
如何在Vue页面中引入img下的图片作为背景图。../的使用
这篇文章介绍了在Vue页面中如何引入`img`目录下的图片作为背景图,提供了两种使用相对路径的方法。第一种是使用`../assets/img/`作为路径引入图片,第二种是使用`../../assets/img/`作为路径。文章还展示了使用这些方法的代码实现和效果展示,并鼓励读者学无止境。
如何在Vue页面中引入img下的图片作为背景图。../的使用
|
5月前
|
前端开发
css图标合并——ClipPath Sprites技术
css图标合并——ClipPath Sprites技术
48 1
|
7月前
|
前端开发 JavaScript
react中img引入本地图片的方式
react中img引入本地图片的方式
287 0
|
XML 资源调度 JavaScript
使用 svg-sprite-loader、svgo-loader 优化 svg symbols
使用 svg-sprite-loader、svgo-loader 优化 svg symbols
344 0
|
7月前
|
JavaScript API
vue使用Element-plus的Image预览时样式崩乱
vue使用Element-plus的Image预览时样式崩乱
195 0
vue使用Element-plus的Image预览时样式崩乱
|
前端开发
如何引入svg并使用
如何引入svg并使用
|
资源调度 前端开发 JavaScript
4、处理css文件(css-loader加载器与mini-css-extract-plugin分离CSS文件插件)
4、处理css文件(css-loader加载器与mini-css-extract-plugin分离CSS文件插件)
231 0
|
前端开发
用CSS做一个好看的Loading加载效果
一个好看的吃豆人loading效果