vueディレクティブとは何ですか?

vue では、ディレクティブは「v-」接頭辞が付いた特別な機能 (属性) です。ディレクティブ プロパティの値は単一の JavaScript 式であることが想定され、構文は「v-directive:」です。パラメータ="式" "。 Vue は HTML 要素に作用し、ディレクティブはいくつかの特別な機能を提供します。ディレクティブを要素にバインドするとき、ディレクティブはバインドされたターゲット要素にいくつかの特別な動作を追加します。したがって、ディレクティブは特別な HTML 機能と見なすことができます。

#このチュートリアルの動作環境: Windows7 システム、vue3 バージョン、DELL G3 コンピューター。

1. vue.js コマンドとは何ですか?機能は何ですか?

Vue.js ディレクティブは、接頭辞 v- が付いた特別な機能です。ディレクティブ属性の値は、単一の JavaScript 式であることが想定されます (v-for は例外です)。

Vue.js は HTML 要素に作用します。ディレクティブはいくつかの特別な機能を提供します。ディレクティブが要素にバインドされると、ディレクティブはバインドされたターゲット要素にいくつかの特別な動作を追加します。ディレクティブ Make Special を表示できます。 HTML 属性。

ディレクティブの機能は次のとおりです。式の値が変化すると、それに関連付けられた効果が応答的に DOM に適用されます。

各命令には独自の目的があり、そのバインドされた式が変更されると、それに応じて DOM の変更が影響を受けます。具体的な変更は、各命令の目的によって異なります。たとえば、v-bind 命令は属性値をバインドします。バインド式が変更されると、それに応じて DOM 上の属性の値も変更されます。

コマンドの構文は : v-command:parameter="expression" (パラメータは絶対に必要なわけではありません)

Parameters

: の後にパラメータが続きますが、すべての命令にパラメータがあるわけではありません。特定の命令のみがパラメータを必要とします。これは性質によって決まります。指示の。ここでのパラメータは関数のパラメータに似ており、私のコマンドが関数を有効にするために対応するパラメータを必要とするのと同じです。

v-bind:type="type" を例に挙げると、v-bind 命令は属性値をバインドするために使用されるため、どのような属性が必要となるかこのコマンドだけでは判断できないため、さらに判断するにはパラメータが必要です。つまり、v-bind:type、コロンが後に続く type は、命令で渡されるパラメータです。属性 type と式の間の関連付けをバインドすることをディレクティブに伝えます。

上で述べたように、すべての命令にパラメータが必要なわけではありません。たとえば、

v-html 命令はバインディング要素内の html です。関数のポイントは非常に明確です。それを決定するために追加のパラメータは必要ありません。必要なのは命令と式だけです。 . 命令の機能を完了します。

Expression

""引用符内の値は式です。通常、式は実行可能ファイルです。 js式。これは、命令に渡される値と同様に、命令自体にバインドされます。そして、式内の応答データが変更されると、DOM にも変更が生じます。

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 の組み込み命令の基本的な使用法を理解します-in 命令

2.2.1 v -text

v-text は、

textContent## を更新するために使用されます。要素の # (例:

<h1></h1>

h1 要素の内容は、最終的に msg

の値によって異なります)

#2.2.2 v-html

v-text とよく似ていますが、要素の更新に v-html

が使用される点が異なります。

innerHTML (例:

<div>Hello LBJ'"></div>

コンテンツは通常の HTML

## として挿入する必要があることに注意してください)

#2.2.3 v-show

v-show

は、要素の display 値を、次の true または false の値に応じて切り替えることができます。要素の表示と非表示を制御するために使用される式。例:

可以看到，当条件变化时该指令触发显示或隐藏的过渡效果

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

2.2.4 v-if

v-if用于根据表达式的真假值来有条件地渲染元素

与v-show相比，v-if在切换时是元素的销毁或重建，而不是简单的显示隐藏

可以看到当表达式为假时，v-if是直接销毁元素，而v-show只是视觉上隐藏了而已

并且v-if可以是 <template></template>，如果元素是 <template></template>，将提取它的内容作为条件块

2.2.5 v-else

v-else无需表达式，表示添加一个“else 块”，相当于v-if满足条件时展示v-if的元素，否则展示v-else的元素，例如：

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

2.2.6 v-else-if

同理，表示 v-if 的“else if 块”，和v-else一样，前一个兄弟元素必须有v-if或 v-else-if，例如：

2.2.7 v-for

v-for一个用于迭代的指令，可以根据源数据多次渲染元素或模板块，例如：

也可以为数组索引指定别名或者用于对象的键

<div></div>
<div></div>
<div></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></button>

需要注意，用在普通元素上时，只能监听原生 DOM 事件。用在自定义元素组件上时，也可以监听子组件触发的自定义事件

2.2.9 v-bind

v-bind用于绑定数据和元素属性，可以缩写为: 或.(当使用 .prop 修饰符时)，比如

<div></div>
<!-- 相当于 -->
<div></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限制于：&lt;input&gt;<select></select><textarea></textarea>components

v-model的3个修饰符：

• .lazy - 惰性更新，监听 change 而不是 input 事件
• .number - 输入字符串转为有效的数字
• .trim - 输入首尾空格过滤

在表单控件或者组件上可以创建双向绑定，例如：

2.2.11 v-slot

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

可选择性传递参数，表示插槽名，默认值default

2.2.12 v-pre

v-pre指令用于跳过这个元素及其子元素的编译过程，例如:

可以看到里头的东西没有被编译

2.2.13 v-cloak

v-cloak指令主要用于解决插值表达式在页面闪烁问题

<div>
  {{ message }}
</div>

[v-cloak] {
  display: none;
}

这样div只会在编译结束后显示

2.2.14 v-once

v-once指令用于表示只渲染一次，当要重新渲染，元素/组件及其所有的子节点将被视为静态内容并跳过

2.2.15 v-memo 3.2+

用于缓存一个模板的子树

该指令接收一个固定长度的数组作为依赖值进行记忆比对。如果数组中的每个值都和上次渲染的时候相同，则整个该子树的更新会被跳过

<div></div>

在重新渲染时，如果 valueA 与 valueB 都维持不变，那么对这个 <div> 以及它的所有子节点的更新都将被跳过<h4 id="strong-v-is-strong"><strong>2.2.16 v-is</strong></h4> <p>已在 3.1.0 中废弃，改用<code>:is

<component></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>

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启动项目

当然你也可以用其他方

我们知道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')

使用也很简单，如下

结果如图：

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')

刷新之后，结果还是一样

好处是，以后再写自定义指令就方便太多了

（学习视频分享：web前端入门、vue视频教程）

以上がvueディレクティブとは何ですか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。