技術文章 » 從0開始瞭解16個Vue指令到手動封裝自定義指令

從0開始瞭解16個Vue指令到手動封裝自定義指令

2022-01-30 10:00:54
本篇文章給大家帶來了關於Vue指令和手動封裝自定義指令的相關知識，希望對大家有幫助。

在前端基礎面試中，Vue的指令算是一個高頻面試題

面試官問：Vue有哪些指令？

你就告訴他：截止到Vue3.2，Vue一共有16個自帶指令，包括了：

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中廢棄

若面試官進一步問：如何封裝一個自定義指令？

你就告訴他：自定義指令要分全域性自定義指令和區域性指令；在Vue3中可以通過應用範例身上的directive()註冊一個全域性自定義指令，如果想註冊區域性指令，可在元件中設定directives選項來註冊區域性指令

看完本文，你將全面瞭解16個Vue指令以及掌握如何自定義一個指令

1. 簡介

1.1 什麼是Vue指令

在Vue中，指令其實就是特殊的屬性

Vue會根據指令，在背後做一些事，至於具體做什麼事，Vue根據不同的指令會執行不同的操作，具體後面會說

1.2 有什麼特點

Vue指令有個明顯的特點就是，都是以v-開頭，例如：v-text

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

2. 內建指令

2.1 Vue有哪些內建指令呢

內建指令指的就是Vue自帶指令，開箱即用

Vue一共有16個自帶指令，包括了：

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中廢棄

下面我們來了解一下這些內建指令的基本使用

2.2 瞭解16個內建指令的基本使用

2.2.1 v-text

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

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

h1元素的內容最終取決於msg的值

01.png

2.2.2 v-html

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

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

02.png

需要注意的是，裡頭內容必須是按普通 HTML 插入

2.2.3 v-show

v-show可以根據表示式的真假值，切換元素的display值，用於控制元素的展示和隱藏，例如：

03.png

可以看到，當條件變化時該指令觸發顯示或隱藏的過渡效果

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

2.2.4 v-if

v-if用於根據表示式的真假值來有條件地渲染元素

與v-show相比，v-if在切換時是元素的銷燬或重建，而不是簡單的顯示隱藏

04.png

可以看到當表示式為假時，v-if是直接銷燬元素，而v-show只是視覺上隱藏了而已

並且v-if可以是 <template>，如果元素是 <template>，將提取它的內容作為條件塊

2.2.5 v-else

v-else無需表示式，表示新增一個「else 塊」，相當於v-if滿足條件時展示v-if的元素，否則展示v-else的元素，例如：

05.png

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

2.2.6 v-else-if

同理，表示 v-if 的「else if 塊」，和v-else一樣，前一個兄弟元素必須有v-if或 v-else-if，例如：

06.png

2.2.7 v-for

v-for一個用於迭代的指令，可以根據源資料多次渲染元素或模板塊，例如：

07.png

也可以為陣列索引指定別名或者用於物件的鍵

<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 - 呼叫 event.stopPropagation()

  • .prevent - 呼叫 event.preventDefault()

  • .capture - 新增事件偵聽器時使用 capture 模式

  • .self - 只當事件是從偵聽器繫結的元素本身觸發時才觸發回撥

  • .{keyAlias} - 僅當事件是從特定鍵觸發時才觸發回撥

  • .once - 只觸發一次回撥

  • .left - 只當點選滑鼠左鍵時觸發

  • .right - 只當點選滑鼠右鍵時觸發

  • .middle - 只當點選滑鼠中鍵時觸發

  • .passive - { passive: true } 模式新增偵聽器

例如：

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

需要注意，用在普通元素上時，只能監聽原生 DOM 事件。用在自定義元素元件上時，也可以監聽子元件觸發的自定義事件

2.2.9 v-bind

v-bind用於繫結資料和元素屬性，可以縮寫為: 或.(當使用 .prop 修飾符時)，比如

<div :someProperty.prop="someObject"></div>
<!-- 相當於 -->
<div .someProperty="someObject"></div>

v-bind的3個修飾符

  • .camel - 將 kebab-case attribute 名轉換為 camelCase

  • .prop - 將一個繫結強制設定為一個 DOM property。3.2+

  • .attr - 將一個繫結強制設定為一個 DOM attribute。3.2+

2.2.10 v-model

v-model限制於：

<input>

<select>

<textarea>

components

v-model的3個修飾符：

  • .lazy - 惰性更新，監聽 change 而不是 input 事件

  • .number - 輸入字串轉為有效的數位

  • .trim - 輸入首尾空格過濾

在表單控制元件或者元件上可以建立雙向繫結，例如：

08.png

2.2.11 v-slot

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

可選擇性傳遞引數，表示插槽名，預設值default

2.2.12 v-pre

v-pre指令用於跳過這個元素及其子元素的編譯過程，例如:

09.png

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

2.2.13 v-cloak

v-cloak指令主要用於解決插值表示式在頁面閃爍問題

<div v-cloak>
  {{ message }}
</div>
[v-cloak] {
  display: none;
}

這樣div只會在編譯結束後顯示

2.2.14 v-once

v-once指令用於表示只渲染一次，當要重新渲染，元素/元件及其所有的子節點將被視為靜態內容並跳過

2.2.15 v-memo 3.2+

用於快取一個模板的子樹

該指令接收一個固定長度的陣列作為依賴值進行記憶比對。如果陣列中的每個值都和上次渲染的時候相同，則整個該子樹的更新會被跳過

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

在重新渲染時，如果 valueA 與 valueB 都維持不變，那麼對這個 <div> 以及它的所有子節點的更新都將被跳過

2.2.16 v-is

已在 3.1.0 中廢棄，改用:is

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

3. 自定義指令

3.1 如何自定一個指令

3.1.1 全域性自定義指令

前言部分我們也說了，在Vue3中可以通過應用範例身上的directive()註冊一個全域性自定義指令。例如官方給的一個例子

const app = Vue.createApp({})
// 註冊一個全域性自定義指令 `v-focus`
app.directive('focus', {
  // 當被繫結的元素掛載到 DOM 中時……
  mounted(el) {
    // 聚焦元素
    el.focus()
  }
})

上述程式碼中，通過Vue.createApp({})得到應用範例app，應用範例app身上有個directive()，用於建立一個全域性的自定義指令

用的時候也非常簡單，例如

<input v-focus />

3.1.2 註冊區域性指令

如果想註冊區域性指令，可在元件中設定directives選項來註冊區域性指令；還是以v-focus為例：

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

3.1.3 疑問

通過上述例子，我們可以看到不管是使用directive自定義全域性指令，還是使用directives設定區域性指令，裡頭都需要一個指令名，如focus

而具體的設定物件中的mounted是啥？mounted中的el又是啥？除了mounted還有啥，除了el還有哪些引數？

3.1.4 勾點函數（7個）

開門見山，mounted其實就是指令的勾點函數，表示元件被掛載後呼叫；el則是指令繫結到的元素

這裡主要講講勾點函數，除了mounted以外，還有其他指令勾點，均為可選

  • created：在繫結元素的 attribute 或事件監聽器被應用之前呼叫

  • beforeMount：當指令第一次繫結到元素並且在掛載父元件之前呼叫

  • mounted：在繫結元素的父元件被掛載後呼叫

  • beforeUpdate：在更新包含元件的 VNode 之前呼叫

  • updated：在包含元件的 VNode及其子元件的 VNode更新後呼叫

  • beforeUnmount：在解除安裝繫結元素的父元件之前呼叫

  • unmounted：當指令與元素解除繫結且父元件已解除安裝時，只呼叫一次

3.1.5 勾點函數的4個引數

勾點函數的4個引數都是可選，分別是

el：用於直接操作 DOM，表示指令繫結到的元素

binding物件：包含以下6個屬性

  • instance：使用指令的元件範例

  • value：傳遞給指令的值

  • oldValue：先前的值

  • arg：傳遞給指令的引數

  • modifiers：傳遞給指令的修飾符

  • dir：一個物件，其實就是註冊指令時傳遞的設定物件

vnode：虛擬DOM，一個真實 DOM 元素的藍圖，對應el

prevNode：上一個虛擬節點

3.2 手動封裝自定義指令

瞭解了基本知識，我們可以手動封裝一個自定義指令v-pin，表示將一個東西定在頁面上

3.2.1 建立Vue專案

首先，使用vite搭建Vue3專案

npm init vite@latest

最後根據提示，使用npm run dev啟動專案

10.png

當然你也可以用其他方

我們知道Vue 自定義指令有全域性註冊和區域性註冊兩種方式，為了方便，我就將v-pin註冊在全域性

3.2.2 實現效果

我要講任意的定在指定的位置，比如將上圖中的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;
        // 傳遞給指令的引數，可以表示定在的重要度
        var args = binding.arg;
        if (pinned) {
            el.style.position = 'fixed';
            if (args == "warning") {
                //簡單設定樣式，以示區分
                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')

使用也很簡單，如下

11.png

結果如圖：

12.png

3.2.3 完善結構

為了方便以後註冊更多的自定義指令，我們修改程式碼結構

首先，新建立一個專門用於放指令的資料夾directives

然後將每個自定義指令寫成一個物件並匯出，如下directives\pin.js

const pin = {
  mounted(el, binding) {
    //是否要定住
    var pinned = binding.value;
    //傳入的修飾符，表示定在哪裡
    var position = binding.modifiers;
    // 傳遞給指令的引數，可以表示定在的重要度
    var args = binding.arg;
    if (pinned) {
      el.style.position = 'fixed';
      if (args == "warning") {
        el.style.backgroundColor = "pink";
      }
      for (var val in position) {
        if (position[val]) {
          el.style[val] = '10px';
        }
      }
    } else {
      el.style.position = 'static';
      el.style.backgroundColor = "";
    }
  }
}
export default pin

接著，在directives資料夾下建立index.js，將所有的指令都匯入到這，放在directives中，然後匯出一個install方法

import pin from './pin'
const directives = {
    pin
}
export default {
    install(app) {
        Object.keys(directives).forEach((key) => {
            app.directive(key, directives[key])
        })
    },
}

最後就是在main.js中，通過use()來呼叫install方法，於是將所有的指令批次註冊了

import { createApp } from 'vue'
import App from './App.vue'
import Directives from './directives'
const app = createApp(App)
app.use(Directives)
app.mount('#app')

重新整理之後，結果還是一樣

13.png

好處是，以後再寫自定義指令就方便太多了

相關推薦：

以上就是從0開始瞭解16個Vue指令到手動封裝自定義指令的詳細內容，更多請關注TW511.COM其它相關文章！