模板语法
Vue.js 使用了基于 HTML 的模板语法,允许开发者声明式地将 DOM 绑定至底层 Vue 实例的数据。所有 Vue.js 的模板都是合法的 HTML,所以能被遵循规范的浏览器和 HTML 解析器解析。
在底层的实现上,Vue 将模板编译成虚拟 DOM 渲染函数。结合响应系统,Vue 能够智能地计算出最少需要重新渲染多少组件,并把 DOM 操作次数减到最少。
如果你熟悉虚拟 DOM 并且偏爱 JavaScript 的原始力量,你也可以不用模板,直接写渲染 (render) 函数,使用可选的 JSX 语法。
插值
文本
数据绑定最常见的形式就是使用“Mustache”语法 (双大括号) 的文本插值:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>文本</title>
<script src="./vue.js"></script>
</head>
<body>
<div id="hzh">
<div>{{hzh1}}</div>
<div>{{hzh2}}</div>
<div>{{hzh3}}</div>
<div>{{hzh4}}</div>
<div>{{hzh5}}</div>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
hzh1: "hzh1 = 黄子涵",
hzh2: "hzh2 = 黄子涵是帅哥!",
hzh3: "hzh3 = 黄子涵是靓仔!",
hzh4: "hzh4 = 黄子涵真聪明!",
hzh5: "hzh5 = 黄子涵真厉害!",
},
})
</script>
</body>
</html>
Mustache 标签将会被替代为对应数据对象上
msg
property 的值。无论何时,绑定的数据对象上msg
property 发生了改变,插值处的内容都会更新。
通过使用 v-once 指令,你也能执行一次性地插值,当数据改变时,插值处的内容不会更新。但请留心这会影响到该节点上的其它数据绑定:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>文本</title>
<script src="./vue.js"></script>
</head>
<body>
<div id="hzh">
<h1>{{original}}</h1>
<h2 v-once> {{hzh1}}</h2>
<h2 v-once> {{hzh2}}</h2>
<h1>{{contrast}}</h1>
<h2> {{hzh3}}</h2>
<h2> {{hzh4}}</h2>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
original: "原实验组(加v-once):",
hzh1: " 黄子涵",
hzh2: "黄子涵真聪明!",
contrast: "对照组(不加v-once):",
hzh3: "尤雨溪",
hzh4: "尤雨溪真厉害!",
},
})
</script>
</body>
</html>
原始 HTML
双大括号会将数据解释为普通文本,而非 HTML 代码。为了输出真正的 HTML,你需要使用
v-html
指令:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>原始HTML</title>
<script src="./vue.js"></script>
</head>
<body>
<div id="hzh">
<h1>使用插值语法:{{hzh1}}</h1>
<h1>使用v-html指令:<span v-html="hzh1">这应该是红色的</span></h1>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
hzh1: '<span style="color: red">这应该是红色的</span>',
},
})
</script>
</body>
</html>
这个
span
的内容将会被替换成为 property 值hzh1
,直接作为 HTML——会忽略解析 property 值中的数据绑定。注意,你不能使用hzh1
来复合局部模板,因为 Vue 不是基于字符串的模板引擎。反之,对于用户界面 (UI),组件更适合作为可重用和可组合的基本单位。
你的站点上动态渲染的任意 HTML 可能会非常危险,因为它很容易导致 XSS攻击。请只对可信内容使用 HTML 插值,绝不要对用户提供的内容使用插值。
Attribute
Mustache 语法不能作用在 HTML attribute 上,遇到这种情况应该使用
v-bind
指令:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>指令</title>
<script src="./vue.js"></script>
<style>
#hzh0 {
color: red;
}
#hzh1 {
color: orange;
}
#hzh2 {
color: yellow;
}
#hzh3 {
color: green;
}
#hzh4 {
color: cyan;
}
#hzh5 {
color: blue;
}
#hzh6 {
color: purple;
}
#hzh7 {
color: pink;
}
#hzh8 {
color: gold;
}
#hzh9 {
color: skyblue;
}
</style>
</head>
<body>
<div id="hzh">
<button v-on:click="btn">按钮</button>
<h1 v-bind:id="hzh1">黄子涵</h1>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
hzh0: "hzh0",
hzh1: "hzh1",
hzh2: "hzh2",
hzh3: "hzh3",
hzh4: "hzh4",
hzh5: "hzh5",
hzh6: "hzh6",
hzh7: "hzh7",
hzh8: "hzh8",
hzh9: "hzh9",
},
methods: {
btn: function() {
return (this.hzh1 = ("hzh" + Math.floor(Math.random()*10)))
}
},
})
</script>
</body>
</html>
对于布尔 attribute (它们只要存在就意味着值为
true
),v-bind
工作起来略有不同,在这个例子中:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>指令</title>
<script src="./vue.js"></script>
</head>
<body>
<div id="hzh">
<button v-on:click="btn">激活/关闭黄子涵</button>
<button v-bind:disabled="isButtonDisabled">黄子涵</button>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
isButtonDisabled: false,
},
methods: {
btn: function() {
return (this.isButtonDisabled = (!this.isButtonDisabled))
}
},
})
</script>
</body>
</html>
如果
isButtonDisabled
的值是null
、undefined
或false
,则disabled
attribute 甚至不会被包含在渲染出来的<button>
元素中。
使用 JavaScript 表达式
迄今为止,在我们的模板中,我们一直都只绑定简单的 property 键值。但实际上,对于所有的数据绑定,Vue.js 都提供了完全的 JavaScript 表达式支持。
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>使用 JavaScript 表达式</title>
<script src="./vue.js"></script>
<style>
#hzh-HZH {
color: red;
}
</style>
</head>
<body>
<div id="hzh">
<h1>{{hzh1 + 1}}</h1>
<h1>{{ok ? 'YES' : 'NO'}}</h1>
<h1>{{hzh2.split('').reverse().join('')}}</h1>
<h1 v-bind:id="'hzh-' + id">黄子涵</h1>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
ok: 0,
hzh1: 2,
hzh2: 'huangzihan',
id: 'HZH',
},
})
</script>
</body>
</html>
这些表达式会在所属 Vue 实例的数据作用域下作为 JavaScript 被解析。有个限制就是,每个绑定都只能包含单个表达式,所以下面的例子都不会生效。
<!-- 这是语句,不是表达式 -->
{{ var a = 1 }}
<!-- 流控制也不会生效,请使用三元表达式 -->
{{ if (ok) { return message } }}
模板表达式都被放在沙盒中,只能访问全局变量的一个白名单,如
Math
和Date
。你不应该在模板表达式中试图访问用户定义的全局变量。
指令
指令 (Directives) 是带有
v-
前缀的特殊 attribute。指令 attribute 的值预期是单个 JavaScript 表达式 (v-for
是例外情况,稍后我们再讨论)。指令的职责是,当表达式的值改变时,将其产生的连带影响,响应式地作用于 DOM。
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>指令</title>
<script src="./vue.js"></script>
</head>
<body>
<div id="hzh">
<h1 v-if="hzh1">黄子涵是帅哥!</h1>
<h1 v-if="hzh2">黄子涵是靓仔!</h1>
<h1 v-if="hzh3">黄子涵真厉害!</h1>
<h1 v-if="hzh4">黄子涵真聪明!</h1>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
hzh1: true,
hzh2: false,
hzh3: true,
hzh4: false,
},
})
</script>
</body>
</html>
这里,
v-if
指令将根据表达式hzh*
的值的真假来插入/移除<h1>
元素。
参数
一些指令能够接收一个“参数”,在指令名称之后以冒号表示。例如,
v-bind
指令可以用于响应式地更新 HTML attribute:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>指令</title>
<script src="./vue.js"></script>
<style>
a {
text-decoration: none;
}
</style>
</head>
<body>
<div id="hzh">
<a v-bind:href="hzh1">百度</a></br>
<a v-bind:href="hzh2">阿里巴巴集团</a></br>
<a v-bind:href="hzh3">腾讯</a></br>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
hzh1: 'https://www.baidu.com',
hzh2: 'https://www.alibabagroup.com/cn/global/home',
hzh3: 'https://www.tencent.com/zh-cn/',
},
})
</script>
</body>
</html>
在这里
href
是参数,告知v-bind
指令将该元素的href
attribute 与表达式url
的值绑定。
另一个例子是
v-on
指令,它用于监听 DOM 事件:
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>指令</title>
<script src="./vue.js"></script>
<style>
a {
text-decoration: none;
}
</style>
</head>
<body>
<div id="hzh">
<button v-on:click="hzh11">hzh11</button><span v-if="hzh12">黄子涵是帅哥!</span></br>
<button v-on:click="hzh21">hzh21</button><span v-if="hzh22">黄子涵是靓仔!</span></br>
<button v-on:click="hzh31">hzh31</button><span v-if="hzh32">黄子涵真聪明!</span></br>
</div>
<script>
var vm = new Vue({
el: '#hzh',
data: {
hzh12: true,
hzh22: true,
hzh32: true,
},
methods: {
hzh11() {
return this.hzh12 = !(this.hzh12)
},
hzh21() {
return this.hzh22 = !(this.hzh22)
},
hzh31() {
return this.hzh32 = !(this.hzh32)
}
},
})
</script>
</body>
</html>
在这里参数是监听的事件名。
动态参数
从 2.6.0 开始,可以用方括号括起来的 JavaScript 表达式作为一个指令的参数:
<a v-bind:[attributeName]="url"> ... </a>
这里的
attributeName
会被作为一个 JavaScript 表达式进行动态求值,求得的值将会作为最终的参数来使用。例如,如果你的 Vue 实例有一个data
propertyattributeName
,其值为"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()
:
v-on 修饰符
.stop
- 调用event.stopPropagation()
。.prevent
- 调用event.preventDefault()
。.capture
- 添加事件侦听器时使用 capture 模式。.self
- 只当事件是从侦听器绑定的元素本身触发时才触发回调。.{keyCode | keyAlias}
- 只当事件是从特定键触发时才触发回调。.native
- 监听组件根元素的原生事件。.once
- 只触发一次回调。.left
- (2.2.0) 只当点击鼠标左键时触发。.right
- (2.2.0) 只当点击鼠标右键时触发。.middle
- (2.2.0) 只当点击鼠标中键时触发。.passive
- (2.3.0) 以{ passive: true }
模式添加侦听器
缩写
v-
前缀作为一种视觉提示,用来识别模板中 Vue 特定的 attribute。当你在使用 Vue.js 为现有标签添加动态行为 (dynamic behavior) 时,v-
前缀很有帮助,然而,对于一些频繁用到的指令来说,就会感到使用繁琐。同时,在构建由 Vue 管理所有模板的单页面应用程序 (SPA - single page application) 时,v-
前缀也变得没那么重要了。因此,Vue 为v-bind
和v-on
这两个最常用的指令,提供了特定简写:
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 的浏览器都能被正确地解析。而且,它们不会出现在最终渲染的标记中。