vue-cli3 將自己寫的組件封裝成可引入的js文件

首先用 vue-cli 創建一個 default 項目
當前的項目目錄是這樣的:
vue-cli3 將自己寫的組件封裝成可引入的js文件

首先需要創建一個 packages 目錄,用來存放組件
然後將 src 目錄改爲 examples 用作示例
vue-cli3 將自己寫的組件封裝成可引入的js文件

二、修改配置
啓動項目的時候,默認入口文件是 src/main.js
將 src 目錄改爲 examples 之後,就需要重新配置入口文件
在根目錄下創建一個 vue.config.js 文件


// vue.config.js

module.exports = {
  // 將 examples 目錄添加爲新的頁面
  pages: {
    index: {
      // page 的入口
      entry: 'examples/main.js',
      // 模板來源
      template: 'public/index.html',
      // 輸出文件名
      filename: 'index.html'
    }
  }
}

完成這一步之後就可以正常啓動項目了
vue-cli 3.x  提供了構建庫的命令,所以這裏不需要再爲 packages 目錄配置 webpack

三、開發組件
之前已經創建了一個 packages 目錄,用來存放組件
該目錄下存放每個組件單獨的開發目錄,和一個 index.js 整合所有組件,並對外導出
每個組件都應該歸類於單獨的目錄下,包含其組件源碼目錄 src,和 index.js 便於外部引用
這裏以 textarea 組件爲例,完整的 packages 目錄結構如下:
vue-cli3 將自己寫的組件封裝成可引入的js文件
textarea/src/main.vue 是組件的開發文件,具體代碼這裏就不展示了
需要注意的是,組件必須聲明 name,這個 name 就是組件的標籤
textarea/index.js 用於導出單個組件,如果要做按需引入,也需要在這裏配置







// packages/textarea/index.js

// 導入組件,組件必須聲明 name
import Textarea from './main.vue'

// 爲組件添加 install 方法,用於按需引入
Textarea.install = function (Vue) {
    Vue.component(Textarea.name, Textarea)
}

export default Textarea

四、整合並導出組件
編輯 packages/index.js 文件,實現組件的全局註冊

// packages / index.js

// 導入單個組件
import Textarea from './textarea/index'

// 以數組的結構保存組件,便於遍歷
const components = [
    Textarea
]

// 定義 install 方法
const install = function (Vue) {
    if (install.installed) return
    install.installed = true
    // 遍歷並註冊全局組件
    components.map(component => {
        Vue.component(component.name, component)
    })
}

if (typeof window !== 'undefined' && window.Vue) {
    install(window.Vue)
}

export default {
    // 導出的對象必須具備一個 install 方法
    install,
    // 組件列表
    ...components
}

到這裏組件就已經開發完畢

可以在 examples/main.js 中引入該組件

import TagTextarea from '../packages/index'
Vue.use(TagTextarea)

vue-cli3 將自己寫的組件封裝成可引入的js文件
組件的標籤就是組件內定義的的 name
vue-cli3 將自己寫的組件封裝成可引入的js文件
這時候可以 npm run serve 啓動項目,測試一下組件是否有 bug
// 啓動前需要確保已經在 vue.config.js 中添加了新入口 examples/main.js



五、打包組件
vue-cli 3.x 提供了一個庫文件打包命令
主要需要四個參數:
1. target: 默認爲構建應用,改爲 lib 即可啓用構建庫模式
2. name: 輸出文件名
3. dest: 輸出目錄,默認爲 dist,這裏我們改爲 lib
4. entry: 入口文件路徑,默認爲 src/App.vue,這裏改爲 packages/index.js
基於此,在 package.json 裏的 scripts 添加一個 lib 命令






// pageage.json

{
  "scripts": {
    "lib": "vue-cli-service build --target lib --name tag-textarea --dest lib packages/index.js"
  }
}

然後執行 npm run lib 命令,編譯組件

六、準備發佈
首先需要在 package.json 添加組件信息
name: 包名,該名不能和已有的名稱衝突;
version: 版本號,不能和歷史版本號相同;
description: 簡介;
main: 入口文件,應指向編譯後的包文件;
keyword:關鍵字,以空格分割;
author:作者;
private:是否私有,需要修改爲 false 才能發佈到 npm;
license:開源協議。
vue-cli3 將自己寫的組件封裝成可引入的js文件
然後創建 .npmignore 文件,設置忽略文件
該文件的語法和 .gitignore 的語法一樣,設置發佈到 npm 時忽略哪些目錄或文件











.DS_Store
node_modules/
examples/
packages/
public/
vue.config.js
babel.config.js
*.map
*.html

# local env files
.env.local
.env.*.local

# Log files
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# Editor directories and files
.idea
.vscode
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw*

七、發佈到 npm
如果以前改過 npm 的鏡像地址,比如使用了淘寶鏡像,就先改回來

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

如果沒有 npm 賬戶,可以通過 npm adduser 命令創建一個賬戶,或者到 npm 官網註冊
如果在官網註冊的賬戶,或者以前就有賬戶,就使用 npm login 命令登錄
具體流程可以參考官方文檔(谷歌瀏覽器->翻譯中文)

在發佈之前,一定要確保組件已經編譯完畢,而且 package.json 中的入口文件(main)的路徑正確
一切就緒,發佈組件:

npm publish

原文: https://www.cnblogs.com/wisewrong/p/10186611.html

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章