vue組件從開發到發佈的實現步驟

這篇文章主要介紹了vue組件從開發到發佈的實現步驟,小編覺得挺不錯的,現在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧

本文介紹了vue組件從開發到發佈的實現步驟,分享給大家,具體如下:

組件化是前端開發非常重要的一部分,從業務中解耦出來,可以提高項目的代碼複用率。更重要的是我們還可以打包發佈,俗話說集體的力量是偉大的,正因爲有許許多多的開源貢獻者,纔有了現在的世界。

不想造輪子的工程師,當不了合格的搬運工 。讓我們來了解一下vue組件從開發到打包發佈流程,並配置Github主頁。

本文以 vue-clock2 組件爲例,歡迎star _~~ 項目地址

  • 目標框架:vue
  • 打包工具:webpack
  • 發佈源:npm
  • 代碼託管:github

項目結構

|-- node_modules
|-- src
| |-- index.js
| |-- vue-clock.vue
|-- docs
| |-- index.html
| |-- index.css
|-- dist
  1. src: 組件相關代碼。
  2. node_modules: 組件依賴包。
  3. docs: 說明文檔,組件簡單的可以單個頁面,也可以使用vuepress
  4. dist: 打包後組件內容,一般 package.json 的 main 入口指向這個文件夾裏的文件。

組件開發

vue組件開發相對來講還是比較容易的,創建一個 vue-clock.vue 文件,組件的相關邏輯實現。

該組件主要實現一個基於 time 屬性輸入,顯示對應時間的鐘表樣式。

  <div class="clock">
    <div class="clock-circle"></div>
    <div class="clock-hour" :style="{transform:hourRotate}"></div>
    <div class="clock-minute" :style="{transform:minuteRotate}"></div>
    <b class="hour" v-for="h in timeList" :key="h">
      <span>{{h}}</span>
    </b>
  </div>

通過元素畫出鐘錶的樣式,基於 css3的transform 屬性旋轉出每個時間點。

因爲鐘錶的時針並不是直接跳到下一個點的,所以需要計算出不同分鐘時,時鐘指針的旋轉角度。

後續增加了不指定時間的情況,顯示當前時間並每分鐘自動更新。

export default {
  data() {
    return {
      timeList: [12, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],
      hourRotate: "rotatez(0deg)",
      minuteRotate: "rotatez(0deg)"
    };
  },
  props: ["time"],
  watch: {
    time() {
      this.show();
    }
  },
  methods: {
    show() {
      this.showTime();
      if (this._timer) clearInterval(this._timer);
      if (!this.time) {
        this._timer = setInterval(() => {
          this.showTime();
        }, 60 * 1000);
      }
    },
    showTime() {
      let times;
      if (this.time) {
        times = this.time.split(":");
      } else {
        const now = new Date();
        times = [now.getHours(), now.getMinutes()];
      }

      let hour = +times[0];
      hour = hour > 11 ? hour - 12 : hour;
      let minute = +times[1];
      let hourAngle = hour * 30 + minute * 6 / 360 * 30;
      let minuteAngle = minute * 6;
      this.hourRotate = `rotatez(${hourAngle}deg)`;
      this.minuteRotate = `rotatez(${minuteAngle}deg)`;
    }
  },
  mounted() {
    this.show();
  },
  destroyed() {
    if (this._timer) clearInterval(this._timer);
  }
};

還有一些鐘錶的佈局樣式,可以直接在項目裏查看。vue-clock.vue

接着我們需要拋出組件,以便在項目中引入使用。

  // src/index.js
  import Clock from './vue-clock.vue';
  export default Clock;
  if (typeof window !== 'undefined' && window.Vue) {
    window.Vue.component('clock', Clock);
  }

這裏,組件開發的部分已經完成了,喝杯咖啡,check一下代碼,我們要把它打包發佈到npm上。

打包發佈

打包前確認一下 webpack 的配置文件輸出。

 output: {
  path: path.resolve(__dirname, './dist'),
  publicPath: '/dist/',
  filename: 'vue-clock.min.js',
  library: 'Clock',
  libraryTarget: 'umd',
  umdNamedDefine: true
 }

打包組件文件到 dist 文件夾中。

npm run build

npm發佈

配置package.json

{
 "name": "vue-clock2",
 "description": "Vue component with clock",
 "version": "1.1.2",
 "author": "bestvist",
 "keywords": [
  "vue",
  "component",
  "clock",
  "time"
 ],
 "main": "dist/vue-clock.min.js",
 "license": "MIT",
 "homepage": "https://bestvist.github.io/vue-clock2/"
}

登錄npm

如果使用淘寶鏡像的,需要先修正一下鏡像源。

npm config set registry https://registry.npmjs.org/
// 查看登錄人
npm whoami
// 登錄
npm login

// 發佈
npm publish

如果看到類似信息,說明發布成功。

npm notice
+ [email protected]

Github主頁

把項目上傳到github託管,配置一份基本 README.md 說明文檔。

因爲組件已經發布到npm上,所以可以配置幾個徽章在README中。

// npm 版本
[npm version](https://img.shields.io/npm/v/vue-clock2.svg)

// npm 下載量
[npm download](https://img.shields.io/npm/dt/vue-clock2.svg)

更多的徽章配置可以查看shields

接着描述一下組件的引入和使用方法:

安裝:

npm install vue-clock2

使用:

<template>
 <clock :time="time"></clock>
</template>

<script>
 import Clock from 'vue-clock2';
 export default {
  components: { Clock },
  data () {
   return {
     time: '10:40'
   }
  }
 }
</script>

更詳細的交互或是屬性說明就交給文檔來解決了。

在 github 項目上通過 settings 指定 GitHub Pages

組件文檔說明應包括:

  • 組件引入方法
  • 組件使用方法
  • 一個簡單的例子
  • 組件屬性描述說明

總結

開發 -> 發佈 -> 託管

一個組件輪子的製作流程大致介紹完了,希望本文可以幫助到您。也希望大家多多支持神馬文庫。

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