如果只使用Vue最基础的声明式渲染的功能,则完全可以把Vue当做一个模板引擎来使用。
概述
Vue.js使用了基于HTML的模板语法,允许声明式地将DOM绑定至底层Vue实例的数据。所有Vue.js的模板都是合法的HTML ,所以能被遵循规范的浏览器和HTML解析器解析。
在底层的实现上, Vue将模板编译成虚拟DOM渲染函数。结合响应系统,在应用状态改变时, Vue能够智能地计算出重新渲染组件的最小代价并应用到DOM操作上。
文本渲染
【文本插值】
文本渲染最常见的形式是使用双大括号语法来进行文本插值,下面的message相当于一个变量或占位符,最终会表示为真正的文本内容。
<div id="app">
{{ message }}
</div>
<script>
new Vue({
el: '#app',
data:{
'message': '<span>测试内容</span>'
}
})
</script>
【表达式插值】
{{ number + 1 }}
{{ ok ? 'YES' : 'NO' }}
{{ message.split('').reverse().join('') }}
上面这些表达式会在所属Vue实例的数据作用域下作为JS被解析。有个限制就是,每个绑定都只能包含单个表达式,所以下面的例子都不会生效。
<!-- 这是语句,不是表达式 -->
{{ var a = 1 }}
<!-- 流控制也不会生效,请使用三元表达式 -->
{{ if (ok) { return message } }}
【v-text】
实现插值类似效果的另一种写法是使用v-text指令,该指令用于更新元素的innerText。如果要更新部分的innerText,需要使用模板插值。
[注意]v-text优先级高于模板插值的优先级。
<div id="app" v-text="message"></div>
<script>
new Vue({
el: '#app',
data:{
message:"This is a <i>simple</i> document"
}
})
</script>
【v-html】
如果要输出真正的 HTML ,需要使用 v-html 指令,该指令用于更新元素的 innerHTML。在网站上动态渲染任意 HTML 是非常危险的,因为容易导致 XSS 攻击。只在可信内容上使用 v-html,而不用在用户提交的内容上。
<div id="app" v-html="message"></div>
<script>
new Vue({
el: '#app',
data:{
message:"This is a <i>simple</i> document"
}
})
</script>
静态插值
上面介绍了模板插值,一般地,模板插值是动态插值。即无论何时,绑定的数据对象上的占位符内容发生了改变,插值处的内容都会更新。
<div id="app">{{ message }}</div>
<script>
var vm = new Vue({
el: '#app',
data:{
'message': '测试内容'
}
})
</script>
在控制台改变vm.message=123时,DOM结构中的元素内容也相应地更新。
【v-once】
如果要实现静态插值,即执行一次性插值,数据改变时,插值处内容不会更新,这时需要用到v-once指令。
<div id="app" v-once>{{ message }}</div>
<script>
var vm = new Vue({
el: '#app',
data:{
'message': '测试内容'
}
})
</script>
在控制台改变vm.message=123时,DOM结构中元素内容仍然是“测试内容”。
不渲染
【v-pre】
如果要跳过这个元素和它的子元素的编译过程,只用来显示原始大括号及标识符,则可以使用v-pre指令。这样,可以减少编译时间。
<div id="app" v-pre>{{message}}</div>
<script>
var vm = new Vue({
el: '#app',
data:{
//如果使用v-pre指令,则不会被表示为hello
message:'hello'
},
})
</script>
隐藏未编译
一般地,使用模板差值时,页面上会显示大括号及占位符,编译完成后,再转换为真正的值,在网络条件不好的情况下,这种现象很明显。
<div id="app">{{message}}</div>
<script>
var vm = new Vue({
el: '#app',
data:{
message:'hello'
},
})
</script>
【v-cloak】
这个指令保持在元素上直到关联实例结束编译,和 CSS 规则如 [v-cloak] { display: none } 一起用时,这个指令可以隐藏未编译的 Mustache 标签直到实例准备完毕。
<style>
[v-cloak]{display:none;}
</style>
<div id="app" v-cloak>{{message}}</div>
<script>
var vm = new Vue({
el: '#app',
data:{
message:'hello'
},
})
</script>
特性渲染
HTML共有16个特性,Vue.js支持对特性的内容进行动态渲染,特性渲染时不能使用双大括号语法。
【v-bind】
上面的错误提示中提到,应该使用v-bind指令,通过v-bind指令可以动态地绑定一个或多个特性。
在这里title是参数,告知v-bind指令将该元素的title属性与表达式message的值绑定。
<div id="app" v-bind:title="message"></div>
由于v-bind指令非常常用,可缩写如下
<div id="app" :title="message"></div>
<script>
new Vue({
el: '#app',
data:{
message:"zyb"
}
})
</script>
对布尔值的属性也有效——如果条件被求值为false,该属性会被移除。
<button id="app" :disabled="isButtonDisabled">按钮</button>
<script>
var vm = new Vue({
el: '#app',
data:{
'isButtonDisabled': true
}
})
</script>
class绑定
数据绑定一个常见需求是操作元素的class列表和它的内联样式,因为它们都是属性 ,可以用v-bind处理它们:只需要计算出表达式最终的字符串。不过,字符串拼接麻烦又易错。因此,在v-bind用于class和style时, Vue.js 专门增强了它。表达式的结果类型除了字符串之外,还可以是对象或数组。
绑定class包括对象语法、数组语法和组件绑定。
【对象语法】
可以传给 v-bind:class 一个对象,以动态地切换 class。
<div v-bind:class="{ active: isActive }"></div>
上面的语法表示 class active 的更新将取决于数据属性 isActive 是否为真值。
可以在对象中传入更多属性来动态切换多个class,v-bind:class指令可以与普通的class属性共存。
<div id="app" class="static"
v-bind:class="{ active: isActive, 'text-danger': hasError }">
</div>
<script>
var app = new Vue({
el: '#app',
data:{
isActive:true,
hasError:false
}
})
</script>
当 isActive 或者 hasError 变化时,class 列表将相应地更新。例如,如果 hasError的值为 true , class列表将变为 "static active text-danger"。
也可以在这里绑定返回对象的计算属性。这是一个常用且强大的模式。
<div id="app" :class="classObject"></div>
<script>
var app = new Vue({
el: '#app',
data: {
isActive: true,
error: null
},
computed: {
classObject: function () {
return {
active: this.isActive && !this.error,
'text-danger': this.error && this.error.type === 'fatal',
}
}
}
})
</script>
【数组语法】
可以把一个数组传给 v-bind:class ,以应用一个 class 列表。
<div id="app" :class="[activeClass, errorClass]"></div>
<script>
var app = new Vue({
el: '#app',
data: {
activeClass: 'active',
errorClass: 'text-danger'
}
})
</script>
如果要根据条件切换列表中的 class ,可以用三元表达式。
<div id="app" :class="[isActive ? activeClass : '', errorClass]"></div>
此例始终添加 errorClass ,但是只有在 isActive 是 true 时添加 activeClass。
不过,当有多个条件 class 时这样写有些繁琐,可以在数组语法中使用对象语法。
<div id="app" :class="[{ active: isActive }, errorClass]"></div>
【组件绑定】
在一个定制组件上用到class属性时,这些类将被添加到根元素上面,这个元素上已经存在的类不会被覆盖。
<div id="app" class="test">
<my-component class="baz boo"></my-component>
</div>
<script>
Vue.component('my-component', {
template: '<p class="foo bar">Hi</p>'
})
var app = new Vue({
el: '#app'
})
</script>
HTML 最终将被渲染为如下所示
同样的适用于绑定 HTML class
<div id="app" class="test">
<my-component :class="{ active: isActive }"></my-component>
</div>
<script>
Vue.component('my-component', {
template: '<p class="foo bar">Hi</p>'
})
var app = new Vue({
el: '#app',
data:{
isActive:true
}
})
</script>
style绑定
【对象语法】
v-bind:style的对象语法十分直观——看着非常像 CSS ,其实它是一个JS对象。 CSS属性名可以用驼峰式 (camelCase)或(配合引号的)短横分隔命名 (kebab-case)。
<div id="app"
:style="{ color: activeColor, fontSize: fontSize + 'px' }"
></div>
直接绑定到一个样式对象通常更好,让模板更清晰。
<div id="app" :style="styleObject"></div>
<script>
var app = new Vue({
el: '#app',
data: {
styleObject: {
color: 'red',
fontSize: '13px'
}
}
})
</script>
【数组语法】
v-bind:style 的数组语法可以将多个样式对象应用到一个元素上。
<div id="app" :style="[baseStyles, overridingStyles]"></div>
<script>
var app = new Vue({
el: '#app',
data: {
baseStyles: {
color: 'red',
fontSize: '13px'
},
overridingStyles:{
height:'100px',
width:'100px'
}
}
})
</script>
【前缀】
当v-bind:style使用需要特定前缀的CSS属性时,如transform,Vue.js会自动侦测并添加相应的前缀。
可以为 style 绑定中的属性提供一个包含多个值的数组,常用于提供多个带前缀的值。
<div :style="{ display: ['-webkit-box', '-ms-flexbox', 'flex'] }">
这会渲染数组中最后一个被浏览器支持的值。在这个例子中,如果浏览器支持不带浏览器前缀的 flexbox,那么渲染结果会是 display: flex。
过滤器
Vue.js允许自定义过滤器,可被用作一些常见的文本格式化。过滤器可以用在两个地方:模板插值和v-bind
表达式。过滤器应该被添加在JS表达式的尾部,由“管道”符指示。
{{ message | capitalize }}
<div v-bind:id="rawId | formatId"></div>
过滤器设计目的是用于文本转换,如果想实现更复杂的数据变换,应该使用计算属性。
过滤器有两种注册形式
1、一种是使用Vue.filter()方法。
// 注册
Vue.filter('my-filter', function (value) {
// 返回处理后的值
})
// getter,返回已注册的过滤器
var myFilter = Vue.filter('my-filter')
2、另一种是在Vue构造函数或组件中使用filters参数。
var app = new Vue({
el: '#app',
filters: {
'my-filter': function (value) {
//
}
}
})
过滤器函数总接受表达式的值 (之前的操作链的结果) 作为第一个参数,在这个例子中,capitalize 过滤器函数将会收到 message 的值作为第一个参数。
<div id="app">
{{ message}}
{{ message | capitalize }}
</div>
<script>
var app = new Vue({
el: '#app',
data:{
message: 'zyb'
},
filters: {
capitalize: function (value) {
if (!value) return ''
value = value.toString()
return value.split('').reverse().join('')
}
}
})
</script>
过滤器可以串联
{{ message | filterA | filterB }}
在这个例子中,filterA 拥有单个参数,它会接收 message 的值,然后调用 filterB,且 filterA 的处理结果将会作为 filterB 的单个参数传递进来。
<div id="app">
{{ message}}
{{ message | filterA | filterB }}
</div>
<script>
var app = new Vue({
el: '#app',
data:{
message: 'zyb'
},
filters: {
filterA: function (value) {
return value.split('').reverse().join('')
},
filterB: function(value){
return value.length
}
}
})
</script>
过滤器是JS函数,因此可以接受参数。
{{ message | filterA('arg1', arg2) }}
这里,filterA 是个拥有三个参数的函数。message 的值将会作为第一个参数传入。字符串 'arg1' 将作为第二个参数传给 filterA,表达式 arg2 的值将作为第三个参数。
<div id="app">
{{ message}}
{{ message | filterA('arg1', arg) }}
</div>
<script>
var app = new Vue({
el: '#app',
data:{
message: 'zyb',
arg2: 'abc'
},
filters: {
filterA: function (value,'arg1',arg2) {
return value + arg1 + arg2
}
}
})
</script>
下面是过滤器在v-bind表达式中使用的一个例子。
<div id="app" :class="raw | format"></div>
<script>
var app = new Vue({
el: '#app',
data:{
raw: 'active'
},
filters: {
format: function (value) {
return value.split('').reverse().join('')
}
}
})
</script>