一、基础篇 vue模板语法

news2025/12/14 19:44:50

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

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

插值

文本

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

<h1>Message:{{message}}</h1>

<template>
    <div class="content">
        <h1>{{message}}</h1>
    </div>
</template>

<script>
export default {
    data() {
        return {
            message: '我是Home页面',
        }
    },
}
</script>

<style scoped>
</style>

原始HTML

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

<h2 v-html="rawHtml"></h2>

<template>
    <div class="content">
        <h1>Message:{{message}}</h1>
        <div v-html="rawHtml"></div>
    </div>
</template>

<script>
export default {
    data() {
        return {
            message: '我是Home页面',
            rawHtml: '<div>我是html内容</div>'
        }
    },
}
</script>

<style scoped>
</style>

Attribute

Mustache 语法不能作用在 HTML attribute 上，遇到这种情况应该使用 v-bind 指令

<div v-bind:id="dynamicId">{{dynamicId}}</div>

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

<button v-bind:disabled="isButtonDisabled">Button</button>

<template>
    <div class="content">
        <h1>Message:{{message}}</h1>
        <h2 v-html="rawHtml"></h2>
        <div v-bind:id="dynamicId">{{dynamicId}}</div>
        <button v-bind:disabled="isButtonDisabled">Button</button>
    </div>
</template>

<script>
export default {
    data() {
        return {
            message: '我是Home页面',
            rawHtml: '<div>我是html内容</div>',
            dynamicId: 'id1',
            isButtonDisabled: false,
        }
    },
}
</script>

<style scoped>
</style>

如果 isButtonDisabled 的值是 null、undefined 或 false，则 disabled attribute 甚至不会被包含在渲染出来的 <button> 元素中。

使用 JavaScript 表达式

在模板上vue提供了完全的 JavaScript 表达式支持

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

<script>
export default {
    data() {
        return {
            number: 1,
            ok: true,
            message: 'hello vue',
            id: 1,
        }
    },
}
</script>

<style scoped>
</style>

指令

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

<template>
    <div class="content">
        <p v-if="show">现在你看到我了</p>
    </div>
</template>

<script>
export default {
    data() {
        return {
            show: true,
        }
    },
}
</script>

<style scoped>
</style>

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

参数

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

<template>
    <div class="content">
        <a v-bind:href="url">www.baidu.com</a>
    </div>
</template>

<script>
export default {
    data() {
        return {
            url: 'https://www.baidu.com/',
        }
    },
}
</script>

<style scoped>
</style>

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

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

<template>
    <div class="content">
        <!-- 在这里参数是监听的事件名 -->
        <a v-on:click="doSomething">www.baidu.com</a>
    </div>
</template>

<script>
export default {
    data() {
        return {
            url: 'https://www.baidu.com/',
        }
    },
    methods:{
        //a标签的点击事件
        doSomething(){
            location.href = this.url;
        },
    },
}
</script>

<style scoped>
</style>

动态参数

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

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

<script>
export default {
    data() {
        return {
            url: 'https://www.baidu.com/',
            attributeName: 'href',
        }
    },
}
</script>

<style scoped>
</style>

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

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

<template>
    <div class="content">
        <!--注意，参数表达式的写法存在一些约束，如之后的“对动态参数表达式的约束”章节所述。-->
        <a v-on:[eventName]="doSomething">www.baidu.com</a>
    </div>
</template>

<script>
export default {
    data() {
        return {
            eventName: 'click',//事件名
        }
    },
    methods:{
        doSomething(){
            console.log(6666);
        }
    },
}
</script>

<style scoped>
</style>

修饰符

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

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

缩写

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>