参考:https://blog.csdn.net/qq_26373925/article/details/108405038
如何在Nuxt.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>// 使用 <svg-icon icon-class="add"></svg-icon>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'// 注册全局组件,组建名为svg-iconVue.component('svg-icon', SvgIcon)// 引用svg图标const requireAll = requireContext => requireContext.keys().map(requireContext)// 引用项目 assets/svg 目录下的所有 .svg 文件// 如果第二个参数为 true ,程序将会遍历 assets/svg 目录下的子目录,并引用其中的 .svg 文件// 如果不需要遍历子目录,可设为 falseconst req = require.context('@/icons/svg', true, /\.svg$/)requireAll(req)
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-configconst path = require('path')
然后修改build部分,配置webpack:
/*** Build configuration** See https://nuxtjs.org/api/configuration-build/*/build: {extend (config, ctx) {// todo svgconst svgRule = config.module.rules.find(rule => rule.test.test('.svg'))svgRule.exclude = [path.resolve(__dirname, 'icons/svg')]// Includes /icons/svg for svg-sprite-loaderconfig.module.rules.push({test: /\.svg$/,include: [path.resolve(__dirname, 'icons/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 }],
重启项目,在icons/svg目录下放置你的.svg文件,即可在项目中引用。
引用方式:
此处icon-class就是你的.svg文件名称,直接在.vue文件中调用就可以了(记得先在icons/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 configconst 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-loaderconfig.module.rules.push({test: /\.svg$/,include: [path.resolve(__dirname, 'assets/svg')],loader: 'svg-sprite-loader',options: {symbolId: 'icon-[name]'}})}}
