模板语法

    在底层的实现上,Vue 将模板编译成虚拟 DOM 渲染函数。结合响应系统,Vue 能够智能地计算出最少需要重新渲染多少组件,并把 DOM 操作次数减到最少。

    如果你熟悉虚拟 DOM 并且偏爱 JavaScript 的原始力量,你也可以不用模板,,使用可选的 JSX 语法。

    数据绑定最常见的形式就是使用“Mustache”语法 (双大括号) 的文本插值:

    Mustache 标签将会被替代为对应组件实例中 msg property 的值。无论何时,绑定的组件实例上 msg property 发生了改变,插值处的内容都会更新。

    通过使用 v-once 指令,你也能执行一次性地插值,当数据改变时,插值处的内容不会更新。但请留心这会影响到该节点上的其它数据绑定:

      原始 HTML

      双大括号会将数据解释为普通文本,而非 HTML 代码。为了输出真正的 HTML,你需要使用:

      1. <p>Using mustaches: {{ rawHtml }}</p>
      2. <p>Using v-html directive: <span v-html="rawHtml"></span></p>

      这个 span 的内容将会被替换成为 property 值 rawHtml,直接作为 HTML——会忽略解析 property 值中的数据绑定。注意,你不能使用 v-html 来复合局部模板,因为 Vue 不是基于字符串的模板引擎。反之,对于用户界面 (UI),组件更适合作为可重用和可组合的基本单位。

      TIP

      在你的站点上动态渲染任意的 HTML 是非常危险的,因为它很容易导致 XSS 攻击 (opens new window)。请只对可信内容使用 HTML 插值,绝不要将用户提供的内容作为插值。

      Attribute

      Mustache 语法不能在 HTML attribute 中使用 ,然而,可以使用 :

      1. <div v-bind:id="dynamicId"></div>
      1. <button v-bind:disabled="isButtonDisabled">按钮</button>

      如果 isButtonDisabled 的值是 nullundefined,则 disabled attribute 甚至不会被包含在渲染出来的 <button> 元素中。

      迄今为止,在我们的模板中,我们一直都只绑定简单的 property 键值。但实际上,对于所有的数据绑定,Vue.js 都提供了完全的 JavaScript 表达式支持。

      这些表达式会在当前活动实例的数据作用域下作为 JavaScript 被解析。有个限制就是,每个绑定都只能包含单个表达式,所以下面的例子都不会生效。

      1. <!-- 这是语句,不是表达式:-->
      2. {{ var a = 1 }}
      3. <!-- 流控制也不会生效,请使用三元表达式 -->
      4. {{ if (ok) { return message } }}

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

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

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

      参数

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

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

      在这里 href 是参数,告知 v-bind 指令将该元素的 href attribute 与表达式 url 的值绑定。

      另一个例子是 v-on 指令,它用于监听 DOM 事件:

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

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

      动态参数

      也可以在指令参数中使用 JavaScript 表达式,方法是用方括号括起来:

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

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

      在这个示例中,当 eventName 的值为 "focus" 时,v-on:[eventName] 将等价于 v-on:focus

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

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

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

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

      v-bind 缩写

      1. <!-- 完整语法 -->
      2. <a v-bind:href="url"> ... </a>
      3. <!-- 缩写 -->
      4. <a :href="url"> ... </a>
      5. <!-- 动态参数的缩写 -->
      6. <a :[key]="url"> ... </a>

      v-on 缩写

      1. <!-- 完整语法 -->
      2. <a v-on:click="doSomething"> ... </a>
      3. <!-- 缩写 -->
      4. <a @click="doSomething"> ... </a>
      5. <!-- 动态参数的缩写 (2.6.0+) -->
      6. <a @[event]="doSomething"> ... </a>

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

      对动态参数值约定

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

      对动态参数表达式约定

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

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

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

      JavaScript 表达式

      模板表达式都被放在沙盒中,只能访问全局变量的一个白名单 (opens new window),如 MathDate。你不应该在模板表达式中试图访问用户定义的全局变量。