一、基于vue的國家區(qū)號列表
vue-flag-list包含了大部分國家的區(qū)號,點(diǎn)擊右邊的三角形展開列表可以選擇國家區(qū)號,若列表中沒有區(qū)號,也可以自己輸入?yún)^(qū)號。
全球區(qū)號列表
1.1 初始化組件
用的是vue-cli來初始化組件,雖然有很多東西不需要,因?yàn)閷@個比較熟悉,所以還是按照這個步驟來。
vue init webpack vue-flag-list cd vue-flag-list cnpm install npm run dev
1.2 根據(jù)自己的需求,實(shí)現(xiàn)具體功能,我的主要功能寫在vue-flag-list.vue組件中。
<template> <div id="flag"> ... </div> </template> <script> export default { name: 'vue-flag-list', ... } </script> <style scoped> ... </style>
功能寫好后,修改package.json等配置文件,為打包發(fā)布做準(zhǔn)備
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", // 因?yàn)榻M件包是公用的,所以private為false "private": false, // 配置main結(jié)點(diǎn),如果不配置,我們在其他項(xiàng)目中就不用import XX from '包名'來引用了,只能以包名作為起點(diǎn)來指定相對的路徑 "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" ], // 指定關(guān)鍵字 "keywords": [ "vue", "flag", "code", "flag code" ], "license": "MIT", //開源協(xié)議 // 項(xiàng)目官網(wǎng)的url "homepage": "https://github.com/linmoer/vue-flag-list#readme", "dependencies": { "vue": "^2.3.3" }, "devDependencies": { ... }, "engines": {...}, "browserslist": [...] }
1.4.2 .gitignore 文件
因?yàn)橐胐ist文件夾,所以在.gitignore文件中把dist/去掉。
1.4.3 webpack.prod.conf.js 文件
為了支持多種使用場景,我們需要選擇合適的打包格式。常見的打包格式有 CMD、AMD、UMD,CMD只能在 Node 環(huán)境執(zhí)行,AMD 只能在瀏覽器端執(zhí)行,UMD 同時(shí)支持兩種執(zhí)行環(huán)境。顯而易見,我們應(yīng)該選擇 UMD 格式。Webpack 中指定輸出格式的設(shè)置項(xiàng)為 output.libraryTarget,其支持的格式有:
以下是 webpack.prod.conf.js 中 output 設(shè)置的示例:
output: { path: path.resolve(__dirname, '../dist'), publicPath: '', filename: 'vue-flag-list.min.js', library: 'VueFlagList', libraryTarget: 'umd', umdNamedDefine: true },
Vue 是組件庫的外部依賴。組件庫的使用者會自行導(dǎo)入 Vue,打包的時(shí)候,不應(yīng)該將 Vue 打包進(jìn)組件庫。但是,如果你將打包后的組件庫以 <script> 標(biāo)簽形式直接引入,你會發(fā)現(xiàn)并不能正常執(zhí)行,提示 vue 未定義。
以 <script> 標(biāo)簽形式使用組件時(shí),會同樣使用 <script> 標(biāo)簽導(dǎo)入 Vue。Vue 導(dǎo)入的變量是 “window.Vue” 而不是 “window.vue”,因此會出現(xiàn) vue 未定義的錯誤。
所以,我們需要在 webpack.prod.conf.js 中配置 externals,如下:
externals: { vue: { root: 'Vue', commonjs: 'vue', commonjs2: 'vue', amd: 'vue' } },
另外,為了將css打包成一個文件,所以需要將 webpack.prod.conf.js 中的plugins 選項(xiàng)的
new ExtractTextPlugin({ filename: utils.assetsPath('css/[name].[contenthash].css') }),
修改為
new ExtractTextPlugin({ filename: 'vue-flag-list.min.css' }),
修改入口文件
entry: { app: './src/index.js' },
1.5 整理一下目錄結(jié)構(gòu),我的目錄結(jié)構(gòu)如下:
- vue-flag-list + build + dist - src + img index.js Vue-Flag-List.vue ...
二、用npm發(fā)布一個包
在發(fā)正式包之前可以在本地先打一個包,然后測試下有沒有問題,如果沒問題再發(fā)布到npm上。
2.1 打包到本地使用
npm build npm pack
npm pack 之后,就會在當(dāng)前目錄下生成 vue-flag-list-1.0.0.tgz 的文件。
打開一個新的vue項(xiàng)目,在當(dāng)前路徑下執(zhí)行('路徑' 表示文件所在的位置)
cnpm install 路徑/vue-flag-list-1.0.0.tgz
在新項(xiàng)目的入口文件(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 發(fā)布到npm
1、在 npm官網(wǎng) 注冊一個npm賬號
2、切換到需要發(fā)包的項(xiàng)目根目錄下,登錄npm賬號,輸入用戶名、密碼、郵箱
npm login
3、最后一步,執(zhí)行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插件的雛形發(fā)布出去了,這是一個很簡單的插件,以后會繼續(xù)維護(hù)它,添加更多的實(shí)用功能。
聲明:本網(wǎng)頁內(nèi)容旨在傳播知識,若有侵權(quán)等問題請及時(shí)與本網(wǎng)聯(lián)系,我們將在第一時(shí)間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com