Vue.js（3）：模版语法

た入场券 2022-09-14 09:19 180阅读 0赞

Vue.js 使用了基于 HTML 的模板语法，允许开发者声明式地将 DOM 绑定至底层组件实例的数据。所有 Vue.js 的模板都是合法的 HTML，所以能被遵循规范的浏览器和 HTML 解析器解析。

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

如果你熟悉虚拟 DOM 并且偏爱 JavaScript 的原始力量，你也可以不用模板，[直接写渲染 (render) 函数][_render_]，使用可选的 JSX 语法。

# 一、插值 #

## 文本 ##

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

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

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

<span v-once>这个将不会改变: {
       { msg }}</span>

## 原始 HTML ##

双大括号会将数据解释为普通文本，而非 HTML 代码。为了输出真正的 HTML，你需要使用[v-html 指令][v-html]：

<div id="example1" class="demo">
        <p>使用 mustaches: {
       { rawHtml }}</p>
        <p>使用 v-html 指令: <span v-html="rawHtml"></span></p>
    </div>
    
    <script>
        const RenderHtmlApp = {
            data() {
                return {
                    rawHtml: '<span style="color: red">This should be red.</span>'
                }
            }
        }
    
        Vue.createApp(RenderHtmlApp).mount('#example1')
    </script>

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16][]

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

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

## Attribute ##

Mustache 语法不能在 HTML attribute 中使用，然而，可以使用 [v-bind 指令][v-bind]：

<div id="example1" class="demo">
        
        <div v-bind:id="dynamicId"></div>
    </div>
    
    <script>
        const RenderHtmlApp = {
            data() {
                return {
                    dynamicId: 'div1'
                }
            }
        }
    
        Vue.createApp(RenderHtmlApp).mount('#example1')

如果绑定的值是 `null` 或 `undefined`，那么该 attribute 将不会被包含在渲染的元素上。

对于布尔 attribute (它们只要存在就意味着值为 `true`)，`v-bind` 工作起来略有不同，在这个例子中：

如果 `isButtonDisabled` 的值是 truthy，那么 `disabled` attribute 将被包含在内。如果该值是一个空字符串，它也会被包括在内，与 `<button disabled="">` 保持一致。对于其他 falsy的值，该 attribute 将被省略。

> truthy 不是 `true`，详见 [MDN][] 的解释。
> 
> falsy 不是 `false`，详见 [MDN][MDN 1] 的解释。

## 使用 JavaScript 表达式 ##

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

{
        { number + 1 }}
    
    {
        { ok ? 'YES' : 'NO' }}
    
    {
        { message.split('').reverse().join('') }}
    
    <div v-bind:id="'list-' + id"></div>

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

{
        { var a = 1 }}
    
    
    {
        { if (ok) { return message } }}

# 二、指令 #

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

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

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

## 参数 ##

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

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

另一个例子是 `v-on` 指令，它用于监听 DOM 事件：

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

## 动态参数 ##

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

<div id="example1" class="demo">
        <a v-bind:[key]="url"> 打开百度 </a>
    </div>
    
    <script> const webapp = { data() { return { key:"href", url:'https://www.baidu.com' } } } Vue.createApp(webapp).mount('#example1') </script>

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

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

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

## 修饰符 ##

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

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

# 三、缩写 #

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

## `v-bind` 缩写 ##

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

## `v-on` 缩写 ##

<a v-on:click="doSomething"> ... </a>
    
    
    <a @click="doSomething"> ... </a>
    
    
    <a @[event]="doSomething"> ... </a>

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

## 注意事项 ##

（1）对动态参数值约定

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

（2）对动态参数表达式约定

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

<a v-bind:['foo' + bar]="value"> ... </a>

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

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

<a v-bind:[someAttr]="value"> ... </a>

（3）JavaScript 表达式

模板表达式都被放在沙盒中，只能访问一个[MDN][MDN 2]，如 `Math` 和 `Date`。你不应该在模板表达式中试图访问用户定义的全局变量。

[_render_]: https://v3.cn.vuejs.org/guide/render-function.html
[v-once]: https://v3.cn.vuejs.org/api/directives.html#v-once
[v-html]: https://v3.cn.vuejs.org/api/directives.html#v-html
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/f0ad29e198644a98902d60f40a44369e.png
[XSS]: https://en.wikipedia.org/wiki/Cross-site_scripting
[v-bind]: https://v3.cn.vuejs.org/api/directives.html#v-bind
[MDN]: https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy
[MDN 1]: https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy
[v-on]: https://v3.cn.vuejs.org/guide/events.html#%E4%BA%8B%E4%BB%B6%E4%BF%AE%E9%A5%B0%E7%AC%A6
[v-for]: https://v3.cn.vuejs.org/guide/forms.html#%E4%BF%AE%E9%A5%B0%E7%AC%A6
[SPA - single page application]: https://en.wikipedia.org/wiki/Single-page_application
[Link 1]: https://v3.cn.vuejs.org/guide/computed.html
[MDN 2]: https://github.com/vuejs/vue-next/blob/master/packages/shared/src/globalsWhitelist.ts#L3