本文主要以 vue-cli3 搭建的项目为例, 来聊一下如何在项目中更优雅的使用 svg .
众所周知, vue-cli3 已经推出很长一段时间了, 大家可以感受一下 vue-cli3 带来的零配置体验. But, 也相应带来了一些弊端, 就是如归需要修改默认的 loader 时, 会比较麻烦.
好了, 上正题, 建议看此文章之前先去看一下张旭鑫大神的 未来必热: SVG Sprite 技术介绍 , 那么我们接下来主要使用的就是上文中提到的 svg 的 use , 先上一张 vue-cli3 搭建的项目的目录, 可以看到根目录下只保留了 public/ 以及 src/ , 可以说非常干净, 大家可以自己创建一个.
在 src/components/ 下创建 SvgIcon 组件
- <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 () {
- if (this.className) {
- return 'svg-icon' + this.className
- } else {
- return 'svg-icon'
- }
- },
- },
- }
- </script>
- <style scoped>
- .svg-icon {
- width: 1em;
- height: 1em;
- vertical-align: -0.15em;
- fill: currentColor;
- overflow: hidden;
- }
- </style>
在 src/ 下创建一个 icons 目录, 目录结构如下:
svg 目录主要用于存放 svg 文件, 来看一下 index.JS 的内容, 功能就是把组件注册到全局, 方便使用:
- import Vue from 'vue'
- import SvgIcon from '@/components/SvgIcon' // svg 组件
- // 注册到全局
- Vue.component('svg-icon', SvgIcon)
- const requireAll = requireContext => requireContext.keys().map(requireContext)
- const req = require.context('./svg', false, /\.svg$/)
- requireAll(req)
当然, 如果你有自己的想法或需求, 可以单独引入, 无需非要注册到全局.
在 main.JS 中引入
这一步就没什么好说的了, 如果需要注册到全局, 需要在入口文件中引入.
好了, 接下来是最重要的一步:
修改默认的 loader :
大家可以去 vue-cli3 官网去查看具体教程, 这里我只说需要修改的 loader 以及具体的代码实现.
首先需要注意的是, 通过 vue-cli3 构建的项目可以初始化进行很多选择, 我构建的目录更多的是以 *.config.JS 的形式存在的.
在根目录下创建一个名为 vue.config.JS 文件, 接下来的操作都和它有关, 先来看一下它完整的代码:
- const path = require('path')
- function resolve (dir) {
- return path.join(__dirname, './', dir)
- }
- module.exports = {
- chainwebpack: config => {
- config.plugin('define').tap(args => {
- const argv = process.argv
- const icourt = argv[argv.indexOf('--icourt-mode') + 1]
- args[0]['process.env'].MODE = `"${icourt}"`
- return args
- })
- // svg rule loader
- const svgRule = config.module.rule('svg') // 找到 svg-loader
- svgRule.uses.clear() // 清除已有的 loader, 如果不这样做会添加在此 loader 之后
- svgRule.exclude.add(/node_modules/) // 正则匹配排除 node_modules 目录
- svgRule // 添加 svg 新的 loader 处理
- .test(/\.svg$/)
- .use('svg-sprite-loader')
- .loader('svg-sprite-loader')
- .options({
- symbolId: 'icon-[name]',
- })
- // 修改 images loader 添加 svg 处理
- const imagesRule = config.module.rule('images')
- imagesRule.exclude.add(resolve('src/icons'))
- config.module
- .rule('images')
- .test(/\.(PNG|jpe?g|gif|svg)(\?.*)?$/)
- },
- configureWebpack: {
- devServer: {
- open: true,
- // https: true,
- proxy: {
- '/user': {
- target: 'https://devadminschool.icourt.cc',
- },
- '/live': {
- target: 'https://devadminschool.icourt.cc',
- },
- },
- },
}, 全栈交流: 582735936
}
大家忽略无关紧要的代码, 重点从 svg rule loader 注释开始, 其实注释已经比较详细了, 就是获取默认的 loader 并进行相关的修改, 主要有 svg-loader , images-loader , 从 vue-cli3 基础 loader 中可以找到这两个 loader 的默认配置.
- // 默认的 svg loader...
- webpackConfig.module
- .rule('svg')
- .test(/\.(svg)(\?.*)?$/)
- .use('file-loader')
- .loader('file-loader')
- .options({
- name: genAssetSubPath('img')
- })
- // 默认的 images loader...
- webpackConfig.module
- .rule('images')
- .test(/\.(PNG|jpe?g|gif|webp)(\?.*)?$/)
- .use('url-loader')
- .loader('url-loader')
- .options(genUrlLoaderOptions('img'))
对比我一开始的代码可以看出, 我把默认的 svg loader 配置中使用的 file-loader 改为了 svg-sprite-loader , 并排除了 node_modules , 把默认的 images-loader 配置添加了 svg , 并排除了 src/icons 目录.
如何使用?
可以把设计大大给的 svg 或者从 iconfont 官网下载开源的 icon 的 svg 格式, 复制到 src/icons/svg 目录下;
点击 svg 查看源码, 修改 fill 属性, fill="currentColor" , 或者 fill="" , 如果无此属性, 就不用管, 这样做是可以让外部控制 icon 的颜色, 或随父元素的 color;
注意 svg 命名和 SvgIcon 命名一致, 看一下最终使用:
这里就会使用 src/icons/svg/go-back.svg 文件.
来源: http://www.qdfuns.com/article/51116/ee220eb2b209ce9c29e87726e99fcf78.html