Vue：模板语法-指令和缩写

最新推荐文章于 2025-05-22 21:41:01 发布

原创最新推荐文章于 2025-05-22 21:41:01 发布 · 1.1k 阅读

26 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

Vue

一、指令简介

指令 (Directives) 是带有 v- 前缀的特殊 attribute。指令 attribute 的值预期是单个 JavaScript 表达式 (v-for 是例外情况，稍后我们再讨论)。指令的职责是，当表达式的值改变时，将其产生的连带影响，响应式地作用于 DOM。回顾我们在介绍中看到的例子：

<p v-if="seen">现在你看到我了</p>

这里，v-if 指令将根据表达式 seen 的值的真假来插入/移除 <p> 元素。

二、参数

一些指令能够接收一个“参数”，在指令名称之后以冒号表示。例如，v-bind 指令可以用于响应式地更新 HTML attribute：

<a v-bind:href="url">...</a>

在这里 href 是参数，告知 v-bind 指令将该元素的 href attribute 与表达式 url 的值绑定。
另一个例子是 v-on 指令，它用于监听 DOM 事件：

<a v-on:click="doSomething">...</a>

在这里参数是监听的事件名。我们也会更详细地讨论事件处理。

三、动态参数（2.6.0 新增）

从 2.6.0 开始，可以用方括号括起来的 JavaScript 表达式作为一个指令的参数：

<!--
注意，参数表达式的写法存在一些约束，如之后的“对动态参数表达式的约束”章节所述。
-->
<a v-bind:[attributeName]="url"> ... </a>

这里的 attributeName 会被作为一个 JavaScript 表达式进行动态求值，求得的值将会作为最终的参数来使用。例如，如果你的 Vue 实例有一个 data property attributeName，其值为 “href”，那么这个绑定将等价于 v-bind:href。

同样地，你可以使用动态参数为一个动态的事件名绑定处理函数：

<a v-on:[eventName]="doSomething"> ... </a>

在这个示例中，当 eventName 的值为 “focus” 时，v-on:[eventName] 将等价于 v-on:focus。

对动态参数的值的约束
动态参数预期会求出一个字符串，异常情况下值为 null。这个特殊的 null 值可以被显性地用于移除绑定。任何其它非字符串类型的值都将会触发一个警告。

对动态参数表达式的约束
动态参数表达式有一些语法约束，因为某些字符，如空格和引号，放在 HTML attribute 名里是无效的。例如：

<!-- 这会触发一个编译警告 -->
<a v-bind:['foo' + bar]="value"> ... </a>

变通的办法是使用没有空格或引号的表达式，或用计算属性替代这种复杂表达式。

在 DOM 中使用模板时 (直接在一个 HTML 文件里撰写模板)，还需要避免使用大写字符来命名键名，因为浏览器会把 attribute 名全部强制转为小写：

<!--
在 DOM 中使用模板时这段代码会被转换为 `v-bind:[someattr]`。
除非在实例中有一个名为“someattr”的 property，否则代码不会工作。
-->
<a v-bind:[someAttr]="value"> ... </a>

四、修饰符

修饰符 (modifier) 是以半角句号 . 指明的特殊后缀，用于指出一个指令应该以特殊方式绑定。例如，.prevent 修饰符告诉 v-on 指令对于触发的事件调用 event.preventDefault()：

<form v-on:submit.prevent="onSubmit">...</form>

在接下来对 v-on 和 v-for 等功能的探索中，你会看到修饰符的其它例子。

五、缩写简介

v- 前缀作为一种视觉提示，用来识别模板中 Vue 特定的 attribute。当你在使用 Vue.js 为现有标签添加动态行为 (dynamic behavior) 时，v- 前缀很有帮助，然而，对于一些频繁用到的指令来说，就会感到使用繁琐。同时，在构建由 Vue 管理所有模板的单页面应用程序 (SPA - single page application) 时，v- 前缀也变得没那么重要了。因此，Vue 为 v-bind 和 v-on 这两个最常用的指令，提供了特定简写：

5.1 v-bind 缩写

<!-- 完整语法 -->
<a v-bind:href="url">...</a>

<!-- 缩写 -->
<a :href="url">...</a>

<!-- 动态参数的缩写 (2.6.0+) -->
<a :[key]="url"> ... </a>

5.2 v-on 缩写

<!-- 完整语法 -->
<a v-on:click="doSomething">...</a>

<!-- 缩写 -->
<a @click="doSomething">...</a>

<!-- 动态参数的缩写 (2.6.0+) -->
<a @[event]="doSomething"> ... </a>

它们看起来可能与普通的 HTML 略有不同，但 : 与 @ 对于 attribute 名来说都是合法字符，在所有支持 Vue 的浏览器都能被正确地解析。而且，它们不会出现在最终渲染的标记中。缩写语法是完全可选的，但随着你更深入地了解它们的作用，你会庆幸拥有它们。

六、效果图

七、代码

<!DOCTYPE html>
<html>
	<head>
		<meta charset="utf-8">
		<title>模板语法--指令</title>
		<script src="../../vue.js" type="text/javascript">

		</script>
	</head>
	<body>
		<!-- 
		 指令 (Directives) 是带有 v- 前缀的特殊 attribute。指令 attribute 的值预期是单个 JavaScript 表达式 (v-for 是例外情况，稍后我们再讨论)。指令的职责是，当表达式的值改变时，将其产生的连带影响，响应式地作用于 DOM。回顾我们在介绍中看到的例子：
		 
		 <p v-if="seen">现在你看到我了</p>
		 这里，v-if 指令将根据表达式 seen 的值的真假来插入/移除 <p> 元素。
		 
		 参数
		 一些指令能够接收一个“参数”，在指令名称之后以冒号表示。例如，v-bind 指令可以用于响应式地更新 HTML attribute：
		 
		 <a v-bind:href="url">...</a>
		 在这里 href 是参数，告知 v-bind 指令将该元素的 href attribute 与表达式 url 的值绑定。
		 
		 另一个例子是 v-on 指令，它用于监听 DOM 事件：
		 
		 <a v-on:click="doSomething">...</a>
		 在这里参数是监听的事件名。我们也会更详细地讨论事件处理。
		 
		 -->
		<div id="vm1">
			{{message}}

			<p v-if="seen">现在看到我了</p>

			<a v-bind:href="url">点击查看模板语法--指令文档</a>

			<div v-on:click=""></div>
			<div @click="click1">
				<!-- click2 和 click事件都会被执行 -->
				<!-- <div @click="click2">
					click me
				</div> -->
				
				<!-- 
				 
				修饰符
				修饰符 (modifier) 是以半角句号 . 指明的特殊后缀，用于指出一个指令应该以特殊方式绑定。例如，.prevent 修饰符告诉 v-on 指令对于触发的事件调用 event.preventDefault()：
				
				<form v-on:submit.prevent="onSubmit">...</form>
				在接下来对 v-on 和 v-for 等功能的探索中，你会看到修饰符的其它例子。
				 
				 -->
				<!-- 
				 @click.stop当前事件执行完会立刻停下来
				 -->
				<div @click.stop="click2"><!-- 只会执行 click2事件 -->
					click me
				</div>
			</div>
			
			<!-- 
			 
			 v-bind 缩写
			 -- 完整语法 --
			 <a v-bind:href="url">...</a>
			 
			 -- 缩写 --
			 <a :href="url">...</a>
			 
			 -- 动态参数的缩写 (2.6.0+) --
			 <a :[key]="url"> ... </a>
			 v-on 缩写
			 -- 完整语法 --
			 <a v-on:click="doSomething">...</a>
			 
			 -- 缩写 -
			 <a @click="doSomething">...</a>
			 
			动态参数的缩写 (2.6.0+) 
			 <a @[event]="doSomething"> ... </a>
			 它们看起来可能与普通的 HTML 略有不同，但 : 与 @ 对于 attribute 名来说都是合法字符，在所有支持 Vue 的浏览器都能被正确地解析。而且，它们不会出现在最终渲染的标记中。缩写语法是完全可选的
			 
			 -->

		</div>
		<script>
			
			var data = {
				message: '模板语法--指令和缩写',
				seen: true, // false
				url: 'https://cn.vuejs.org/v2/guide/syntax.html#%E4%BD%BF%E7%94%A8-JavaScript-%E8%A1%A8%E8%BE%BE%E5%BC%8F'

			}
			
			var clickFun = function(actionName){
				console.log(actionName)
			}

			var vm1 = new Vue({
				el: '#vm1',
				data: data,
				methods: {
					click1: function(){
						console.log('click 2 事件')
					},
					click2:function(){
						console.log('click 2 事件')
					},
				}
			})
		</script>
	</body>
</html>