在vue中,指令是帶有「v-」前綴的特殊特性(屬性),指令特性的值預期是單一JavaScript表達式,語法為「v-指令:參數="表達式" 」。 Vue作用在HTML元素,指令提供了一些特殊的特性,將指令綁定在元素上時,指令會為綁定的目標元素添加一些特殊的行為;因此可以將指令看作特殊的HTML特性。
本教學操作環境:windows7系統、vue3版,DELL G3電腦。
Vue.js指令 (Directives) 是帶有 v- 前綴的特殊特性。指令特性的值預期是單一 JavaScript 表達式 (v-for 是例外)。
Vue.js作用於HTML元素,當指令提供了一些特殊的特性,將指令綁定在元素上時,指令會為綁定的目標元素添加一些特殊的行為,我們可以將指令看作特殊的HTML特性(attribute)。
指令的作用是:當表達式的值改變時,將其產生的連帶影響,響應式地作用於 DOM。
每個指令都有自己的用途,當其綁定的表達式發生改變的時候,會響應式的影響dom的變化。而變化的具體則是看每個指令本身的用途。例如v-bind指令是綁定屬性值,當綁定的表達式改變,dom上屬性的值也會發生對應的改變。
指令的語法是:v-指令:參數="表達式"
(參數並不是絕對需要的)
參數
:
後面跟著的是參數,但不一定所有的指令都會有參數,只有特定的指令會需要參數,這是由於指令的性質決定的。這裡的參數和函數的參數是類似的,就好比我這個指令需要對應的參數才能讓功能生效。
拿v-bind:type="type"
來說,v-bind
指令用來綁定屬性值,那麼需要綁定什麼屬性呢,光靠這個指令無法確定,所以需要參數來進一步確定。也就是v-bind:type
,冒號後面跟著的type
就是傳入指令中的參數。告訴指令,我要綁定屬性type
和表達式的關聯。
上面我們也說了,並不是所有的指令都需要參數。例如v-html
指令,這個指令是綁定元素內部的html
,功能點已經非常明確,不需要額外的參數去確定,只需要指令和表達式即可完成指令的功能。
表達式
""
引號內的值就是表達式,而表達式一般可以是一個可執行的js表達式。它與指令本身是有綁定關聯的,類似傳入指令的值。且當表達式內的響應式資料發生變化,也會引發dom的變化。
內建指令指的就是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
中廢棄
下面我們來了解這些內建指令的基本使用
v-text的作用是,用於更新元素的
textContent,例如:
<h1></h1>
h1 元素的內容最終取決於
msg的值
v-text很像,只是
v-html用於更新元素的
innerHTML,例如
<div>Hello LBJ'"></div>
HTML 插入
v-show可以根據表達式的真假值,切換元素的
display值,用於控制元素的展示和隱藏,例如:
可以看到,当条件变化时该指令触发显示或隐藏的过渡效果
需要注意:v-show
不支持 <template></template>
元素,也不支持 v-else
v-if
用于根据表达式的真假值来有条件地渲染元素
与v-show
相比,v-if
在切换时是元素的销毁或重建,而不是简单的显示隐藏
可以看到当表达式为假时,v-if是直接销毁元素,而v-show只是视觉上隐藏了而已
并且v-if
可以是 <template></template>
,如果元素是 <template></template>
,将提取它的内容作为条件块
v-else
无需表达式,表示添加一个“else
块”,相当于v-if满足条件时展示v-if的元素,否则展示v-else的元素,例如:
需要注意:v-else
前一个兄弟元素必须有 v-if
或 v-else-if
同理,表示 v-if
的“else if 块”,和v-else
一样,前一个兄弟元素必须有v-if
或 v-else-if
,例如:
v-for
一个用于迭代的指令,可以根据源数据多次渲染元素或模板块,例如:
也可以为数组索引指定别名或者用于对象的键
<div></div> <div></div> <div></div>
v-on
用于给元素绑定事件,可以缩写为:@
修饰符
例如:
<!-- 停止冒泡 --> <button></button>
需要注意,用在普通元素上时,只能监听原生 DOM 事件。用在自定义元素组件上时,也可以监听子组件触发的自定义事件
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+v-model
限制于:<input>
<select></select>
<textarea></textarea>
components
v-model
的3
个修饰符:
.lazy
- 惰性更新,监听 change 而不是 input 事件.number
- 输入字符串转为有效的数字.trim
- 输入首尾空格过滤在表单控件或者组件上可以创建双向绑定,例如:
v-slot
用于提供具名插槽或需要接收 prop 的插槽
可选择性传递参数,表示插槽名,默认值default
v-pre
指令用于跳过这个元素及其子元素的编译过程,例如:
可以看到里头的东西没有被编译
v-cloak
指令主要用于解决插值表达式在页面闪烁问题
<div> {{ message }} </div>
[v-cloak] { display: none; }
这样div
只会在编译结束后显示
v-once
指令用于表示只渲染一次,当要重新渲染,元素/组件及其所有的子节点将被视为静态内容并跳过
用于缓存一个模板的子树
该指令接收一个固定长度的数组作为依赖值进行记忆比对。如果数组中的每个值都和上次渲染的时候相同,则整个该子树的更新会被跳过
<div></div>
在重新渲染时,如果 valueA
与 valueB
都维持不变,那么对这个 <div> 以及它的所有子节点的更新都将被跳过<h4 data-id="heading-23"><strong>2.2.16 v-is</strong></h4>
<p>已在 3.1.0 中废弃,改用<code>:is
<component></component>
前言部分我们也说了,在Vue3
中可以通过应用实例身上的directive()
注册一个全局自定义指令。例如官方给的一个例子
const app = Vue.createApp({}) // 注册一个全局自定义指令 `v-focus` app.directive('focus', { // 当被绑定的元素挂载到 DOM 中时…… mounted(el) { // 聚焦元素 el.focus() } })
上述代码中,通过Vue.createApp({})
得到应用实例app
,应用实例app
身上有个directive()
,用于创建一个全局的自定义指令
用的时候也非常简单,例如
<input>
如果想注册局部指令,可在组件中配置directives
选项来注册局部指令;还是以v-focus
为例:
directives: { focus: { // 指令的定义 mounted(el) { el.focus() } } }
通过上述例子,我们可以看到不管是使用directive
自定义全局指令,还是使用directives
配置局部指令,里头都需要一个指令名,如focus
而具体的配置对象中的mounted
是啥?mounted
中的el
又是啥?除了mounted
还有啥,除了el
还有哪些参数?
开门见山,mounted
其实就是指令的钩子函数,表示组件被挂载后调用;el
则是指令绑定到的元素
这里主要讲讲钩子函数,除了mounted
以外,还有其他指令钩子,均为可选
created
:在绑定元素的 attribute 或事件监听器被应用之前调用beforeMount
:当指令第一次绑定到元素并且在挂载父组件之前调用mounted
:在绑定元素的父组件被挂载后调用beforeUpdate
:在更新包含组件的 VNode 之前调用updated
:在包含组件的 VNode及其子组件的 VNode更新后调用beforeUnmount
:在卸载绑定元素的父组件之前调用unmounted
:当指令与元素解除绑定且父组件已卸载时,只调用一次钩子函数的4个参数都是可选,分别是
el
:用于直接操作 DOM,表示指令绑定到的元素binding
对象:包含以下6个属性instance:使用指令的组件实例 value:传递给指令的值 oldValue:先前的值 arg:传递给指令的参数 modifiers:传递给指令的修饰符 dir:一个对象,其实就是注册指令时传递的配置对象
vnode
:虚拟DOM,一个真实 DOM 元素的蓝图,对应elprevNode
:上一个虚拟节点了解了基本知识,我们可以手动封装一个自定义指令v-pin
,表示将一个东西定在页面上
首先,使用vite
搭建Vue3
项目
npm init vite@latest
最后根据提示,使用npm run dev
启动项目
当然你也可以用其他方
我们知道Vue
自定义指令有全局注册和局部注册两种方式,为了方便,我就将v-pin
注册在全局
我要讲任意的定在指定的位置,比如将上图中的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')
使用也很简单,如下
结果如图:
为了方便以后注册更多的自定义指令,我们修改代码结构
首先,新创建一个专门用于放指令的文件夹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')
刷新之后,结果还是一样
好处是,以后再写自定义指令就方便太多了
以上是vue指令是啥的詳細內容。更多資訊請關注PHP中文網其他相關文章!