12

v-for迭代语法变化

  • 丢弃$index$key

  • 新数组语法

    • value in arr

    • (value, index) in arr

  • 新对象语法

    • value in obj

    • (value, key) in obj

    • (value, key, index) in obj

指令接口的改变

大体来说,2.0版本中指令大范围的降低功能,它们仅用于低层次的直接dom操作。在多数情况下,你更应该使用组件作为主要的代码重构抽象。

指令不再有实例,这意味着指令中将不存在this,并且bind, updateunbind目前将接受任何数据作为参数。

请注意,绑定对象是不可变的。设置binding.value没有任何效果。并且在它上面添加属性不会持久,如果你真的非常需要可以在el配置上添加指令状态。

<div v-example:arg.modifier="a.b"></div>
// example directive
export default {
  bind (el, binding, vnode) {
    // the binding object exposes value, oldValue, expression, arg and modifiers.
    binding.expression // "a.b"
    binding.arg // "arg"
    binding.modifiers // { modifier: true }
    // the context Vue instance can be accessed as vnode.context.
  },

  // update has a few changes, see below
  update (el, binding, vnode, oldVnode) { ... },

  // componentUpdated is a new hook that is called AFTER the entire component
  // has completed the current update cycle. This means all the DOM would
  // be in updated state when this hook is called. Also, this hook is always
  // called regardless of whether this directive's value has changed or not.
  componentUpdated (el, binding, vnode, oldVNode) { ... },

  unbind (el, binding, vnode) { ... }
}

如果你只关心值可以使用解构:

export default {
  bind (el, { value }) {
    // ...
  }
}

除此之外,update钩子有一些变化:

  • bind之后将不再自动调用

  • 当组件重新渲染时总能响应,无论被绑定的值是否发生改变。你可以通过binding.value === binding.oldValue比较跳过不必要的更新,但也会有情况下,你希望应用始终更新。例如,当指令绑定到对象那可能希望是变化而不是替代。

elementDirective, 指令参数和指令配置,例如acceptStatement, deep等等
均被删除。

过滤器用法和语法变化

在vue 2.0,filter有了一系列的变化:

  • filter现在只能用于文本插入({{}}标签)。在之前我们在指令中使用filter,例如v-modelv-on等等,导致使用的复杂性,并且在v-for上的列表过滤,它更适合迁移到计算性能的js中。

  • vue 2.0不提供任何内置过滤器。建议使用独立的方法解决特定域的问题,例如moment.js用于格式化时间,accounting.js用于格式化金融货币。也欢迎你来创建自己的过滤器,并与社区分享吧!

  • filter语法更改为内嵌的js函数调用,而不是采取空格分割的参数。

    {{ date | formatDate('YY-MM-DD') }}

过渡组件

过渡CSS的变化

  • v-enter:在元素插入前应用,1秒后删除。(开始于进入状态)

  • v-enter-active:在元素插入前应用,当transition/animation结束时移除。

  • v-leave:当离开的transition触发时正确应用,一秒后删除。(开始于离开状态)

  • v-leave-active:当离开的transition触发时正确应用,当transition/animation结束时移除。

v-enter-activev-leave-active帮助你指定不同的曲线用于进入/离开动画。在多数情况下,升级只需将当前的v-leave替换为v-leave-active。(对于css动画,使用v-enter-activev-leave-active

过渡API的变化

  • <transition>组件

所有单元素的过度效果通过使用<transition>这个内置组件包装目标元素或组件得到相应的效果。这是一个抽象组件,意味着它不会渲染额外的DOM元素,也不会在组件层次结构中展示。它仅仅用于过渡行为里面的包裹内容。

最简单的用法示例:

<transition>
  <div v-if="ok">toggled content</div>
</transition>

该组件定义了一些属性和事件,直接映射到旧版的过渡定义选项。

属性
  • name: String

    • 用于自动生成过渡CSS类名。例如,name: 'fade'将会自动生成 .fade-enter.fade-enter-active等等。默认是v

  • appear: Boolean

    • 是否在最初的渲染应用的过渡。(默认值false

  • css: Boolean

    • 是否应用css过度类,默认值true。如果设置为false,只能通过触发组件事件注册的JavaScript钩子。

  • type: String

    • 指定等待确定过渡结束时转变的事件类型。可用的值是transitionanimation。默认情况下,它会自动检测一个持续时间较长的类型。

  • mode: String

    • 控制离开/进入转换的时序。可用的模式是in-outout-in,默认为同步。

  • enterClass, leaveClass, enterActiveClass, leaveActiveClass, appearClass, appearActiveClass: String

    • 单独配置的过渡css类

过渡到动态组件的示例:

<transition name="fade" mode="out-in" appear>
  <component :is="view"></component>
</transition>
事件

对应的在1.x API中可用的js钩子:

  • before-enter

  • enter

  • after-enter

  • before-leave

  • leave

  • after-leave

  • before-appear

  • appear

  • after-appear

例子:

<transition @after-enter="transitionComplete">
  <div v-show="ok">toggled content</div>
</transition>

当进入的过渡效果完成时,组件的transitionComplete方法将会在过渡DOM元素作为参数被调用。

一些注意事项:

  • leave-cancelled在插入删除中不可用。一旦离开的过渡效果开始,将不能被取消。但是仍然可用于v-show

  • 和1.0类似,对于enterleave钩子,在cb作为第二个参数的存在下表示使用者想要过渡结束时间的明确控制。

<transition-group>组件

所有的多元素过渡效果通过使用<transition-group>内置组件包装元素应用。它暴露了和<transition>一样的属性和事件。不同之处在于:

  1. 不同于<transition>,<transition-group>渲染一个真实的DOM元素。默认是渲染一个<span>标签,并且你可以配置哪些元素应该通过标记的属性呈现。你也可以使用is特性,例如<ul is="transition-group">

  2. <transition-group>不支持mode属性。

  3. <transition-group>下的子组件必须有唯一的key。

例子:

<transition-group tag="ul" name="slide">
  <li v-for="item in items" :key="item.id">
    {{ item.text }}
  </li>
</transition-group>

创建可重用的转换

现在transitions能够通过组件应用,它们补在被视为一种单独类型,因此全局的Vue.transition()方法和transition配置都被丢弃。你可以通过组件的属性和方法配置内嵌的过渡。但是,我们现在怎么创建可重复使用的过渡效果,尤其是那些自定义的js钩子?答案是创建自己的过渡组件(它们特别适合作为功能组件):

Vue.component('fade', {
  functional: true,
  render (createElement, { children }) {
    const data = {
      props: {
        name: 'fade'
      },
      on: {
        beforeEnter () { /* ... */ }, // <-- Note hooks use camelCase in JavaScript (same as 1.x)
        afterEnter () { /* ... */ }
      }
    }
    return createElement('transition', data, children)
  }
})

你可以这么使用:

<fade>
  <div v-if="ok">toggled content</div>
</fade>

v-model的变化

  • lazynumber参数现在是修饰符。

    <input v-model.lazy="text">
  • 新的修饰符:.trim-修整输入,顾名思义

  • debounce参数被丢弃

  • v-model不再关心初始值。它始终将data的数据作为资源。这意味着数据将是以1呈现而不是2.

    data: {
    val: 1
    }
    <input v-model="val" value="2">
  • 当使用v-for时,v-model不再生效。

    <input v-for="str in strings" v-model="str">

Refs

  • v-ref现在不再是一个指令,而是一个类似于key的属性

    <!-- before -->
    <comp v-ref:foo></comp>
    
    <!-- after -->
    <comp ref="foo"></comp>

    依然支持动态绑定:

    <comp :ref="dynamicRef"></comp>
  • vm.$elsvm.$refs合并了。在正常元素上使用是DOM元素,在组件上使用是组件实例。

杂项

  • track-by已经被key替代。对于绑定属性它遵守相同的规则,没有v-bind:或者:字头,它被视为普通字符串。大多数情况下需要动态绑定,如下:

    <!-- 1.x -->
    <div v-for="item in items" track-by="id">
    
    <!-- 2.0 -->
    <div v-for="item in items" :key="item.id">
  • 内插值属性已被弃用。

    <!-- 1.x -->
    <div id="{{ id }}">
    
    <!-- 2.0 -->
    <div :id="id">
  • 属性绑定行为变化:当绑定属性时,只有nullundefinefalse被认为是false。这意味着0和空字符串依旧呈现出原来的样子。对于枚举属性,:draggable="''"将被渲染为draggable="true"
    另外,对于枚举属性,除了上述false的值,false字符串也会被渲染为attr="false"

  • 当使用一个自定义组件,v-on只听自定义事件$emitted挂载在组件上。(不再监听DOM事件)

  • v-else不再适用于v-show,请使用其他的否定表达式。

  • 单次绑定({{* foo }})被移除,请使用v-once

  • Array.prototype.$set/$remove被丢弃(使用Vue.set或者Array.prototype.splice)。

  • :style不再支持!import

  • root实例不能使用props(请使用propsData

  • Vue.extendel配置项不能被使用,它现在只能被用作一个实例创建选项。

  • 在vue的实例中不能使用Vue.setVue.delete

升级小提示

如何处理丢弃的$dispatch$broadcast

我们弃用$dispatch$broadcast的原因在于依赖组件树结构的事件流,当组件树变得很大时很难推理(简单地说:它不能在大型应用很好地扩展,我们不希望以后给你设置痛点)。$dispatch$broadcast不能解决同级组件之间的通信。从而,你可以使用和node中的EventEmitter类似的模式:一个允许组件通信的集中事件枢纽,无论他们在组件树的任何地方。因为vue的实例实现了事件发射接口,你可以使用空的vue实例达到目的:

var bus = new Vue()
// in component A's method
bus.$emit('id-selected', 1)
// in component B's created hook
bus.$on('id-selected', this.someMethod)

并且不要忘记使用$off解绑事件:

// in component B's destroyed hook
bus.$off('id-selected', this.someMethod)

这种模式在简单的场景中可以作为$dispatch$broadcast的替代。但是在复杂的场景中,建议使用vuex建立一个专门的状态管理层。

如何处理数组中filter的弃用?

对于使用v-for进行列表过滤-过滤器常见用法之一-现在建议使用computed属性返回原始数组的一个副本(查阅更新数据例子)。好处在于你不再受到filter语法的限制,现在它只是普通的javascript,并且你可以正常访问过滤结果,因为它只是一个计算的属性。

如何处理在v-modeldebounce的丢弃?

debounce用于我们多久执行异步请求和其他操作,在v-model中使用十分容易,但这样也延迟了状态更新带来了限制。
当在设计一个搜索功能时这个限制变得很明显,看看这个例子,使用debounce属性,在搜索之前没法检测脏数据,因为我们不能访问输入的实时状态。

未完待续....


翻译自2.0 Changes


影绰
961 声望62 粉丝