Vue 的模板语法(template syntax)是 Vue 框架中用于声明式地绑定 DOM 的方式,核心是将 HTML 与 Vue 实例的数据绑定起来。
下面是常用的 Vue 模板语法总结(以 Vue 3 Composition API 为基础,也适用于 Vue 2 的 Options API):
用于绑定文本、属性等。
<p>{{ message }}p>
<p v-html="rawHtml">p>
⸻
Vue 指令以 v- 开头,用于在模板中执行特殊操作。
<img v-bind:src="imageUrl">
<img :src="imageUrl">
<input v-model="inputText">
<button v-on:click="doSomething">点击button>
<button @click="doSomething">点击button>
<p v-if="seen">显示p>
<p v-else>隐藏p>
<p v-show="isVisible">内容p>
<li v-for="(item, index) in items" :key="index">{{ item }}li>
虽然这不是模板语法本身,但它们是模板表达式常用的依赖来源:
<script setup>
import { ref, computed } from 'vue'
const count = ref(0)
const double = computed(() => count.value * 2)
function increment() {
count.value++
}
script>
<template>
<p>{{ double }}p>
<button @click="increment">加一button>
template>
<form @submit.prevent="onSubmit">...form>
<input @keyup.enter="onEnter">
Vue 模板最终会被编译成 render 函数,例如:
<p>{{ message }}p>
会被编译成:
createVNode("p", null, ctx.message)
也就是说,模板语法只是语法糖,Vue 会将它转化为虚拟 DOM 的构造代码。
模板中的表达式是 JavaScript 表达式,但有一些限制:
✅ 允许的:
• 属性访问(如 user.name)
• 方法调用(如 sayHi())
• 三元运算(如 isOk ? ‘yes’ : ‘no’)
• 算术运算(如 count + 1)
❌ 不允许的:
• 语句(如 if, while, try)
• new, eval 等全局对象创建
• 多行表达式
• 修改数据(比如 count++ 是不允许的)
Vue 会在构建阶段对模板做静态分析并抛出警告。
<input v-bind:[propName]="value">
<button v-on:[eventName]="handler">
注意:[propName] 和 [eventName] 必须是合法的 JS 表达式,并且最终解析为字符串。
插槽是 Vue 组件复用的核心机制之一。
<MyCard>
<template #default>
<p>插入的内容p>
template>
MyCard>
<MyCard>
<template #header>头部template>
<template #footer>底部template>
MyCard>
<slot :item="item">slot>
<MyList v-slot="{ item }">
<p>{{ item.name }}p>
MyList>
<li v-for="item in list" :key="item.id">
{{ item.name }}
li>
Vue 会将静态内容抽取成 hoisted 静态节点,避免重复创建。
<p v-once>{{ staticText }}p>
<p v-memo="[someReactiveDep]">{{ expensiveComputation }}p>
Vue 支持 JSX 语法(特别是在组合式 API 中),但模板语法更适合非工程师和组件声明。
使用
<script setup>
import { ref } from 'vue'
const count = ref(0)
script>
<template>
<button @click="count++">点击 {{ count }}button>
template>