手把手教你写vue插件并发布(一)
这篇文章较长,需要一定的阅读时间。这里有一份改善版本的插件笔记,在一个项目下完成开发、测试、发布的全过程。https://www.cnblogs.com/adouwt/p/9655594.html
--2019年1月15日更新。
反映问题:
执行 npm publish 报错,因为有些同学本地设置了 淘宝的npm 镜像源,npm 包发布到这个镜像源就有问题了,最简单的方式是 :发布时候指定地址
1npm publish -registry=https://registry.npmjs.org/
--2019年4月3号更新
1.本地开发
1.1 初始化本地开发项目
我们采用vue-cli,初始化一个vue 项目。这个不做详解,请移步到 这里 https://www.cnblogs.com/anxiaoyu/p/7071143.html,查看具体详细。初始化后就是这样的项目结构:
其他的文件目录不是本节内容重点,不做详解,请移步这里查看 https://blog.csdn.net/tanzhenyan/article/details/78871610。
1.2 test.js 的内容 ,这是插件的入口文件
关于为什么需要在install这个方法这里添加我们的方法,可以参考官网。https://cn.vuejs.org/v2/guide/plugins.html这里只是用了其中的一部分的内容。
test.js的代码如下:
import testPanel from './panel.vue'import testToast from './toast.vue'let test = {}
test.install =function (Vue, options) {
Vue.prototype.$msg = 'Hello I am test.js' Vue.prototype.$myMethod =function (arr) {
if(arr.length < 0) {
returnfalse } else {
arr = arr.join('连接你我')
return arr
}
}
Vue.component(testPanel.name, testPanel) // testPanel.name 组件的name属性Vue.component(testToast.name, testToast)// testPanel.name 组件的name属性}
export defaulttest
test.js 里面引入的两个vue 文件,这两个文件就是我们需要开发的组件样式。
panel.vue
{{checkedNumber}}
- {{index}}
- 0
checkedNumber: '' }
},
components: {
},
methods: {
clickThisNumber (e) {
this.checkedNumber =this.checkedNumber.concat(e.currentTarget.innerHTML)
}
}
} .number-show {
height: 20px;
}
.number-panel ul {
padding: 0;
}
.number-panel ul li{
display: inline-block;
width: 28%;
height: 50px;
line-height: 50px;
margin-top: 20px;
background: #ddd;
border-radius: 8px;
margin-right: 10px;
}
.number-panel ul li input {
display: none;
}
实现的效果如下:
点击面板上的数字,及时展现在上面,具体的样式不做详解,逻辑很简单。
toast.vue
{{text}}
export default {
name: 'test-toast',
data () {
return {
text: '',
toastHidden: false }
},
created () {
// this.toastPlugin() },
components: {
},
methods: {
toastPlugin (msg, time) {
this.text = msg
this.toastHidden =true setTimeout(() => {
this.toastHidden =false }, time)
}
}
} .toast {
position: absolute;
left: 50%;
top: 50%;
transform: translate(-50%, -50%);
width: 0px;
min-height: 0px;
text-align: center;
background: rgba(0, 0, 0, 0.5);
border-radius: 5px;
color: #fff;
transition: all 0.5s;
z-index: -1;
opacity: 0;
}
.toast.active {
width: 150px;
min-height: 25px;
opacity: 1;
z-index: 11;
}
效果如下:
这里模拟的是,调用该插件的toast 方法。
2.本地测试
我们上面就直接给出了我们要完成的内容,但是怎么确定我们这个写的样式或者方法可以用呢? 所以需要测试下,我们到底写的是个什么鬼。
main.js 全局import
具体页面使用我们的插件:
两个效果如下:
3.打包到npm
测试完成,可以实现我们的想要的内容。下面我们就要把我们的内容打包发布到npm 上去。
为了不和开发的项目环境发生冲突,我们采用另外一个项目,专门做打包发布的。
工具:
webpack-simple 这个简化版的webpack。 初始化项目,点击这里, https://www.cnblogs.com/majj/p/9054471.html。删掉我们不需要的文件夹,新建一个我们要放置我们开发代码,完成如下:
修改webpack.config.js的打包名称
代码如下:
varpath = require('path')varwebpack = require('webpack')
module.exports = {
entry: './src/lib/index.js',
output: {
path: path.resolve(__dirname, './dist'),
publicPath: '/dist/',
filename: 'toastPanel.js',
library: 'toastPanel',// library指定的就是你使用require时的模块名,这里便是require("toastPanel")libraryTarget: 'umd',//libraryTarget会生成不同umd的代码,可以只是commonjs标准的,也可以是指amd标准的,也可以只是通过script标签引入的。umdNamedDefine:true// 会对 UMD 的构建过程中的 AMD 模块进行命名。否则就使用匿名的 define。 },
module: {
rules: [
{
test: /\.css$/,
use: [
'vue-style-loader',
'css-loader' ],
}, {
test: /\.vue$/,
loader: 'vue-loader',
options: {
loaders: {
}
// other vue-loader options go here }
},
{
test: /\.js$/,
loader: 'babel-loader',
exclude: /node_modules/ },
{
test: /\.(png|jpg|gif|svg)$/,
loader: 'file-loader',
options: {
name: '[name].[ext]?[hash]' }
}
]
},
resolve: {
alias: {
'vue$': 'vue/dist/vue.esm.js' },
extensions: ['*', '.js', '.vue', '.json']
},
devServer: {
historyApiFallback: true,
noInfo: true,
overlay: true },
performance: {
hints: false },
devtool: '#eval-source-map'}if(process.env.NODE_ENV === 'production') {
module.exports.devtool = '#source-map'// http://vue-loader.vuejs.org/en/workflow/production.htmlmodule.exports.plugins = (module.exports.plugins || []).concat([
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: '"production"' }
}),
new webpack.optimize.UglifyJsPlugin({
sourceMap: true,
compress: {
warnings: false }
}),
new webpack.LoaderOptionsPlugin({
minimize: true })
])
}
打包的项目清单配置文件:
执行 npm run build 打包
发布到npm:
注册npm 不做详解,请看这里,https://cnodejs.org/topic/5823c4411120be9438b02a31,核心操作就这么几步骤,一做就会
(插一句:注册账户我遇到一个坑,注册完后,npm官网的小姐姐会让你验证邮箱,验证完成后,需要退出登录重新登录,不然会一直提示你要验证邮箱),蹩脚的邮件交流如下,请忽略细节,仔细看划线位置。
查看当前环境下的用户:
npm whoami
登录:
npm login
发布:
npm publish
我们顺便看看,npm 官网是不是有我们的刚才发布的内容,https://www.npmjs.com/package/vue-panel-toast
4.安装使用
安装:
npm install vue-panel-toast --save
使用:
main.js 全局引入
具体页面使用:
效果如下:
开发测试到发布流程OK,样式和具体的业务效果需要在调试,总算是流程跑通,具体开发出什么样的普惠众生的插件或者UI组件,就看各位小哥哥小姐姐的拳脚啦。