03、Vue.js 3 —— 模板语法
插值
<span>Message: {{msg}}</span>
无论何时,绑定的组件实例上 msg property 发生了改变,插值处的内容都会更新。
v-once
执行一次性地插值,当数据改变时,插值处的内容不会更新。但请留心这会影响到该节点上的其它数据绑定:
<span v-once>这个将不会改变: {{msg}}</span>
v-html
双大括号插值会将数据解释为普通文本,要想输出html,使用 v-html:
<p>Using v-html directive: <span v-html="rawHtml"></span></p>
注意,你不能使用 v-html 来复合局部模板(即:v-html不能当做模板使用),因为 Vue 不是基于字符串的模板引擎。反之,对于用户界面 (UI),组件更适合作为可重用和可组合的基本单位。
在你的站点上动态渲染任意的 HTML 是非常危险的,因为它很容易导致 XSS 攻击。请只对可信内容使用 HTML 插值,绝不要将用户提供的内容作为插值。
Attribute —— v-bind
<div v-bind:id="dynamicId"></div>
如果绑定的值是 null 或 undefined,那么该 attribute 将不会被包含在渲染的元素上。
对于布尔 attribute (它们只要存在就意味着值为 true),v-bind 工作起来略有不同
<button v-bind:disabled="isButtonDisabled">按钮</button>
如果 isButtonDisabled 的值是 truthy,那么 disabled attribute 将被包含在内。如果该值是一个空字符串,它也会被包括在内,与 <button disabled=""> 保持一致。对于其他 falsy的值,该 attribute 将被省略。
truthy 和 falsy 的解释: https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy
插值、指令中 使用表达式
{{ number + 1 }} {{ ok ? 'YES' : 'NO' }} {{ message.split('').reverse().join('') }} <div v-bind:id="'list-' + id"></div> <!-- 这是语句,不是表达式:--> {{ var a = 1 }} <!-- 流程控制也不会生效,请使用三元表达式 --> {{ if (ok) { return message } }}
指令 v-
v-if
<p v-if="seen">现在你看到我了</p>
v-if 指令将根据表达式 seen 的值的真假来 插入/移除 <p> 元素。
v-bind
一些指令能够接收一个“参数”
<a v-bind:href="url"> ... </a>
在这里 href 是参数,告知 v-bind 指令将该元素的 href attribute 与表达式 url 的值绑定。
v-on
<a v-on:click="doSomething"> ... </a>
用于监听 DOM 事件,这里参数是监听的事件名。
动态参数
<!-- 注意,参数表达式的写法存在一些约束,如之后的“对动态参数表达式的约束”章节所述。 --> <a v-bind:[attributeName]="url"> ... </a> <a v-on:[eventName]="doSomething"> ... </a>
修饰符
用于指出一个指令应该以特殊方式绑定。例如,.prevent 修饰符告诉 v-on 指令对于触发的事件调用 event.preventDefault():
<form v-on:submit.prevent="onSubmit">...</form>
缩写
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>
: 与 @ 在所有支持 Vue 的浏览器都能被正确地解析。而且,它们不会出现在最终渲染的标记中。
注意事项
对动态参数值约定
动态参数预期会求出一个字符串,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>
JavaScript 表达式
模板表达式都被放在沙盒中,只能访问一个 受限的全局变量列表,如 Math 和 Date。你不应该在模板表达式中试图访问用户定义的全局变量。