Vue腳手架 Vue-cli

初始化腳手架

說明

1. Vue 腳手架是 Vue 官方提供的標准化開發工具（開發平台）。

2. 最新的版本是 4.x。

3. 文檔: https://cli.vuejs.org/zh/

具體步驟

第一步（僅第一次執行）：全局安裝@vue/cli。
npm install -g @vue/cli

第二步：切換到你要創建項目的目錄，然后使用命令創建項目
vue create xxxx

第三步：啟動項目
npm run serve

備注：

1. 如出現下載緩慢請配置 npm 淘寶鏡像：npm config set registry https://registry.npm.taobao.org

2. Vue 腳手架隱藏了所有 webpack 相關的配置，若想查看具體的 webpakc 配置，
   請執行：vue inspect > output.j

腳手架文件結構

├── node_modules 
├── public
│   ├── favicon.ico: 頁簽圖標
│   └── index.html: 主頁面
├── src
│   ├── assets: 存放靜態資源
│   │   └── logo.png
│   │── component: 存放組件
│   │   └── HelloWorld.vue
│   │── App.vue: 匯總所有組件
│   │── main.js: 入口文件
├── .gitignore: git版本管制忽略的配置
├── babel.config.js: babel的配置文件
├── package.json: 應用包配置文件 
├── README.md: 應用描述文件
├── package-lock.json：包版本控制文件

關於不同版本的Vue

1. vue.js與vue.runtime.xxx.js的區別：
   1. vue.js是完整版的Vue，包含：核心功能 + 模板解析器。
   2. vue.runtime.xxx.js是運行版的Vue，只包含：核心功能；沒有模板解析器。
2. 因為vue.runtime.xxx.js沒有模板解析器，所以不能使用template這個配置項，需要使用render函數接收到的createElement函數去指定具體內容。
   render: h => h(App)

vue.config.js配置文件

1. 使用vue inspect > output.js 可以查看到Vue腳手架的默認配置。
2. 使用vue.config.js可以對腳手架進行個性化定制，詳情見：https://cli.vuejs.org/zh

ref 屬性

1. 用來給元素或子組件注冊引用信息，打標識（id的替代者）
2. 應用在html標簽上獲取的是真實DOM元素，應用在組件標簽上是組件實例對象（vc）
3. 使用方式：
   1. 打標識：<h1 ref="xxx">.....</h1> 或 <School ref="xxx"></School>
   2. 獲取：this.$refs.xxx

props 配置項

1. 功能：讓組件接收外部傳過來的數據

2. 傳遞數據：<Demo name="xxx"/>

3. 接收數據：

   1. 第一種方式（只接收）：props:['name']
   2. 第二種方式（限制類型）：props:{name:String}
   3. 第三種方式（限制類型、限制必要性、指定默認值）：

props:{
	name:{
	type:String, //類型
	required:true, //必要性
	default: ()=> '老王' //默認值
	}
}

注意：在傳遞數據時，默認都是字符，若要傳遞數值：<Demo :age="21"/>

備注：props是只讀的，Vue底層會監測你對props的修改，如果進行了修改，就會發出警告，若業務需求確實需要修改，那么請復制props的內容到data中一份，然后去修改data中的數據。

mixin(混入)

1. 功能：可以把多個組件共用的配置提取成一個混入對象

2. 使用方式：

   第一步 定義混合：

   export const hunhe = {
       data(){....},
       methods:{....}
       ....
   }
   

   第二步 導入混合

   ​ import {hunhe} from '../mixin'
   ​ 導入的名稱要和 mixin.js文件里導出定義的名稱一樣

   第三步 使用混入：

   ​ 全局混入：Vue.mixin(hun)
   ​ 局部混入：mixins:['hun']

插件

1. 功能：用於增強Vue

2. 本質：包含install方法的一個對象，install的第一個參數是Vue，第二個以后的參數是插件使用者傳遞的數據。

3. 定義插件：

   export default {
       install(Vue, options) {
           // 1. 添加全局過濾器
           Vue.filter(....)
   
           // 2. 添加全局指令
           Vue.directive(....)
   
           // 3. 配置全局混入(合)
           Vue.mixin(....)
   
           // 4. 添加實例方法
           Vue.prototype.$myMethod = function () {...}
           Vue.prototype.$myProperty = xxxx
   	}
   }

4. 使用插件：
   export導出 import導入后，Vue.use(xxx)

scoped樣式

1. 作用：讓樣式在局部生效，防止沖突。
2. 寫法：<style scoped>

總結TodoList案例

1. 組件化編碼流程：

   ​ (1).拆分靜態組件：組件要按照功能點拆分，命名不要與html元素沖突。

   ​ (2).實現動態組件：考慮好數據的存放位置，數據是一個組件在用，還是一些組件在用：

   ​ 1).一個組件在用：放在組件自身即可。

   ​ 2). 一些組件在用：放在他們共同的父組件上（狀態提升）。

   ​ (3).實現交互：從綁定事件開始。

2. props適用於：

   ​ (1).父組件 ==> 子組件 通信

   ​ (2).子組件 ==> 父組件 通信（要求父先給子一個函數）

3. 使用v-model時要切記：v-model綁定的值不能是props傳過來的值，因為props是不可以修改的！

4. props傳過來的若是對象類型的值，修改對象中的屬性時Vue不會報錯，但不推薦這樣做。

webStorage

1. 存儲內容大小一般支持5MB左右（不同瀏覽器可能還不一樣）

2. 瀏覽器端通過 Window.sessionStorage 和 Window.localStorage 屬性來實現本地存儲機制。

3. 相關API：

   1. xxxxxStorage.setItem('key', 'value');
      該方法接受一個鍵和值作為參數，會把鍵值對添加到存儲中，如果鍵名存在，則更新其對應的值。

   2. xxxxxStorage.getItem('person');

      ​ 該方法接受一個鍵名作為參數，返回鍵名對應的值。

   3. xxxxxStorage.removeItem('key');

      ​ 該方法接受一個鍵名作為參數，並把該鍵名從存儲中刪除。

   4. xxxxxStorage.clear()

      ​ 該方法會清空存儲中的所有數據。

4. 備注：

   1. SessionStorage（會話）存儲的內容會隨着瀏覽器窗口關閉而消失。
   2. LocalStorage（永久）存儲的內容，需要手動清除才會消失。
   3. xxxxxStorage.getItem(xxx)如果xxx對應的value獲取不到，那么getItem的返回值是null。
   4. JSON.parse(null)的結果依然是null。

組件的自定義事件

1. 一種組件間通信的方式，適用於：子組件 ===> 父組件

2. 使用場景：A是父組件，B是子組件，B想給A傳數據，那么就要在A中給B綁定自定義事件（事件的回調在A中）。

3. 綁定自定義事件：

   1. 第一種方式，在父組件中：
      <Demo @atguigu="test"/> 或
      <Demo v-on:atguigu="test"/>
   2. 第二種方式，在父組件中：

<Demo ref="demo"/>
......
methods: { sayHello(){console.log("hello~")} },
mounted(){
   this.$refs.xxx.$on('say-hello',this.sayHello)
}

1. 若想讓自定義事件只能觸發一次，可以使用once修飾符，或$once方法。

2. 觸發自定義事件（在子組件）：this.$emit('say-hello',數據)

3. 解綁自定義事件this.$off('say-hello')

4. 組件上也可以綁定原生DOM事件，需要使用native修飾符。

5. 注意：通過this.$refs.xxx.$on('say-hello',回調)綁定自定義事件時，回調要么配置在methods中，要么用箭頭函數，否則this指向會出問題！

全局事件總線（GlobalEventBus）

1. 一種組件間通信的方式，適用於任意組件間通信。
2. 安裝全局事件總線：

// main.js
new Vue({
	......
	beforeCreate() {
		Vue.prototype.$bus = this //安裝全局事件總線，$bus就是當前應用的vm
	},
    ......
}) 

3. 使用事件總線：

   接收數據：A組件想接收數據，則在A組件中給$bus綁定自定義事件，事件的回調留在A組件自身。

......
mounted() {
	this.$bus.$on('xxxx',()=>{})
},
beforeDestroy() {
	this.$bus.$off("xxxx")
}

​ 誰提供數據就調用：this.$bus.$emit('xxxx',數據)

4. 最好在beforeDestroy鈎子中，用$off去解綁當前組件所用到的事件。

消息訂閱與發布（pubsub-js）

1. 一種組件間通信的方式，適用於任意組件間通信。

2. 使用步驟：

   1. 安裝pubsub：npm i pubsub-js
   2. 引入: import pubsub from 'pubsub-js'
   3. 接收數據：A組件想接收數據，則在A組件中訂閱消息，訂閱的回調留在A組件自身。

methods(){
  demo(msgName, data){......}
}
......
mounted() {
  this.pubId = pubsub.subscribe('xxx',this.demo) //訂閱消息
}

4. 提供數據：pubsub.publish('xxx',數據)

5. 最好在beforeDestroy鈎子中，用PubSub.unsubscribe(pubId)去取消訂閱。

nextTick

1. 語法：this.$nextTick(回調函數)
2. 作用：在下一次 DOM 更新結束后執行其指定的回調。
3. 什么時候用：當改變數據后，要基於更新后的新DOM進行某些操作時，要在nextTick所指定的回調函數中執行。

Vue封裝的過度與動畫

1. 作用：在插入、更新或移除 DOM元素時，在合適的時候給元素添加樣式類名。

2. 

3. 寫法：

   1. 准備好樣式：

      • 元素進入的樣式：
        1. v-enter：進入的起點
        2. v-enter-active：進入過程中
        3. v-enter-to：進入的終點
      • 元素離開的樣式：
        1. v-leave：離開的起點
        2. v-leave-active：離開過程中
        3. v-leave-to：離開的終點

   2. 使用<transition>包裹要過度的元素，並配置name屬性

4. 自定義動畫搭配過渡

<template>
  <div>
    <button @click="isShow=!isShow">顯示/隱藏</button>
    <transition name="hello" appear>
      <!-- appear屬性，當出現就過渡一次 -->
      <h1 v-show="isShow">你好啊！！！</h1>
    </transition>
  </div>
</template>

<script>
  export default {
    name: "Test",
    data() {
      return {
        isShow: true
      }
    },
  }
</script>

<style scoped>
  h1{
    background-color: orange;
  }

  /* 自定義合適開始動畫 */
  .hello-enter-active{
    animation: comego .5s;
  }
  .hello-leave-active{
    animation: comego .5s reverse;
  }
  /* 自定義動畫 */
  @keyframes comego {
    from{
      transform: translateX(-100%);
    }
    to{
      transform: translateX(0px);
    }
  }
</style>

2. 自定義過渡

<template>
  <div>
    <button @click="isShow = !isShow">顯示/隱藏</button>
	<!-- 有多個元素要用 transition-group --> 
	<transition-group name="hello" appear>
	  <h1 v-show="!isShow" key="1">你好啊！</h1>
	  <h1 v-show="isShow" key="2">Hello！</h1>
	</transition-group>
  </div>
</template>

<script>
  export default {
	name:'Test2',
	data() {
	  return {
		isShow:true
		}
	  },
  }
</script>

<style scoped>
  h1{
	background-color: orange;
  }
  /* 進入的起點、離開的終點 */
  .hello-enter,.hello-leave-to{
	transform: translateX(-100%);
  }
  .hello-enter-active,.hello-leave-active{
	transition: 0.5s linear;
  }
  /* 進入的終點、離開的起點 */
  .hello-enter-to,.hello-leave{
	transform: translateX(0);
  }

</style>

備注：若有多個元素需要過度，則需要使用：<transition-group>，且每個元素都要指定key值。

3. 使用外部css庫（animation.css）

<template>
  <div>
    <button @click="isShow=!isShow">顯示/隱藏</button>
    <transition 
      appear
      name="animate__animated animate__bounce" 
      enter-active-class="animate__swing"
      leave-active-class="animate__backOutUp"
    >
      <h1 v-show="isShow">你好啊！！！</h1>
    </transition>
  </div>
</template>

<script>
  // 安裝后，導入
  import "animate.css"

  export default {
    name: "Test3",
    data() {
      return {
        isShow: true
      }
    },
  }
</script>

<style scoped>
  h1{
    background-color: orange;
  }

</style>

vue腳手架配置代理

方法一

​ 在vue.config.js中添加如下配置：

devServer:{
  proxy:"http://localhost:5000"
}

說明：

1. 優點：配置簡單，請求資源時直接發給前端（8080）即可。
2. 缺點：不能配置多個代理，不能靈活的控制請求是否走代理。
3. 工作方式：若按照上述配置代理，當請求了前端不存在的資源時，那么該請求會轉發給服務器 （優先匹配前端資源）

方法二

編寫vue.config.js配置具體代理規則：

module.exports = {
	devServer: {
      proxy: {
      '/api1': {// 匹配所有以 '/api1'開頭的請求路徑
        target: 'http://localhost:5000',// 代理目標的基礎路徑
        pathRewrite: {'^/api1': ''},  // 必須寫，代理服務器訪問服務器時要修改路徑
        ws: true,  // 用於支持WebSocket
        changeOrigin: true // 用於控制請求頭中的host值
      },
      '/api2': {// 匹配所有以 '/api2'開頭的請求路徑
        target: 'http://localhost:5001',// 代理目標的基礎路徑
        pathRewrite: {'^/api2': ''},  // 必須寫，代理服務器訪問服務器時要修改路徑
        ws: true,  // 用於支持WebSocket
        changeOrigin: true, // 用於控制請求頭中的host值
      }
    }
  }
}
/*
   changeOrigin設置為true時，服務器收到的請求頭中的host為：localhost:5000
   changeOrigin設置為false時，服務器收到的請求頭中的host為：localhost:8080
   changeOrigin默認值為true
*/

說明：

1. 優點：可以配置多個代理，且可以靈活的控制請求是否走代理。
2. 缺點：配置略微繁瑣，請求資源時必須加前綴。

插槽

1. 作用：讓父組件可以向子組件指定位置插入html結構，也是一種組件間通信的方式，適用於 父組件 ==> 子組件 。

2. 分類：默認插槽、具名插槽、作用域插槽

3. 使用方式：

   1. 默認插槽：

父組件中：
<Category>
  <div>html結構1</div>
</Category>

子組件中：
<template>
  <div>
	<!-- 定義插槽 -->
	<slot>插槽默認內容...</slot>
  </div>
</template>

2. 具名插槽：

父組件中：
<Category>
  <template slot="center">
	<div>html結構1</div>
  </template>

  <template v-slot:footer>
    <!-- 只有template標簽才能用 v-slot:xxx -->
	<div>html結構2</div>
  </template>
</Category>

子組件中：
<template>
  <div>
	<!-- 定義插槽 -->
	<slot name="center">插槽默認內容...</slot>
	<slot name="footer">插槽默認內容...</slot>
  </div>
</template>

3. 作用域插槽：

• 理解：數據在組件的自身，但根據數據生成的結構需要組件的使用者來決定。（games數據在Category組件中，但使用數據所遍歷出來的結構由App組件決定）
• 具體編碼：

父組件中：
<Category>
  <template scope="scopeData">
	<!-- 生成的是ul列表 -->
	<ul>
	  <li v-for="g in scopeData.games" :key="g">{{g}}</li>
	</ul>
  </template>
</Category>

<Category>
  <template slot-scope="scopeData">
	<!-- 生成的是h4標題 -->
	<h4 v-for="g in scopeData.games" :key="g">{{g}}</h4>
  </template>
</Category>

推薦寫法：帶值的v-slot，並且可以連用 v-slot:slotName='slotProps'
<Category>
  <template v-slot="slotProps">
	<h4 v-for="g in slotProps.games" :key="g">{{g}}</h4>
  </template>
</Category>


子組件中：
<template>
  <div>
	<slot :games="games"></slot>
  </div>
</template>
		
<script>
//數據在子組件自身
  data() {
	return {
		games:['紅色警戒','穿越火線','勁舞團','超級瑪麗']
	}
  },
</script>