解决vue3使用iconpark控制台预警提示问题

前言

最近在项目中使用 iconpark-icon 来管理图标，一切都很顺利，引入链接后，图标正常显示，没有报错。但是控制台却发出了预警信息。

[Vue warn]: Failed to resolve component: iconpark-icon If this is a native custom element, make sure to exclude it from component resolution via compilerOptions.isCustomElement.

虽说不影响使用，但看着着实难受，于是研究了一下，成功解决预警提示。

解决办法

首先看一下警告内容，这个警告的意思是 Vue.js 无法找到名为 “iconpark-icon” 的组件。可能造成这个问题的原因是组件没有被正确地注册或者导入。

看完警告信息后，解决办法就很简单了，只要告诉 Vue， “iconpark-icon” 是什么或者让其忽略这个检查即可。关于这一点，iconpark 的文档中是有说明的 IconPark 图标在线链接功能使用指南。

可惜的是第一种方法经验证，无效（×）。

app.config.compilerOptions.isCustomElement = tag => tag === 'iconpark-icon';

更可惜的是，Vue3 项目，基本都是 TS + Vite 技术栈开发，所以第二种针对 webpack 的方法，依然无效（×）。不过代码先放出来，或许也有采用webpack 打包工具的。

// 如果是通过vue-cli， 在vue.config.js中配置
module.exports = {chainWebpack: config => {config.module.rule('vue').use('vue-loader').tap(options => {options.compilerOptions = options.compilerOptions || {};options.compilerOptions.isCustomElement = tag => tag === 'iconpark-icon'// modify the options...return options})}
}

到了这个时候，当然得去 Vue 官网 看看，对此有没有介绍。

果然，官网对此也是有说明的。

// 将所有标签前缀为 `ion-` 的标签视为自定义元素
app.config.compilerOptions.isCustomElement = (tag) => {return tag.startsWith('ion-')
}

不过此方法跟 iconpark 的方法一致，不适用于 vue3 + ts + vite 技术栈。所以只能再去 vite 官网看看了，但是很可惜，我并没有找到相关的描述。到此所有捷径都已经走完，只有最后的办法了，自己去解决它。

好在有 webpack 可以参照，因此解决起来并没有花费多久，只在细节上做些修改即可。

所以，真正的解决办法是：在 vite.config.ts 中添加以下代码

export default defineConfig({plugins: [vue({template: {compilerOptions: {isCustomElement: (tag) => tag.startsWith('iconpark-')}}}),],
})

只需要加上这么一块内容，即可消除警报。

END