vue封装svg组件和iconfont文件引入

本文介绍如何在Vue项目中封装SVG图标为组件,并实现全局调用。通过安装svg-sprite-loader插件并配置webpack,创建SVG图标文件夹结构,编写SvgIcon组件,最终达到便捷管理和使用的SVG图标。

封装SVG格式的图片,vue分装成组件步骤如下

1.安装 svg-sprite-loader 插件,运行以下命令:

  npm i svg-sprite-loader -D

2. webpack4.0版本中的配置:在vue.config.js chainWebpack添加配置

 chainWebpack: (config) => {
        config.resolve.alias
            .set('@', resolve('./src'))
            .set('components', resolve('./src/components'))
        //set第一个参数:设置的别名,第二个参数:设置的路径
        // set svg-sprite-loader
        config.module
            .rule('svg')
            .exclude.add(resolve('src/assets/icons'))
            .end()
        config.module
            .rule('icons')
            .test(/\.svg$/)
            .include.add(resolve('src/assets/icons'))
            .end()
            .use('svg-sprite-loader')
            .loader('svg-sprite-loader')
            .options({
                symbolId: 'icon-[name]'
            })
            .end()
    },

3.在 src/assets 目录新建一个 icons 文件夹,里面放三个内容:1)、 存放 .svg 文件的 svg文件夹 ; 2)、 全局注册组件的 index.js 文件 ;3)、svgo.yml 文件。

  • src/assets/icons/index.js --index.js文件
//index.js文件

import Vue from 'vue'
import SvgIcon from '@/components/SvgIcon'// svg component

// register globally
Vue.component('svg-icon', SvgIcon)

const req = require.context('./svg', false, /\.svg$/)
const requireAll = requireContext => requireContext.keys().map(requireContext)
requireAll(req)

 

  • src/assets/icons/svgo.yml --svgo.yml文件
# replace default config

# multipass: true
# full: true

plugins:

  # - name
  #
  # or:
  # - name: false
  # - name: true
  #
  # or:
  # - name:
  #     param1: 1
  #     param2: 2

- removeAttrs:
    attrs:
      - 'fill'
      - 'fill-rule'
  • 测试的svg文件 share.svg(svg文件可以去iconfont上面查找,复制你要的svg格式的代码)
<svg t="1610951706747" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="2532" width="200" height="200"><path d="M896 469.333333l-298.666667-298.666667 0 170.666667C298.666667 384 170.666667 597.333333 128 810.666667c106.666667-149.333333 256-217.6 469.333333-217.6L597.333333 768 896 469.333333z"></path></svg>

4.新建SvgIcon组件

目录:src/components/SvgIcon/index.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() {
      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>

5.全局注册svgIcon组件

import '@/assets/icons'

6.使用范例:在使用的地方直接写

<svg-icon icon-class="share" />

 

### 如何在 Vue3 项目中统一管理 Iconfont 文件Vue3 项目中,为了实现对 `iconfont` 文件的高效管理便捷使用,可以采用以下方式: #### 1. **安装依赖** 确保已经安装了 `axios` 其他可能需要用到的工具库。如果尚未配置 `iconfont`,可以通过阿里云图标库下载对应的字体文件并将其集成到项目中。 #### 2. **全局注册 SVG 图标组件** 通过将所有的 `SVG` 图标打包成一个通用模块来简化其调用过程。以下是具体实现方法: - 创建一个新的目录用于存储所有导入的 `SVG` 资源,比如命名为 `src/icons/svg/`。 ```javascript // src/icons/index.js import { createApp } from 'vue'; import SvgIcon from './SvgIcon.vue'; // 自定义的 svg 组件 export function setupIcons(app) { app.component('SvgIcon', SvgIcon); } ``` 在此基础上构建一个动态加载机制以便于支持按需加载特定图标而无需一次性全部引入。 #### 3. **编写自定义 SVG 组件** 利用 Vue3 的组合 API 架构设计灵活可重用的小型组件作为基础单元处理单个矢量图形展示逻辑。 ```html <!-- src/icons/SvgIcon.vue --> <template> <svg :class="['icon', className]" aria-hidden="true"> <use :xlink:href="symbolId"></use> </svg> </template> <script lang="ts"> import { computed, defineComponent } from 'vue'; export default defineComponent({ props: { name: String, className: String, }, setup(props){ const symbolId = computed(() => `#${props.name}`); return { symbolId }; } }); </script> ``` 此部分代码片段展示了如何创建一个简单的封装版 `<svg>` 元素允许传入不同的属性来自由定制显示效果[^2]。 #### 4. **优化 Webpack 或 Vite 配置以支持自动注入 Symbol Sprites** 为了让开发者能够更加方便快捷地操作各种类型的图片素材,在构建阶段完成对其路径映射关系建立至关重要。这里推荐两种主流前端工程化解决方案——Webpack/Vite 来达成目标。 ##### 使用 Webpack 实现自动化流程 修改项目的 webpack.config.js 添加如下插件设置项: ```javascript const glob = require("glob"); const path = require("path"); module.exports = { chainWebpack(config) { config.module.rule('icons') .test(/\.svg$/) .include.add(path.resolve(__dirname,'./src/icons')) .end() .use('svgo-loader').loader('svgo-loader').tap(options=>{ options.plugins.push({removeTitle:true}) return options; }).end(); const icons = glob.sync('./src/icons/*.svg'); config.plugin('define').tap(args=>[ Object.assign({},args[0],{ __ICONS__:JSON.stringify(icons.map(iconPath=> iconPath.replace(/^.*\/([^/]*)\.svg$/, '$1'))) }) ]); } }; ``` 上述脚本实现了两件事:一是针对匹配规则下的 `.svg` 文件应用 svgo loader 去除不必要的 metadata;二是收集当前工作区内的所有可用图标名称列表并通过环境变量暴露给运行时访问[^3]。 ##### 利用 Vite 提升效率 对于现代快速迭代的应用场景来说,Vite 可能是一个更好的选择因为它提供了更快冷启动速度以及热更新能力。只需简单调整 vite.config.ts 即可获得相似的功能特性。 ```typescript import { defineConfig } from 'vite' import vue from '@vitejs/plugin-vue' export default defineConfig({ plugins: [ vue(), { name: 'custom-icons', transformIndexHtml(html) { let content = ''; const files = await this.globImport(new URL('./src/icons/*.svg', import.meta.url)); for(const file of Object.keys(files)){ const fileName = file.split('/').pop().replace('.svg',''); content += `<symbol id="${fileName}" viewBox="0 0 1024 1024">${files[file].default}</symbol>`; } return html.replace('</svg>',`${content}</svg>`); } } ] }) ``` 这段 TypeScript 定义了一个名为 custom-icons 的插件,该插件会在 HTML 文档结束前插入一组预先准备好的 symbols 数据块[^4]。 #### 5. **实际运用案例分析** 最后给出一段完整的路由配置实例说明前面提到的技术要点是如何结合起来发挥作用的。 ```javascript { path:'/example', component:Layout, redirect:'/example/list', meta:{title:'示例页面',icon:'file-text'}, children:[ { path:'list',name:'ExampleList',component:()=>import('@/views/example/List.vue'), meta:{title:'列表视图'} },{ path:'detail/:id?',name:'ExampleDetail',component:()=>import('@/views/example/Detail.vue'), meta:{title:'详情页'} } ] } [^5] ``` 以上即是在 Vue3 中实施集中式管理方案的一个完整指南,涵盖了从初始设定直至最终部署各个环节的关键要素。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

时光机上敲代码

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值