当前位置：首页 > article >正文

vite+vue3发布自己的npm组件+工具函数

article 2025/1/17 4:06:38

记录一下个人最近一次发布npm组件的过程：

一、创建组件和工具函数

执行命令创建一个空项目： npm create vite 创建过程稍微有些慢，不知何故？其中选择vue , 个人暂时使用的JS 。
在 src 目录下面创建一个文件 package 存放组件和公共的JS方法

案例中 table 是放组件的， utils 是放方法的。
table组件里面的主要内容就是个人业务组件，随便写点

<template>
  <input type="text" v-model="MyValue">
  <div>
    结果：{{ MyValue }}
  </div>
  <button @click="handelEvent"> 测试按钮 </button>
</template>

<script setup>
import { ref } from "vue";
const MyValue = ref("");
const emit = defineEmits(["testBtn"]);
const handelEvent = () => {
  emit("testBtn", MyValue.value);
};
</script>

<script>
export default {
  name: "eosBtn",
};
</script>

这里遇到一个疑问，组件名称的暴露：必须通过下面的方式。

export default {
  name: "eosBtn",
};

我最开始用的组合式api 直接暴露的，竟然无法使用，如有知道原因的，还请赐教一下。

<script setup name="eosBtn"> </script>

函数方法，utils文件也随便写一个：

// indes.js
import { handleFirstUpperCase } from "./utils.js";
export default { handleFirstUpperCase };


// utils.js
/* 
* 首字母转大写
*/
export function handleFirstUpperCase(str) {
    return str.replace(/( |^)[a-z]/g, (L) => L.toUpperCase());
}

开始暴露出去组件和方法，在package 下的index.js 写

import eosBtn from './table/index.vue'
import EUtils from './utils/index.js'

const components = [eosBtn]
const install = function (Vue) {
    components.map(el => {
        Vue.component(el.name, el) // 注册组件
    })
}
export default { install, EUtils }

本地自测，还是在当前的项目下，在main.js 里面引入和注册组件以及方法

import { createApp } from 'vue'
import './style.css'
import App from './App.vue'
import testUi from './package/index.js'
const app = createApp(App)

app.config.globalProperties.EUtils = testUi.EUtils; //公共方法
console.log(testUi);
app.use(testUi.install)
app.mount('#app')

在app.vue 中使用组件进行测试

<template>
  <eosBtn @testBtn="testBtn" />
</template>

<script setup>
import { getCurrentInstance, ref, defineComponent } from "vue";
const { proxy } = getCurrentInstance();
const testBtn = (val) => {
  console.log(proxy.EUtils.handleFirstUpperCase(val));
};
</script>

二、发布组件

设置包的名称，版本，导出路径等相关信息，在package.json

{
  "name": "eos-tms-base",
  "private": false,
  "version": "0.0.5",
  "type": "module",
  "files": [
    "dist/*",
    "eos-tms-base.d.js"
  ],
  "main": "dist/eos-tms-base.umd.js",
  "module": "dist/eos-tms-base.es.js",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  },
  "dependencies": {
    "vue": "^3.3.11"
  },
  "devDependencies": {
    "@vitejs/plugin-vue": "^4.5.2",
    "vite": "^5.0.8"
  }
}

设置vite.config.js

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

// https://vitejs.dev/config/   https://juejin.cn/post/7257144279050403896
export default defineConfig({
  plugins: [vue()],
  build: {
    rollupOptions: {
      // 请确保外部化那些你的库中不需要的依赖
      external: ['vue'],
      output: {
        // 在 UMD 构建模式下为这些外部化的依赖提供一个全局变量
        globals: {
          vue: 'Vue',
        },
      },
    },
    lib: {
      entry: 'src/package/index.js',
      name: 'eos-tms-base',
      fileName: (format) => `eos-tms-base.${format}.js`,
    },
  },
})