Vue模板内容

前面的话

  如果只使用 Vue 最基础的声明式渲染的功能,则完全可以把 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} }}

  模板表达式都被放在沙盒中,只能访问全局变量的一个白名单,如MathDate。不应该在模板表达式中试图访问用户定义的全局变量

  [注意] 关于表达式与语句的区别移步至此

<div id="app">
  {{num + 1}}
</div>
<script>
new Vue({
  el: '#app',
  data:{
      'num': -1
  }
})
</script>

【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 的内容发生了改变,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="example" v-pre>{{message}}</div>
<script>
var vm = new Vue({
  el: '#example',
  data:{
    //如果使用 v-pre 指令,则不会被表示为 match
    message:'match'
  },
})
</script>

 

隐藏未编译

  一般地,使用模板差值时,页面上会显示大括号及占位符。编译完成后,再转换为真正的值。如果在网络条件不好的情况下,这种现象更加明显

<div id="example">{{message}}</div>
<script src="https://unpkg.com/vue"></script>
<script>
var vm = new Vue({
  el: '#example',
  data:{
    message:'match'
  },
})
</script>

【v-cloak】

  这个指令保持在元素上直到关联实例结束编译。和 CSS 规则如 [v-cloak] { display: none } 一起用时,这个指令可以隐藏未编译的 Mustache 标签直到实例准备完毕

<style>
[v-cloak]{display:none;} 
</style>
<div id="example" v-cloak>{{message}}</div>
<script src="https://unpkg.com/vue"></script>
<script>
var vm = new Vue({
  el: '#example',
  data:{
    message:'match'
  },
})
</script>

  

特性渲染

  HTML共有 16 个全局属性(或称为特性),Vue.js 支持对特性的内容进行动态渲染

  [注意]对象属性 (property) 和元素特性 (attribute) 的区别移步至此

  特性渲染时不能使用双大括号语法

<div id="app" title={{my-title}}></div>
<script>
var vm = new Vue({
  el: '#app',
  data:{
      'my-title': '测试内容'
  }
})
</script>

  使用上面代码时,控制台会显示如下错误

【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:"我是小火柴"
  }
})
</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用于classstyle时, 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:{
    classObject: {
      active: true,
      'text-danger': false
    }
  }
})
</script>

  也可以在这里绑定返回对象的计算属性。这是一个常用且强大的模式

<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>
<script>
var app = new Vue({
  el: '#app',
  data: {
    activeColor: 'red',
    fontSize: 30
  }
})
</script>

  直接绑定到一个样式对象通常更好,让模板更清晰

<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: '小火柴'
  },
  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: '小火柴'
  },
  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: '小火柴',
    arg: '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>