如何在Nuxt.js中使用svg图标？以及nuxt.js与vue.js使用svg图标的区别

首先介绍一下Nuxt.js：Nuxt.js是一个基于 Vue.js的轻量级框架，可用来创建服务端渲染 (SSR) 应用，也可用于生成静态站点。

官网：https://nuxtjs.org/

使用Nuxt.js进行服务端渲染更利于SEO，这是我使用Nuxt.js的最大理由。

但是Nuxt.js的项目结构以及一些配置写法与我平常编写的vue-cli项目还是存在不少区别，所以写下这篇文章记录下在Nuxt.js中使用svg图标的过程。

去哪里找免费的svg图标资源？ 阿里巴巴矢量图标库：https://www.iconfont.cn/

首先，在nuxt中使用svg总共分为三步：

---

1.创建vue组件

首先在nuxt项目目录中的components中建立SvgIcon.vue，代码如下

<template> <svg :class="svgClass" aria-hidden="true" > <use :xlink:href="iconName" /> </svg> </template> <script> export default { name: 'SvgIcon', props: { iconClass: { type: String, required: true }, className: { type: String, default: '' } }, computed: { iconName () { return `#icon-${this.iconClass}` }, svgClass () { return this.className ? 'svg-icon ' + this.className : 'svg-icon' } } } </script> <style scoped> .svg-icon { width: 1em; height: 1em; font-size: 1.2em; vertical-align: -0.15em; fill: currentColor; overflow: hidden; } </style>

2.创建Nuxt插件文件

在项目目录下建立plugins目录，然后在其中创建icons.js文件，代码如下：

import Vue from 'vue' // 引用组件 import SvgIcon from '@/components/SvgIcon.vue' // 注册全局组件，组建名为svg-icon Vue.component('svg-icon', SvgIcon) // 引用svg图标 const requireAll = requireContext => requireContext.keys().map(requireContext) const req = require.context('@/assets/svg', true, /\.svg$/) requireAll(req)

此处注意：

// 引用项目 assets/svg 目录下的所有 .svg 文件 // 如果第二个参数为 true ，程序将会遍历 assets/svg 目录下的子目录，并引用其中的 .svg 文件 // 如果不需要遍历子目录，可设为 false const req = require.context('@/assets/svg', true, /\.svg$/)

记得在项目目录下创建assets/svg目录，这个目录将用于存放.svg文件

3.配置nuxt.config.js

此步骤用到svg-sprite-loader这个依赖，先使用npm安装：

npm install svg-sprite-loader --save-dev

接着打开nuxt.config.js，在顶部加入：

// eslint-disable-next-line nuxt/no-cjs-in-config const path = require('path')

然后修改build部分，配置webpack：

/* ** Build configuration ** See https://nuxtjs.org/api/configuration-build/ */ build: { extend (config, ctx) { // ... const svgRule = config.module.rules.find(rule => rule.test.test('.svg')) svgRule.exclude = [path.resolve(__dirname, 'assets/svg')] // Includes /icons/svg for svg-sprite-loader config.module.rules.push({ test: /\.svg$/, include: [path.resolve(__dirname, 'assets/svg')], loader: 'svg-sprite-loader', options: { symbolId: 'icon-[name]' } }) } }

最后修改plugins部分：

/* ** Plugins to load before mounting the App ** https://nuxtjs.org/guide/plugins */ plugins: [ { src: '@/plugins/icons', ssr: true } ],

大功告成。重启项目，并在assets/svg目录下放置你的.svg文件，即可在项目中引用。

引用方式：

<svg-icon icon-class="heart-fill" />

此处icon-class就是你的.svg文件名称，直接在.vue文件中调用就可以了（记得先在assets/svg目录下放好.svg图标）

---

与vue-cli项目的不同：

主要是第二步创建Nuxt插件文件和第三步配置nuxt.config.js与配置vue-cli项目时有些区别。

在vue-cli项目中，我们可以直接在main.js文件中使用Vue.component('svg-icon', SvgIcon)进行全局组件注册。

而在nuxt项目中，我们不但需要在plugins目录下建立插件文件进行组件注册，而且还需要在nuxt.config.js中的plugins配置项中添加插件文件。

是不是多了一些步骤？

在第三步配置webpack时，在vue-cli项目中我通常这么写：

vue.config.js

module.exports = { chainWebpack: config => { // svg config const svgRule = config.module.rule('assets/svg') svgRule.uses.clear() svgRule.use('svg-sprite-loader').loader('svg-sprite-loader') .options({ symbolId: 'icon-[name]' }) } }

而在nuxt.js项目中，则变成了：

nuxt.config.js

build: { extend (config, ctx) { // ... const svgRule = config.module.rules.find(rule => rule.test.test('.svg')) svgRule.exclude = [path.resolve(__dirname, 'assets/svg')] // Includes /icons/svg for svg-sprite-loader config.module.rules.push({ test: /\.svg$/, include: [path.resolve(__dirname, 'assets/svg')], loader: 'svg-sprite-loader', options: { symbolId: 'icon-[name]' } }) } }

ok，本文结束