IT数码 购物 网址 头条 软件 日历 阅读 图书馆
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
图片批量下载器
↓批量下载图片,美女图库↓
图片自动播放器
↓图片自动播放器↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁
 
   -> JavaScript知识库 -> 如何写一个vue组件发布到npm,包教包会,保姆级教学 -> 正文阅读

[JavaScript知识库]如何写一个vue组件发布到npm,包教包会,保姆级教学

前言——必读

因为本章内容主要是说明如何将组件发布到npm的步骤,所以创建的组件相当简单。如果是涉及到基于其他的组件库创建的组件发布,请看到第六部分拓展。另外,前两个部分属于前情回顾,回忆如何创建一个简单组件并且进行局部注册和使用。如果对这部分知识已经掌握的朋友,请直接跳到第三部分,从安装vue-sfc-rollup开始进行学习。

1. 前情回顾——创建一个vue项目

(1)使用vue create 项目名称命令创建一个基础的vue项目,因为是比较简单的演示,所以选择Default配置即可。如果下载创建项目经常遇到audit fix提示,可以查看下自己的npm下载地址,最近官方下载地址总是出错,可以直接切换到淘宝镜像。
在这里插入图片描述
(2)使用vscode运行项目npm run serve
在这里插入图片描述
(3)删除原始组件及其引用代码
在这里插入图片描述
在这里插入图片描述

2. 本地尝试——创建组件

(1)创建vue-link组件。

<template>
  <a :href="link">{{text}}</a>
</template>

<script>
export default {
  props:{
    link:{
      type:String,
      default:''
    },
    text:{
      type:String,
      default:''
    }
  }
}
</script>

(2)在App.vue中引入使用。

在这里插入图片描述
(3)尝试效果,点击跳转到了link所指向的网址。
在这里插入图片描述

3. 正式开始——安装vue-sfc-rollup

在github上搜索vue-sfc-rollup,可以看到它的说明和使用方式。这是目前创建npm上可用的vue组件最快的方式,使用该工具生成组件项目后,最快时改动一个组件文件,进行打包后即可上传到npm上。
(1)全局安装

npm install -g vue-sfc-rollup

必须全局安装,局部安装试过了,会报错。
(2)使用sfc初始化之后要上传的组件项目

sfc-init

在这里插入图片描述
(2)运行项目
打开使用sfc-init命令创建的组件项目,npm i下载node_modules,npm run serve运行
在这里插入图片描述
(3)读懂sfc-init的项目
可以看到serve命令执行的是dev/serve.js文件,但是包的入口文件dist/vue-link.ssr.js文件,不难看出这是最后要进行打包之后上传的文件。这个暂且不提,让我们把注意力放到serve.js文件上,发现这是一个小型的vue项目,并且只用到vue-link.vue一个模板组件,这就是我们需要修改替换的组件文件。
在这里插入图片描述
在这里插入图片描述

4. 修改项目并完成组件的npm发布

(1)替换组件
将之前本地尝试创建的组件代码直接替换到当前sfc-init创建的项目中,看下效果。
在这里插入图片描述
在这里插入图片描述
到这一步,我们的组件就完成了。
(2)打包组件项目
打包之前,建议将将要发布的版本修改为最小,并且将name中加上你独有的标志,比如我在后面加上的-sheldon,防止和npm上已经有的包重名,否则有可能因为重名而上传失败。
在这里插入图片描述

然后,执行npm run build,生成之前提到过的打包后的入口文件。
在这里插入图片描述

(3)发布组件到npm
需要注意的是,之前我们把项目的npm地址换成了淘宝镜像,现在发布自己的组件需要切换到官网,注意,现在地址需要使用https,否则会报错。

npm config set registry https://registry.npmjs.org/

在这里插入图片描述
最后使用npm publish命令,即可成功上传组件。
在这里插入图片描述
在这里插入图片描述

5. 验证——下载组件并使用

(1)重新打开之前的link-demo项目或者自己新建一个vue项目,把npm地址重新切回到淘宝镜像(淘宝镜像10分钟更新一次,有时候还没更新,等等就行),避免不必要的报错

npm config set registry http://registry.npm.taobao.org/

(2)下载组件npm i vue-link-sheldon
(3)使用组件
在这里插入图片描述
在这里插入图片描述

6. 拓展——如何写一个基于element-ui的组件

本来想把这个单独写成一篇文章进行发布的,但是发现根本没有任何技术难度,只需要看懂package.json,并将UI组件按需引入即可。
(1)读懂package.json
在这里插入图片描述
关注点放到项目的依赖项上,给大家简单介绍下dependencies、devDependencies和peerDependencies。前两个大家都基本了解,dependencies——运行依赖,比如axios,无论开发时,还是运行时都需要;devDependencies——开发依赖,比如less和sass,只是对css进行语法分析,在项目进行线上部署的时候并不会存在,只有在开发时出于方便用得到;而peerDependencies——对等依赖,这个是只有作为npm包作者时才会了解到的。

我们在进行npm包创建和发布的时候,难免会引用到其他已经发布的npm包。按照我们最开始的认知,如果一个项目引用包,就需要使用npm i 包名命令将包放进该项目的node_modules文件夹下。但是,这样问题就来了,假设你是Element-UI或者其他任何包的作者,你在进行创作开发时,希望在当前的node_modules文件夹下引用到Vue(因为基于Vue),但是在我们进行发布的时候,又不希望依赖中有Vue了,因为别人在下载我Element-UI的时候,肯定已经下载了Vue了,如果在Element-UI中又有Vue,不是一堆冗余文件了吗?所以,我能不能当Element-UI作为包下载的时候,能够直接引用外部同级的node_modules下的Vue包呢?当然可以,peerDependencies就是这样的作用。
在这里插入图片描述
总结一下,dependencies是开发时在,运行时也在的依赖;devDependencies开发时在,运行时就扔掉的依赖;peerDependencies是开发时在,运行时就去找同级的依赖。

(2)在sfc项目中使用Element-UI
其实无论是Element-UI还是Ant Design Vue,都是一样的做法。把他们当成和Vue一样的对等依赖peerDependencies,考虑到写css方便些,把less依赖也一起加进来,重新npm install下即可在项目中使用。
在这里插入图片描述
在dev/serve.js中按需引入Element-UI后,即可使用对应的组件了。
在这里插入图片描述
如果仍有疑问,请在评论下留言,我会定时回答你的疑问。如果是第一次学习npm包创建和发布的同学建议收藏本文章,因为真的没有这么详细的良心教学了。看到这里,确定还不点个赞和加个关注吗?

  JavaScript知识库 最新文章
ES6的相关知识点
react 函数式组件 & react其他一些总结
Vue基础超详细
前端JS也可以连点成线(Vue中运用 AntVG6)
Vue事件处理的基本使用
Vue后台项目的记录 (一)
前后端分离vue跨域,devServer配置proxy代理
TypeScript
初识vuex
vue项目安装包指令收集
上一篇文章      下一篇文章      查看所有文章
加:2021-12-05 11:57:28  更:2021-12-05 11:59:08 
 
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁

360图书馆 购物 三丰科技 阅读网 日历 万年历 2024年11日历 -2024/11/24 7:28:36-

图片自动播放器
↓图片自动播放器↓
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
图片批量下载器
↓批量下载图片,美女图库↓
  网站联系: qq:121756557 email:121756557@qq.com  IT数码