创建、发布npm包,并且应用在项目里面

实现一个函数去监听dom宽高的变化,并且发布NPM包,然后使用到项目中

步骤

1.5W3H 八何分析法

2.如何监听dom宽高变化

3.如何用vite 打包库

4.如何发布npm

一、NPM包新建过程

查看完整目录

1.生成 package.json

复制代码
npm init

生成TS配置文件 tsconfig.json

复制代码
 npm install typescript npx tsc --init

新建vite.config.ts

复制代码
import { defineConfig } from 'vite'
//globals  umd 支持 amd cmd cjs 全局变量模式

export default defineConfig({
    build: {
        lib: {
          // Could also be a dictionary or array of multiple entry points
          entry: 'src/index.ts',
          name: 'useResize',
          // the proper extensions will be added
        //   fileName: 'my-lib',
        },
        rollupOptions: {
          // 确保外部化处理那些你不想打包进库的依赖
          external: ['vue'],
          output: {
            // 在 UMD 构建模式下为这些外部化的依赖提供一个全局变量
            globals: {
                useResize: 'useResize',
            },
          },
        },
      },
})

写功能src/index.ts

复制代码
import { App, defineComponent, onMounted } from 'vue'
 
function useResize(el: HTMLElement, callback: (cr: DOMRectReadOnly,resize:ResizeObserver) => void) {
    let resize: ResizeObserver
        resize = new ResizeObserver((entries) => {
            for (let entry of entries) {
                const cr = entry.contentRect;
                callback(cr,resize)
            }
        });
        resize.observe(el)
}
 
const install = (app: App) => {
    app.directive('resize', {
        mounted(el, binding) {
            useResize(el, binding.value)
        }
    })
}
 
useResize.install = install
 
export default useResize

新建index.d.ts 编写声明文件

复制代码
// 声明文件
declare const useResize: {
    (el: HTMLElement, callback: Function): void;
    install: (app: App) => void;
};

export default useResize

装进依赖里面devDependencies npm i vite -D 装进依赖里面devDependencies

复制代码
npm i vue -D 

编写配置

最后 打包,package.json 添加配置 require import 查找

复制代码
npm run build 

"main": "dist/v-resize-tc.umd.js",
"module": "dist/v-resize-tc.mjs",

配置哪些文件需要发布到npm

复制代码
"files": [ "dist", "index.d.ts" ],

配置版本号,每次发布需要修改

复制代码
"version": "0.0.1",

package.json完整代码

复制代码
{
  "name": "v-resize-tc",
  "version": "0.0.2",
  "description": "实现一个函数同时支持 hook 和 自定义指令 去监听dom宽高的变化",
  "main": "dist/v-resize-tc.umd.js",
  "module": "dist/v-resize-tc.mjs",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "vite build"
  },
  "author": "tangce",
  "files": [
    "dist",
    "index.d.ts"
  ],
  "license": "ISC",
  "dependencies": {
    "typescript": "^5.1.6"
  },
  "devDependencies": {
    "vite": "^4.4.4",
    "vue": "^3.3.4"
  }
}

.npmignore忽略发布

复制代码
# .npmignore
/node_modules
/src

二、发布NPM

1.注册账号

复制代码
npm adduser

2.登录账号

复制代码
npm login

3.打包

复制代码
npm run build

4.输入 发布NPM

复制代码
npm publish

常见错误情况处理-403,地址切换问题

通过安装nrm依赖包,管理和切换镜像地址:

复制代码
npm install -g nrm

安装后,输入以下指令,切换到官方源地址

复制代码
nrm use npm

发布完成后,再切换回淘宝镜像地址

复制代码
nrm use taobao

查看当前地址

复制代码
npm get registry

查看当前用户名

复制代码
npm whoam i

附上代码及截图

三、项目中使用包


引入包

复制代码
npm i v-resize-tc -D

具体使用情况

复制代码
<template>
  <a href="https://www.npmjs.com/package/v-resize-tc">https://www.npmjs.com/package/v-resize-tc</a>
  <div class="resizeBox">
    https://www.npmjs.com/package/v-resize-tc
  </div>
</template>
<script setup lang='ts'>
import useResize from 'v-resize-tc'
import { onMounted } from 'vue'
onMounted(() => {
  useResize(document.querySelector('.resizeBox') as HTMLElement, (e:any) => {
    console.log(e)
  })
})
</script>
<style scoped lang='scss'>
.resizeBox{
  width: 300px;
  height: 300px;
  border: 1px solid #ccc;
  resize: both;
  overflow: hidden;
}
</style>
相关推荐
阳树阳树33 分钟前
signal-新的状态管理模式
前端·javascript
fakaifa34 分钟前
beikeshop多商户跨境电商独立站最新版v1.6.0版本源码
前端·小程序·uni-app·php·beikeshop多商户·beikeshop跨境电商
木木黄木木1 小时前
HTML5手写签名板项目实战教程
前端·html·html5
姑苏洛言1 小时前
基于微信小程序实现幸运大转盘页面
前端
前端极客探险家1 小时前
如何实现一个支持拖拽排序的组件:React 和 Vue 版
前端·vue.js·react.js·排序算法
yanyu-yaya1 小时前
devextreme-react/scheduler 简单学习
前端·学习·react.js
limit for me1 小时前
react使用eventBus在不同模块间进行通信
前端·react.js
__不想说话__2 小时前
面试官问我React组件和state的关系,我指了指路口的红绿灯…
前端·javascript·react.js
一个小潘桃鸭2 小时前
需求:对表格操作列中的操作进行局部刷新
前端
番茄比较犟2 小时前
Combine知识点switchToLatest
前端