您好,欢迎访问一九零五行业门户网

实例详解用vue封装插件并发布到npm

本文主要介绍了用vue封装插件并发布到npm的方法步骤,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧,希望能帮助到大家。
一、基于vue的国家区号列表
vue-flag-list包含了大部分国家的区号,点击右边的三角形展开列表可以选择国家区号,若列表中没有区号,也可以自己输入区号。
全球区号列表
1.1 初始化组件
用的是vue-cli来初始化组件,虽然有很多东西不需要,因为对这个比较熟悉,所以还是按照这个步骤来。
vue init webpack vue-flag-list cd vue-flag-list cnpm install  npm run dev
1.2 根据自己的需求,实现具体功能,我的主要功能写在vue-flag-list.vue组件中。
<template>  <p id="flag">  ...  </p> </template> <script>  export default {   name: 'vue-flag-list',   ...  } </script> <style scoped>  ... </style>
功能写好后,修改package.json等配置文件,为打包发布做准备
1.3 添加index.js
import flagcomponent from './vue-flag-list.vue' const vueflaglist = {  install: function (vue) {  if (typeof window !== 'undefined' && window.vue) {   vue = window.vue  }  vue.component('vueflaglist', flagcomponent)  } } export default vueflaglist
1.4 修改配置文件
1.4.1 package.json
{  name: vue-flag-list,  version: 1.0.0,  description: a vue plugin for entering and selecting area code,  author: guimin,  // 因为组件包是公用的,所以private为false  private: false,  // 配置main结点,如果不配置,我们在其他项目中就不用import xx from '包名'来引用了,只能以包名作为起点来指定相对的路径  main: dist/vue-flag-list.min.js,   scripts: {  dev: node build/dev-server.js,  start: node build/dev-server.js,  build: node build/build.js  },  // 指定代码所在的仓库地址  repository: {  type: git,  url: git+https://github.com/linmoer/vue-flag-list.git  },  // 指定打包之后,包中存在的文件夹  files: [  dist,  src  ],  // 指定关键字  keywords: [  vue,  flag,  code,  flag code  ],  license: mit, //开源协议  // 项目官网的url  homepage: https://github.com/linmoer/vue-flag-list#readme,  dependencies: {  vue: ^2.3.3  },  devdependencies: {  ...  },  engines: {...},  browserslist: [...] }
1.4.2 .gitignore 文件
因为要用dist文件夹,所以在.gitignore文件中把dist/去掉。
1.4.3 webpack.prod.conf.js 文件
为了支持多种使用场景,我们需要选择合适的打包格式。常见的打包格式有 cmd、amd、umd,cmd只能在 node 环境执行,amd 只能在浏览器端执行,umd 同时支持两种执行环境。显而易见,我们应该选择 umd 格式。webpack 中指定输出格式的设置项为 output.librarytarget,其支持的格式有:
“var” - 以一个变量形式输出: var library = xxx (default);
“this” - 以 this 的一个属性输出: this[“library”] = xxx;
“commonjs” - 以 exports 的一个属性输出:exports[“library”] = xxx;
“commonjs2” - 以 module.exports 形式输出:module.exports = xxx;
“amd” - 以 amd 格式输出;
“umd” - 同时以 amd、commonjs2 和全局属性形式输出。
以下是 webpack.prod.conf.js 中 output 设置的示例:
 output: {  path: path.resolve(__dirname, '../dist'),  publicpath: '',  filename: 'vue-flag-list.min.js',  library: 'vueflaglist',  librarytarget: 'umd',  umdnameddefine: true  },
vue 是组件库的外部依赖。组件库的使用者会自行导入 vue,打包的时候,不应该将 vue 打包进组件库。但是,如果你将打包后的组件库以 <script> 标签形式直接引入,你会发现并不能正常执行,提示 vue 未定义。
以 <script> 标签形式使用组件时,会同样使用 <script> 标签导入 vue。vue 导入的变量是 “window.vue” 而不是 “window.vue”,因此会出现 vue 未定义的错误。
所以,我们需要在 webpack.prod.conf.js 中配置 externals,如下:
externals: {  vue: {   root: 'vue',   commonjs: 'vue',   commonjs2: 'vue',   amd: 'vue'  }  },
另外,为了将css打包成一个文件,所以需要将 webpack.prod.conf.js 中的plugins 选项的
new extracttextplugin({   filename: utils.assetspath('css/[name].[contenthash].css')  }),
修改为
new extracttextplugin({   filename: 'vue-flag-list.min.css'  }),
修改入口文件
entry: {  app: './src/index.js'  },
1.5 整理一下目录结构,我的目录结构如下:
- vue-flag-list  + build  + dist  - src  + img  index.js  vue-flag-list.vue  ...
二、用npm发布一个包
在发正式包之前可以在本地先打一个包,然后测试下有没有问题,如果没问题再发布到npm上。
2.1 打包到本地使用
npm build npm pack
npm pack 之后,就会在当前目录下生成 vue-flag-list-1.0.0.tgz 的文件。
打开一个新的vue项目,在当前路径下执行('路径' 表示文件所在的位置)
cnpm install 路径/vue-flag-list-1.0.0.tgz
在新项目的入口文件(main.js)中引入
import vueflaglist from 'vue-flag-list' import 'vue-flag-list/dist/vue-flag-list.min.css' vue.use(vueflaglist)
在组件中使用
<flagcode height="30" width="120" @getcode="getcode"></flagcode> methos: {  getcode(code) {   console.log(code)  } }
2.2 发布到npm
1、在 npm官网 注册一个npm账号
2、切换到需要发包的项目根目录下,登录npm账号,输入用户名、密码、邮箱
npm login
3、最后一步,执行npm publish即可
# lin@lin-pro in ~/www/vue-flag-list on git:master $ npm publish # lin@lin-pro in ~/www/vue-flag-list on git:master $ + vue-flag-list@1.0.0
三、后记
折腾了很久,终于把vue-flag-list插件的雏形发布出去了,这是一个很简单的插件,以后会继续维护它,添加更多的实用功能。
npm unpublish --force:移除一个发布包(也可以移除指定版本的包)
npm logout:登出用户
相关推荐:
jquery封装的分页组件详解
javascript模拟实现封装的三种方式及写法
php封装搜索类实例
以上就是实例详解用vue封装插件并发布到npm的详细内容。
其它类似信息

推荐信息