Vue 的指令
一、Vue 的指令
1 指令的概念
指令(Directives)是 vue 为开发者提供的模板语法,用于辅助开发者渲染页面的基本结构。
vue 中的指令按照不同的用途可以分为如下 6 大类:
- 内容渲染指令
- 属性绑定指令
- 事件绑定指令
- 双向绑定指令
- 条件渲染指令
- 列表渲染指令
注意:指令是 vue 开发中最基础、最常用、最简单的知识点。
2 内容渲染指令
内容渲染指令用来辅助开发者渲染 DOM 元素的文本内容。常用的内容渲染指令有如下 3 个:
2.1 v-text
用法示例:
<div id="app">
<!-- 把 username 对应的值,渲染到第一个p标签中 -->
<p v-text="username"></p>
<!-- 注意:第二个p标签中,默认的文本“性别”会被 gender 的值覆盖掉 -->
<p v-text="gender">性别</p>
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
username: "hhh",
gender: "女",
},
});
</script>
注意:v-text 指令会覆盖元素内默认的值。
2.2 {{}} 语法
vue 提供的 {{ }} 语法,专门用来解决 v-text 会覆盖默认文本内容的问题。这种 {{ }} 语法的专业名称是插值表达 式(英文名为:Mustache)。
- 使用 {{}} 插值表达式,将对应的值渲染到元素的内容节点中,同时保留元素自身的默认值
用法示例:
<p> 姓名:{{username}} </p>
<p> 性别:{{gender}} </p>
注意:相对于 v-text 指令来说,插值表达式在开发中更常用一些!因为它不会覆盖元素中默认的文本内容。
2.3 v-html
v-text 指令和插值表达式只能渲染纯文本内容。如果要把包含 HTML 标签的字符串渲染为页面的 HTML 元素, 则需要用到 v-html 这个指令:
<div id="app">
<p v-html="discription"></p>
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
discription: "<h5 style='color:red;'>123456789</h5>",
},
});
</script>
渲染结果:
3 属性绑定指令
如果需要为元素的属性动态绑定属性值,则需要用到 v-bind 属性
绑定指令。用法示例如下:
<div id="app">
<input type="text" v-bind:placeholder="inputValue" />
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
inputValue: "请输入内容",
},
});
</script>
属性绑定指令的简写形式
由于 v-bind 指令在开发中使用频率非常高,因此,vue 官方为其提供了简写形式(简写为英文的 :
)
4 事件绑定指令
4.1 v-on
vue 提供了 v-on
事件绑定指令,用来辅助程序员为 DOM 元素绑定事件监听。语法格式如下:
<div id="app">
<h3>count 的值为:{{count}}</h3>
<!-- 语法格式: v-on:事件名称="事件处理函数的名称" -->
<button v-on:click="add">+1</button>
</div>
注意:原生 DOM 对象有 onclick、oninput、onkeyup 等原生事件,替换为 vue 的事件绑定形式后, 分别为:v-on:click
、v-on:input
、v-on:keyup
通过 v-on 绑定的事件处理函数,需要在 methods
节点中进行声明:
const vm=new Vue({
el:"#app",
data:{
count:0
},
methods:{
add(){
//this表示当前new出来的vm实例对象
this.count+=1
}
}
})
事件绑定的简写形式
由于 v-on 指令在开发中使用频率非常高,因此,vue 官方为其提供了简写形式(简写为英文的 @
)
4.2 事件参数对象
在原生的 DOM 事件绑定中,可以在事件处理函数的形参处,接收事件参数对象 event。同理,在 v-on 指令 (简写为 @ )所绑定的事件处理函数中,同样可以接收到事件参数对象 event,示例代码如下:
<div id="app">
<h3>count 的值为:{{count}}</h3>
<button v-on:click="add">+1</button>
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
count:0
},
methods: {
add(e){
const nowCgColor=e.target.style.backgroundColor
e.target.style.backgroundColor=nowCgColor==="red"?"":"red"
this.count+=1
}
},
});
</script>
4.3 绑定事件并传参
在使用 v-on 指令绑定事件时,可以使用 ( ) 进行传参,示例代码如下:
<div id="app">
<h3>count 的值为:{{count}}</h3>
<button v-on:click="add(2)">+2</button>
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
count:0
},
methods: {
add(step){
this.count+=step
}
},
});
</script>
4.4 $event
e
v
e
n
t
是
v
u
e
提
供
的
特
殊
变
量
,
用
来
表
示
原
生
的
事
件
参
数
对
象
e
v
e
n
t
。
event 是 vue 提供的特殊变量,用来表示原生的事件参数对象 event。
event是vue提供的特殊变量,用来表示原生的事件参数对象event。event 可以解决事件参数对象 event 被覆盖的问题。示例用法如下:
<div id="app">
<h3>count 的值为:{{count}}</h3>
<button v-on:click="add(2,$event)">+2</button>
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
count:0
},
methods: {
add(step,e){
const nowCgColor=e.target.style.backgroundColor
e.target.style.backgroundColor=nowCgColor==="red"?"":"red"
this.count+=step
}
},
});
</script>
4.5 事件修饰符
在事件处理函数中调用 event.preventDefault()
或 event.stopPropagation()
是非常常见的需求。因此, vue 提供了事件修饰符的概念,来辅助程序员更方便的对事件的触发进行控制。常用的 5 个事件修饰符如下:
事件修饰符 |
说明 |
.prevent |
阻止默认行为(例如:阻止 a 连接的跳转、阻止表单的提交等) |
.stop |
阻止事件冒泡 |
.capture |
以捕获模式触发当前的事件处理函数 |
.once |
绑定的事件只触发1次 |
.self |
只有在 event.target 是当前元素自身时触发事件处理函数 |
语法格式:
//触发click点击事件时,阻止a链接的默认跳转行为
<a href="https://www.baidu.com" @click.prevent="onLinkClick">百度首页</a>
4.6 按键修饰符
在监听键盘事件时,我们经常需要判断详细的按键。此时,可以为键盘相关的事件添加按键修饰符,例如:
//只有在"key"是"Enter"时调用"vm.submit()"
<input @keyup.enter="submit">
//只有在"key"是"Esc"时调用"vm.clearInput()"
<input @keyup.esc="clearInput">
5 双向绑定指令
5.1 v-model
vue 提供了 v-model
双向数据绑定指令,用来辅助开发者在不操作 DOM 的前提下,快速获取表单的数据。
<p>用户名是:{{username}}</p>
<input type="text" v-model="username">
<p>选中的省份是:{{province}}</p>
<section v-model="province">
<option value="">请选择</option>
<option value="1">北京</option>
<option value="2">河北</option>
<option value="3">黑龙江</option>
</section>
5.2 v-model 指令的修饰符
为了方便对用户输入的内容进行处理,vue 为 v-model 指令提供了 3 个修饰符,分别是:
修饰符 |
作用 |
示例 |
.number |
自动将用户的输入值转为数值类型 |
|
用法示例:
<input type="text" v-model.number="n1">+
<input type="text" v-model.number="n1">=
<span>{{n1+n2}}</span>
6 条件渲染指令
6.1 v-if v-show
条件渲染指令用来辅助开发者按需控制 DOM 的显示与隐藏。条件渲染指令有如下两个,分别是:
用法示例:
<div id="app">
<p v-if="networkState===200">请求成功---被v-if控制</p>
<p v-show="networkState===200">请求成功---被v-show控制</p>
</div>
v-if 和 v-show 的区别
6.2 v-else
v-if 可以单独使用,或配合 v-else 指令一起使用:
<div v-if="Math.random()>0.5">
随机数大于0.5
</div>
<div v-else>
随机数小于0.5
</div>
注意:v-else 指令必须配合 v-if 指令一起使用,否则它将不会被识别
6.3 v-else-if
v-else-if 指令,顾名思义,充当 v-if 的“else-if 块”,可以连续使用:
<div v-if="type==='A'">优秀</div>
<div v-else-if="type==='B'">良好</div>
<div v-else-if="type==='C'">一般</div>
<div v-else>差</div>
7 列表渲染指令
7.1 v-for
vue 提供了 v-for
列表渲染指令,用来辅助开发者基于一个数组来循环渲染一个列表结构。v-for 指令需要使用 item in items
形式的特殊语法,其中:
- items 是待循环的数组
- item 是被循环的每一项
<div id="app">
<ul>
<li v-for="item in list">姓名是:{{item.name}}</li>
</ul>
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
list: [
{ id: 1, name: "zs" },
{ id: 2, name: "sm" },
],
},
});
</script>
7.2 v-for 中的指令
v-for 指令还支持一个可选的第二个参数,即当前项的索引。语法格式为 (item, index) in items
,示例代码如下:
<div id="app">
<ul>
<li v-for="(item,index) in list">
索引号:{{index}},姓名是:{{item.name}}
</li>
</ul>
</div>
<script>
const vm = new Vue({
el: "#app",
data: {
list: [
{ id: 1, name: "zs" },
{ id: 2, name: "sm" },
],
},
});
</script>
注意:v-for 指令中的 item 项和 index 索引都是形参,可以根据需要进行重命名。例如 (user, i) in userlist
7.3 使用key维护列表的状态
当列表的数据变化时,默认情况下,vue 会尽可能的复用已存在的 DOM 元素,从而提升渲染的性能。但这种 默认的性能优化策略,会导致有状态的列表无法被正确更新。
为了给 vue 一个提示,以便它能跟踪每个节点的身份,从而在保证有状态的列表被正确更新的前提下,提升渲 染的性能。此时,需要为每项提供一个唯一的 key 属性:
<ul>
<li v-for="user in userlist" ::key="user.id">
<input type="checkbox">
姓名:{{user.name}}
</li>
</ul>
key 的注意事项:
① key 的值只能是字符串或数字类型
② key 的值必须具有唯一性(即:key 的值不能重复)
③ 建议把数据项 id 属性的值作为 key 的值(因为 id 属性的值具有唯一性)
④ 使用 index 的值当作 key 的值没有任何意义(因为 index 的值不具有唯一性)
⑤ 建议使用 v-for 指令时一定要指定 key 的值(既提升性能、又防止列表状态紊乱)