数据绑定

Vue.js的模板是基于DOM实现的，Vue的模板都是可解析的有效HTML，且通过一些特性做了增强。

插值

• 文本

最基本的数据绑定形式就是文本插值，使用Mustache语法-双大括号：

Message: {{ msg }}

Mustache标签会被数据对象中的msg值替换，每当属性值发生变化对应也会更新到DOM上

• 原始的HTML

有的时候要输出真正的HTML字符串，则需要用到三Mustache标签，此时的数据绑定会被忽略

{{{ raw_html }}}

注意：在网站上动态渲染任意的HTML是非常危险的，容易导致XSS攻击。因此只对可信的HTML使用插值，永不用于用户提交的内容

• HTML特性

Mustache标签也可以用在HTML属性中

但是在Vue.js指令和特殊特性内不能使用插值

绑定表达式

放在Mustache标签内的文本成为绑定表达式，可以由一个简单的Javascript表达式和可选的一个或多个过滤器组成

• javascript表达式

{{ number + 1 }}

{{ ok ? 'YES' : 'NO' }}

{{ message.split('').reverse().join('') }}

过滤器

Vue.js允许在表达式后添加可选的过滤器，以‘管道符’形式

{{ message | capitalize }}

上述语句表示将message的值通过内置的capitalize过滤器，这个过滤器其实是一个函数，返回大写的值

过滤器可以串联

{{ message | filterA | filterB }}

{{ message | filterA 'arg1' arg2 }}

过滤器函数始终以表达式的值作为第一个参数。带引号的参数视为字符串，而不带引号的参数按表达式计算。这里，字符串 ‘arg1’ 将传给过滤器作为第二个参数，表达式 arg2 的值在计算出来之后作为第三个参数。

指令

指令是特殊的带有前缀v-特性。指令的值限定为绑定表达式，它的职责是当其表达式的值改变时把某些行为应用到DOM上。

• v-if、v-show与v-else

Hello!

• 这里通过v-if指令将表达式greeting的值真假插入/删除p元素。

上述指令用于条件渲染，根据绑定的表达式结果确定是否要渲染HTML元素。v-else 元素必须立即跟在 v-if 或 v-show 元素的后面——否则它不能被识别。

• 区别

  v-if 是真实的条件渲染，因为它会确保条件块在切换当中合适地销毁与重建条件块内的事件监听器和子组件

  v-show 绑定的元素始终被编译并保留，只是简单地基于 CSS 切换，另外它不支持标签

  一般来说，v-if 有更高的切换消耗而 v-show有更高的初始渲染消耗。因此，如果需要频繁切换 v-show 较好，如果在运行时条件不大可能改变 v-if 较好

• v-on

  利用v-on指令用于监听DOM事件，例如：

  另外v-on指令还可以缩写成@符号表示：

Button


Button

v-model

此指令用于表单元素上，例如常见的input，select，textarea，radio，checkbox等

ABC


Selected: {{ selected | json }}

v-for

v-for指令基于一个数组渲染一个列表。还有一个特殊的变量$index，它是当前数组元素的索引

 {{ parentMessage }} - {{ $index }} - {{ item.message }}
  


var example1 = new Vue({
  el: '#example-1',
  data: {
    items: [
      { message: 'Foo' },
      { message: 'Bar' }
    ]
  }
})

example1.items = example1.items.filter(function (item) {
     return item.message.match(/Foo/)
})

• track-by

列表在渲染的过程中通过唯一的键进行追踪，可以通过数组中每个值的唯一id进行标识或者通过$index，这种模式下可以处理数组中重复的值

计算属性

在Vue.js中将绑定表达式限定为一个表达式，如果需要多余一个表达式的逻辑，应当使用计算属性。一个比较常见的应用方式是b属性的值依赖于a属性的值，则b应当设置为计算属性。计算属性同样具有getter和setter方法

var vm = new Vue({
  data: {
    firstName: 'Foo',
    lastName: 'Bar'
  },
  computed: {
      fullName: {
	    // getter
	    get: function () {
	     	return this.firstName + ' ' + this.lastName
	    },
	    // setter
	    set: function (newValue) {
	        var names = newValue.split(' ')
	        this.firstName = names[0]
	        this.lastName = names[names.length - 1]
	    }
     }
  }
})

此时的vm. fullName依赖于vm. firstName和vm. lastName，所以当vm. firstName和vm. lastName的值改变的时候，vm. fullName值也会相应的进行改变。同样的如果调用vm.fullName = 'John Doe' 时，setter 会被调用，vm.firstName 和 vm.lastName 也会有相应更新

Class与style绑定

数据绑定的一个常见需求是操作元素的class和它的内联样式。因为它们都是HTML元素的属性，可以用v-bind来处理它们：只需要计算出表达式最终字符串。在v-bind用于绑定class和style时，Vue.js专门对其进行增强，使得表达式的结果类型除了字符串外，还可以是对象或者数组。

注意：尽管可以用Mustache标签绑定class，例如class=，但是不推荐和v-bind:class=className这种方式混用。两者只能选其一

绑定class

• 对象语法

可以给v-bind:class传递一个对象，以动态的切换class。注意v-bind:class可以和普通的class共存。

data: {
  isA: true,
  isB: false
}

渲染为：

• 数组语法

可以把一个数组传递给v-bind:class，以应用一个class列表

data: {
  classA: 'class-a',
  classB: 'class-b'
}

绑定style内联样式

v-bind:style与v-bind:class使用方式相同，可以使用对象语法和数组语法。css属性名可以采用驼峰式或者短横线分割命名。

• 对象语法

data: {
	  styleObject: {
	      color: 'red',
	      fontSize: '13px'
	  }
}

数组语法

可以将多个样式对象应用到一个元素上

AStyle: {
      color: 'red'
  },
  BStyle: {
      fontSize: '22px'
  }

表单控件绑定

可以通过v-model指令在表单元素上创建双向数据绑定

Text

Message is: {{ message }}



edit me

Checkbox

多个复选框，绑定到同一个数组

Jack

John

Mike


Checked names: {{ checkedNames | json }}
new Vue({
  el: '...',
  data: {
    checkedNames: []
  }
})

Radio

One



Two


Picked: {{ picked }}

Select

• 单选，value为单个字符串

Selected: {{ selected }}

ABC


Selected: {{ selected | json }}

参数特性

• lazy

  在默认情况下，v-model是在input事件中同步输入框值和数据，可以添加一个lazy属性，从而在change事件中同步

debounce

debounce设置一个最小延时，在每次敲击后延时同步输入框和数据，例如在输入过程中发送ajax请求时比较有用。debounce延迟写入底层数据，应当用vm.$watch()监听数据的变化。

debounce参数不会延迟DOM，若想延迟DOM事件，应当使用debounce过滤器。包装处理器，让它延迟执行，包装后的处理器将延迟xms（默认为300ms）后执行，如果在延迟结束前再次调用，延时时长重置为xms

方法和事件处理器

方法处理器

可以通过v-on指令监听DOM事件，事件监听程序都是写在methods属性中。在绑定方的时候，还可以传递参数，包括event对象，在HTML语句中需要使用$event进行传递。并且这个$event是原生的event对象，包含原生的event事件属性和方法。

  Greet

var vm = new Vue({
  el: '#example',
  // 在 `methods` 对象中定义方法
  methods: {
    greet: function (event, msg) {
      // 方法内 `this` 指向 vm
      alert('Hello ' + msg + '!')
      // `event` 是原生 DOM 事件
      alert(event.target.tagName)
    }
  }
})
// 也可以在 JavaScript 代码中调用方法
vm.greet() // -> 'Hello Vue.js!'

事件修饰符

在事件处理器中，通常需要使用到event.stopPropagation()和event.preventDefault()，在Vue.js中为v-on指令添加了.stop和.prevent两个命令修饰符

...



...

按键修饰符

在监听键盘事件时，经常需要检测keyCode。Vue.js允许为v-on添加按键修饰符

全部按键的别名包括：

• enter
• tab
• delete
• esc
• space
• up
• down
• left
• right

组件

组件（component）是Vue.js最强大的功能之一。组件可以扩展HTML元素，封装可重用的代码。组件的使用过程包括定义和注册的过程。组件在注册之后便可以在父实例中以自定义的元素的形式使用，不过要确保在初始化根实例之前注册了组件。而且自定义元素只是作为一个挂载点

// 定义
var MyComponent = Vue.extend({
  template: '
A custom component!
'
})

// 注册
Vue.component('my-component', MyComponent)

// 创建根实例
new Vue({
  el: '#example'
})

A custom component!

局部注册

有点时候并不需要注册全局组件，可以只让组件用在其他组件内部，用components进行注册

//定义子组件
var child = Vue.extend({
    template: '
this is child component 
'
});
//定义父组件
var parent = Vue.extend({
    template: '
this is parent component  
',
    components: {
        //此时子组件child-component只能在父组件中使用
        'child-component': child
    }
});
//注册父组件
Vue.component('parent-component', parent);

模板解析

Vue模板是DOM模板，使用浏览器原生的解析器而不是自己实现一个，所以HTML元素对什么元素可以放在它里面是有限制的。常见的限制如下：

• a 不能包含其它的交互元素（如按钮，链接）
• ul 和 ol 只能直接包含 li
• select 只能包含 option 和 optgroup
• table 只能直接包含 thead, tbody, tfoot, tr, caption, col, colgroup
• tr 只能直接包含 th 和 td

组件选项

在组件内部也会使用数据变量，变量值也会存在data选项中，但是不同于Vue实例的data属性，组件内部的data属性应该是一个函数，在这个函数中返回一个新的对象，其中包含需要的属性名和属性值。

var MyComponent = Vue.extend({
  data: function () {
    return { a: 1 }
  }
})

使用props进行传值

组件实例的作用域是孤立的，在子组件中不能直接使用父组件中的属性。可以使用props属性将数据传递给子组件。是传递字面量还是动态值通过是否使用v-bind指令来确定。

var child = Vue.extend({
    template: '
this is child component  {{attrA}} {{attrB}}
',
    props: ['attrA', 'attrB']
});
var parent = Vue.extend({
    template: '
this is parent component {{a}} ' +
              '' +
              '
',
    components: {
        'child-component': child
    },
    data: function () {
        return {
            attrA: dynamic  attrA',
            attrB: 'dynamic attrB'
        }
    }
});

this is child component  attrA dynamic attrB

注意：子组件内部具有的属性不能和继承的属性相同，即不能在子组件的data和props中出现相同的变量名，否则程序会报错

父子组件通信

子组件可以通过this.$parent访问它的父组件，父组件有一个this.$children，包含子组件的列表。根实例的后代通过this.$root访问它。

尽管可以访问到父链上的任意实例，不过子组件应该避免直接依赖父组件的数据，而是通过props属性进行传递，而且在子组件中也不要修改父组件中的状态，理想情况下只有组件自己才可以修改它的状态。

自定义事件

Vue.js实现了一个自定义的事件接口，用于在组件树中通信。这个事件系统独立于原声DOM事件，用法也不同。

每个Vue实例都是一个事件触发器

• 使用$on监听事件
• 使用$emit在它上面触发事件
• 使用$dispatch派发事件，事件沿着父链冒泡。不同于DOM原生事件，Vue事件在冒泡过程中第一次触发回调后自动停止冒泡，除非回调函数明确返回true
• 使用$broadcast广播事件，事件向下传导给所有后代

Messages: {{ messages | json }}

// 注册子组件
// 将当前消息派发出去
Vue.component('child', {
  template: '#child-template',
  data: function () {
    return { msg: 'hello' }
  },
  methods: {
    notify: function () {
      if (this.msg.trim()) {
        this.$dispatch('child-msg', this.msg)
        this.msg = ''
      }
    }
  }
})

// 初始化父组件
// 将收到消息时将事件推入一个数组
var parent = new Vue({
  el: '#events-example',
  data: {
    messages: []
  },
  // 在创建实例时 `events` 选项简单地调用 `$on`
  events: {
    'child-msg': function (msg) {
      // 事件回调内的 `this` 自动绑定到注册它的实例上
      this.messages.push(msg);
    }
  }
})

使用slot分发内容

每个组件都有自己的作用域，父组件模板的内容在父组件作用域内编译，子组件模板的内容在子组件作用域内编译。如果要绑定一个指令打到组件的根节点上，应该按如下方式：

Vue.component('child-component', {
  // v-show指令有效，因为是在正确的作用域内
  template: '
Child
',
  data: function () {
    return {
      someChildProperty: true
    }
  }
})

类似的，分发内容也是在父组件的作用域内编译。

• slot

  父组件的内容在渲染的时候会被抛弃，除非子组件包含了slot标签。如果子组件只包含一个slot，则父组件的内容将被添加到slot标签中；如果子组件具有多个slot标签，可以通过slot标签的name属性进行分发。在具有多个slot标签时，仍然可以有一个匿名的slot，它是默认的slot，作为找不到匹配的内容的slot。

  子组件模板：

One


 
Two


 
Default A


 

One


Default A


Two

编写可复用的组件

在编写组件的时候，如果需要达到可复用的目的，应当定义一个清晰的公开接口。Vue.js组件的API来自三个部分：props、事件和slot

• props允许外部环境传递数据给组件
• 事件允许组件触发外部环境的action
• slot允许外部环境的内容插入到组件内部结构中

Vue.directive('my-directive', {
	  bind: function () {
	    // 准备工作
	    // 例如，添加事件处理器或只需要运行一次的高耗任务
	  },
	  update: function (newValue, oldValue) {
	    // 值更新时的工作
	    // 也会以初始值为参数调用一次
	  },
	  unbind: function () {
	    // 清理工作
	    // 例如，删除 bind() 添加的事件监听器
	  }
})

指令实例属性

在钩子函数内this执行这个指令对象。这个对象暴露了一些实例属性：

• el：指令绑定的元素
• vm：拥有该指令的上下文ViewModel
• expression：指令表达式
• arg：指令参数
• name：指令名称
• modifiers：指令修饰符对象
• descriptor：指令解析的结果对象

注意:这些属性我们应该将其视为可读的，不要修改他们。可以添加自定义属性，但不要覆盖已有的内部属性

Vue.directive('demo', {
	  bind: function () {
	    console.log('demo bound!')
	  },
	  update: function (value) {
	    this.el.innerHTML =
	      'name - '       + this.name + '
' +
	      'expression - ' + this.expression + '
' +
	      'argument - '   + this.arg + '
' +
	      'modifiers - '  + JSON.stringify(this.modifiers) + '
' +
	      'value - '      + value
	  }
});
var demo = new Vue({
	  el: '#demo',
	  data: {
	    msg: 'hello!'
	  }
})

name - demo
expression - msg
argument - hello
modifiers - {a: true, b: true}
value - hello!

高级选项-params

类似于自定义组件的props属性，自定义指令提供params属性，指令一个数组列表，Vue编译器将自动提取绑定元素的这些特性。而且params还支持动态属性，另外还可以指定一个回调，在值变化时调用

Vue.directive('example', {
  params: ['a'],
  paramWatchers: {
    a: function (val, oldVal) {
      console.log('a changed!')
    }
  }
})

自定义过滤器

类似于自定义指令，可以通过Vue.filter()注册一个全局自定义过滤器，接收两个参数：过滤器ID和过滤器函数，过滤器函数以值为参数，返回转换后的值

自定义过滤器可以接收任意数量的参数，第一个参数为表达式的值，从第二个参数开始可以传递任意值，字面量或者计算表达式

Vue.filter('wrap', function (value, begin, end) {
    return begin + value + end
});
var vm = new Vue({
    el: '#demo',
    data: {
   	   after: 'last'
    }
});

原文发布时间为：2016年11月11日
原文作者：掘金
本文来源：掘金 如需转载请联系原作者