在vue中，指令是帶有“v-”前綴的特殊特性（屬性），指令特性的值預(yù)期是單個(gè)JavaScript表達(dá)式，語(yǔ)法為“v-指令:參數(shù)="表達(dá)式"”。Vue作用于HTML元素，指令提供了一些特殊的特性，將指令綁定在元素上時(shí)，指令會(huì)為綁定的目標(biāo)元素添加一些特殊的行為；因此可以將指令看作特殊的HTML特性。

如何快速入門VUE3.0：進(jìn)入學(xué)習(xí)

本教程操作環(huán)境：windows7系統(tǒng)、vue3版，DELL G3電腦。

1、vue.js指令是什么？作用是什么？

Vue.js指令 (Directives) 是帶有 v- 前綴的特殊特性。指令特性的值預(yù)期是單個(gè) JavaScript 表達(dá)式 (v-for 是例外情況)。

Vue.js作用于HTML元素，指令提供了一些特殊的特性，將指令綁定在元素上時(shí)，指令會(huì)為綁定的目標(biāo)元素添加一些特殊的行為，我們可以將指令看作特殊的HTML特性（attribute）。

指令的作用是：當(dāng)表達(dá)式的值改變時(shí)，將其產(chǎn)生的連帶影響，響應(yīng)式地作用于 DOM。

每個(gè)指令都有自己的用途，當(dāng)其綁定的表達(dá)式發(fā)生改變的時(shí)候，會(huì)響應(yīng)式的影響dom的變化。而變化的具體則是看每個(gè)指令其本身的用途。比如v-bind指令是綁定屬性值，當(dāng)綁定的表達(dá)式發(fā)生改變，dom上屬性的值也會(huì)發(fā)生對(duì)應(yīng)的改變。

指令的語(yǔ)法是：v-指令:參數(shù)="表達(dá)式"（參數(shù)并不是絕對(duì)需要的）

參數(shù)

:后面跟著的就是參數(shù)，但并不一定所有的指令都會(huì)有參數(shù)，只有特定的指令會(huì)需要參數(shù)，這是由于指令的性質(zhì)決定的。這里的參數(shù)和函數(shù)的參數(shù)是類似的，就好比我這個(gè)指令需要對(duì)應(yīng)的參數(shù)才能使功能生效。

拿v-bind:type="type"來說，v-bind指令用于綁定屬性值，那么需要綁定什么屬性呢，光靠這個(gè)指令無法確定，所以需要參數(shù)來進(jìn)一步確定。也就是v-bind:type，冒號(hào)后面跟著的type就是傳入指令中的參數(shù)。告訴指令，我要綁定屬性type和表達(dá)式的關(guān)聯(lián)。

上面我們也說了，并不是所有的指令都需要參數(shù)。比如v-html指令，這個(gè)指令是綁定元素內(nèi)部的html，功能點(diǎn)已經(jīng)非常明確，不需要額外的參數(shù)去確定，只需要指令和表達(dá)式即可完成指令的功能。

表達(dá)式

""引號(hào)內(nèi)的值就是表達(dá)式，表達(dá)式一般可以是一個(gè)可執(zhí)行的js表達(dá)式。它與指令本身是有綁定關(guān)聯(lián)的，類似傳入指令的值。并且當(dāng)表達(dá)式內(nèi)的響應(yīng)式數(shù)據(jù)發(fā)生變化，也會(huì)引發(fā)dom的變化。

2、內(nèi)置指令

2.1 Vue有哪些內(nèi)置指令呢

內(nèi)置指令指的就是Vue自帶指令，開箱即用

Vue一共有16個(gè)自帶指令，包括了：

v-text、v-html、v-show、v-if、v-else、v-else-if、v-for、v-on、v-bind、v-model、v-slot、v-pre、v-cloak、v-once、v-memo、v-is，其中v-memo是3.2新增的，v-is在3.1.0中廢棄

下面我們來了解一下這些內(nèi)置指令的基本使用

2.2 了解16個(gè)內(nèi)置指令的基本使用

2.2.1 v-text

v-text的作用是，用于更新元素的 textContent，例如：

<h1 v-text="msg"></h1>

h1元素的內(nèi)容最終取決于msg的值

2.2.2 v-html

與v-text很像，只是v-html用于更新元素的 innerHTML，例如

<div v-html="'<h1>Hello LBJ</h1>'"></div>

需要注意的是，里頭內(nèi)容必須是按普通 HTML 插入

2.2.3 v-show

v-show可以根據(jù)表達(dá)式的真假值，切換元素的display值，用于控制元素的展示和隱藏，例如：

可以看到，當(dāng)條件變化時(shí)該指令觸發(fā)顯示或隱藏的過渡效果

需要注意：v-show 不支持 <template> 元素，也不支持 v-else

2.2.4 v-if

v-if用于根據(jù)表達(dá)式的真假值來有條件地渲染元素

與v-show相比，v-if在切換時(shí)是元素的銷毀或重建，而不是簡(jiǎn)單的顯示隱藏

可以看到當(dāng)表達(dá)式為假時(shí)，v-if是直接銷毀元素，而v-show只是視覺上隱藏了而已

并且v-if可以是 <template>，如果元素是 <template>，將提取它的內(nèi)容作為條件塊

2.2.5 v-else

v-else無需表達(dá)式，表示添加一個(gè)“else 塊”，相當(dāng)于v-if滿足條件時(shí)展示v-if的元素，否則展示v-else的元素，例如：

需要注意：v-else前一個(gè)兄弟元素必須有 v-if 或 v-else-if

2.2.6 v-else-if

同理，表示 v-if 的“else if 塊”，和v-else一樣，前一個(gè)兄弟元素必須有v-if或 v-else-if，例如：

2.2.7 v-for

v-for一個(gè)用于迭代的指令，可以根據(jù)源數(shù)據(jù)多次渲染元素或模板塊，例如：

也可以為數(shù)組索引指定別名或者用于對(duì)象的鍵

<div v-for="(item, index) in items"></div> <div v-for="(value, key) in object"></div> <div v-for="(value, name, index) in object"></div>

2.2.8 v-on

v-on用于給元素綁定事件，可以縮寫為：@

修飾符

• .stop – 調(diào)用 event.stopPropagation()
• .prevent – 調(diào)用 event.preventDefault()
• .capture – 添加事件偵聽器時(shí)使用 capture 模式
• .self – 只當(dāng)事件是從偵聽器綁定的元素本身觸發(fā)時(shí)才觸發(fā)回調(diào)
• .{keyAlias} – 僅當(dāng)事件是從特定鍵觸發(fā)時(shí)才觸發(fā)回調(diào)
• .once – 只觸發(fā)一次回調(diào)
• .left – 只當(dāng)點(diǎn)擊鼠標(biāo)左鍵時(shí)觸發(fā)
• .right – 只當(dāng)點(diǎn)擊鼠標(biāo)右鍵時(shí)觸發(fā)
• .middle – 只當(dāng)點(diǎn)擊鼠標(biāo)中鍵時(shí)觸發(fā)
• .passive – { passive: true } 模式添加偵聽器

例如：

<!-- 停止冒泡 --> <button @click.stop="doThis"></button>

需要注意，用在普通元素上時(shí)，只能監(jiān)聽原生 DOM 事件。用在自定義元素組件上時(shí)，也可以監(jiān)聽子組件觸發(fā)的自定義事件

2.2.9 v-bind

v-bind用于綁定數(shù)據(jù)和元素屬性，可以縮寫為: 或.(當(dāng)使用 .prop 修飾符時(shí))，比如

<div :someProperty.prop="someObject"></div> <!-- 相當(dāng)于 --> <div .someProperty="someObject"></div>

v-bind的3個(gè)修飾符

• .camel – 將 kebab-case attribute 名轉(zhuǎn)換為 camelCase
• .prop – 將一個(gè)綁定強(qiáng)制設(shè)置為一個(gè) DOM property。3.2+
• .attr – 將一個(gè)綁定強(qiáng)制設(shè)置為一個(gè) DOM attribute。3.2+

2.2.10 v-model

v-model限制于：<input><select><textarea>components

v-model的3個(gè)修飾符：

• .lazy – 惰性更新，監(jiān)聽 change 而不是 input 事件
• .number – 輸入字符串轉(zhuǎn)為有效的數(shù)字
• .trim – 輸入首尾空格過濾

在表單控件或者組件上可以創(chuàng)建雙向綁定，例如：

2.2.11 v-slot

v-slot用于提供具名插槽或需要接收 prop 的插槽

可選擇性傳遞參數(shù)，表示插槽名，默認(rèn)值default

2.2.12 v-pre

v-pre指令用于跳過這個(gè)元素及其子元素的編譯過程，例如:

可以看到里頭的東西沒有被編譯

2.2.13 v-cloak

v-cloak指令主要用于解決插值表達(dá)式在頁(yè)面閃爍問題

<div v-cloak>   {{ message }} </div>

[v-cloak] {   display: none; }

這樣div只會(huì)在編譯結(jié)束后顯示

2.2.14 v-once

v-once指令用于表示只渲染一次，當(dāng)要重新渲染，元素/組件及其所有的子節(jié)點(diǎn)將被視為靜態(tài)內(nèi)容并跳過

2.2.15 v-memo 3.2+

用于緩存一個(gè)模板的子樹

該指令接收一個(gè)固定長(zhǎng)度的數(shù)組作為依賴值進(jìn)行記憶比對(duì)。如果數(shù)組中的每個(gè)值都和上次渲染的時(shí)候相同，則整個(gè)該子樹的更新會(huì)被跳過

<div v-memo="[valueA, valueB]"></div>

在重新渲染時(shí)，如果 valueA 與 valueB 都維持不變，那么對(duì)這個(gè) <div> 以及它的所有子節(jié)點(diǎn)的更新都將被跳過

2.2.16 v-is

已在 3.1.0 中廢棄，改用:is

<component :is="currentView"></component>

3、自定義指令

3.1 如何自定一個(gè)指令

3.1.1 全局自定義指令

前言部分我們也說了，在Vue3中可以通過應(yīng)用實(shí)例身上的directive()注冊(cè)一個(gè)全局自定義指令。例如官方給的一個(gè)例子

const app = Vue.createApp({}) // 注冊(cè)一個(gè)全局自定義指令 `v-focus` app.directive('focus', {   // 當(dāng)被綁定的元素掛載到 DOM 中時(shí)……   mounted(el) {     // 聚焦元素     el.focus()   } })

上述代碼中，通過Vue.createApp({})得到應(yīng)用實(shí)例app，應(yīng)用實(shí)例app身上有個(gè)directive()，用于創(chuàng)建一個(gè)全局的自定義指令

用的時(shí)候也非常簡(jiǎn)單，例如

<input v-focus />

3.1.2 注冊(cè)局部指令

如果想注冊(cè)局部指令，可在組件中配置directives選項(xiàng)來注冊(cè)局部指令；還是以v-focus為例：

directives: {   focus: {     // 指令的定義     mounted(el) {       el.focus()     }   } }

3.1.3 疑問

通過上述例子，我們可以看到不管是使用directive自定義全局指令，還是使用directives配置局部指令，里頭都需要一個(gè)指令名，如focus

而具體的配置對(duì)象中的mounted是啥？mounted中的el又是啥？除了mounted還有啥，除了el還有哪些參數(shù)？

3.1.4 鉤子函數(shù)（7個(gè)）

開門見山，mounted其實(shí)就是指令的鉤子函數(shù)，表示組件被掛載后調(diào)用；el則是指令綁定到的元素

這里主要講講鉤子函數(shù)，除了mounted以外，還有其他指令鉤子，均為可選

• created：在綁定元素的 attribute 或事件監(jiān)聽器被應(yīng)用之前調(diào)用
• beforeMount：當(dāng)指令第一次綁定到元素并且在掛載父組件之前調(diào)用
• mounted：在綁定元素的父組件被掛載后調(diào)用
• beforeUpdate：在更新包含組件的 VNode 之前調(diào)用
• updated：在包含組件的 VNode及其子組件的 VNode更新后調(diào)用
• beforeUnmount：在卸載綁定元素的父組件之前調(diào)用
• unmounted：當(dāng)指令與元素解除綁定且父組件已卸載時(shí)，只調(diào)用一次

3.1.5 鉤子函數(shù)的4個(gè)參數(shù)

鉤子函數(shù)的4個(gè)參數(shù)都是可選，分別是

• el：用于直接操作 DOM，表示指令綁定到的元素
• binding對(duì)象：包含以下6個(gè)屬性

instance：使用指令的組件實(shí)例 value：傳遞給指令的值 oldValue：先前的值 arg：傳遞給指令的參數(shù) modifiers：傳遞給指令的修飾符 dir：一個(gè)對(duì)象，其實(shí)就是注冊(cè)指令時(shí)傳遞的配置對(duì)象

• vnode：虛擬DOM，一個(gè)真實(shí) DOM 元素的藍(lán)圖，對(duì)應(yīng)el
• prevNode：上一個(gè)虛擬節(jié)點(diǎn)

3.2 手動(dòng)封裝自定義指令

了解了基本知識(shí)，我們可以手動(dòng)封裝一個(gè)自定義指令v-pin，表示將一個(gè)東西定在頁(yè)面上

3.2.1 創(chuàng)建Vue項(xiàng)目

首先，使用vite搭建Vue3項(xiàng)目

npm init vite@latest

最后根據(jù)提示，使用npm run dev啟動(dòng)項(xiàng)目

當(dāng)然你也可以用其他方

我們知道Vue 自定義指令有全局注冊(cè)和局部注冊(cè)兩種方式，為了方便，我就將v-pin注冊(cè)在全局

3.2.2 實(shí)現(xiàn)效果

我要講任意的定在指定的位置，比如將上圖中的logo定位在右上角，代碼如下：

//main.js import { createApp } from 'vue' import App from './App.vue' const app = createApp(App)  app.directive('pin', {     mounted(el, binding) {         //是否要定住         var pinned = binding.value;         //傳入的修飾符，表示定在哪里         var position = binding.modifiers;         // 傳遞給指令的參數(shù)，可以表示定在的重要度         var args = binding.arg;         if (pinned) {             el.style.position = 'fixed';             if (args == "warning") {                 //簡(jiǎn)單設(shè)置樣式，以示區(qū)分                 el.style.backgroundColor = "pink";             }             for (var val in position) {                 if (position[val]) {                     el.style[val] = '10px';                 }             }         } else {             el.style.position = 'static';             el.style.backgroundColor = "";         }     } })  app.mount('#app')

使用也很簡(jiǎn)單，如下

結(jié)果如圖：

3.2.3 完善結(jié)構(gòu)

為了方便以后注冊(cè)