vue2.0新特性汇总

vue2.0新特性汇总,译自官方文档Migration from Vue 1.x。文章主要介绍了从vue1.0到2.0发生的一些变化,旨在为项目迁移作一定参考。当然,如果只是简单地想要让vue1.0项目在vue2.0环境运行起来,可以使用官方迁移工具vue-migration-helper

Templates

片断实例 废弃

每一个组件都应仅有一个根节点元素,片段实例不再被允许。如果有如下代码片段

<p>foo</p>
<p>bar</p>

建议直接给它们整个内容添加一个包裹元素,如下所示

<div>
  <p>foo</p>
  <p>bar</p>
</div>

生命周期

beforeCompile 废弃

使用created钩子代替.

compiled 废弃

使用mounted钩子代替

attached 废弃

不再使用attached钩子,而是在其他钩子中做in-dom检测(不好翻译,意思大概是检测dom元素是否渲染完成),将

attached: function () {
    doSomething()
}

替换为

mounted: function () {
  this.$nextTick(function () {
    doSomething()
  })
}

detached 废弃

不再使用detached钩子,而是在其他钩子中做in-dom检测,将

detached: function () {
  doSomething()
}

替换为

destroyed: function () {
  this.$nextTick(function () {
    doSomething()
  })
}

init 废弃

使用beforeCreate代替,本质上,initbeforeCreate是一回事。为保持生命周期命名的一致性,init钩子被重命名为beforeCreate

ready 废弃

使用新的mounted钩子代替,注意,mounted钩子不保证组件元素已经渲染到文档中,因此,也需要调用Vue.nextTick/vm.$nextTick。如下所示

mounted: function () {
  this.$nextTick(function () {
    // code that assumes this.$el is in-document
  })
}

v-for

v-for 应用于数组时的参数顺序

当需要使用数组索引时,过去的参数是(index, value),现在则是(value, index),它与js原生数组方法的参数形式保持一致,比如forEachmap

v-for 应用于对象时的参数顺序

当需要使用对象的键(key)时,过去的参数是(key, value),现在则是(value, key),它与一些常用的对象迭代器参数形式保持一致,比如lodash

$index and $key 废弃

隐式参量$index$key已被废弃,应在v-for表达式中显示定义,这样可以使代码易于阅读(尤其对于vue新手),并且使嵌套循环代码的行为更清晰。

track-by 废弃

属性track-bykey代替,key更像其他普通属性,没有v-bind:或者:前缀时被当做是一个字符串值字面量。大多数情况下,你想要动态绑定key的话,请使用v-bind:或者:前缀,如下所示

<div v-for="item in items" track-by="id">

替换为

<div v-for="item in items" v-bind:key="item.id">

v-for 应用于数值范围

先前v-for="number in 10"将会遍历0到9,现在则是从1到10。

Props

Prop验证选项coerce废弃

如果想要转换一个prop,请设置一个基于此prop的计算属性,如下所示

props: {
  username: {
    type: String,
    coerce: function (value) {
      return value
      .toLowerCase()
      .replace(/\s+/, '-')
    }
  }
}

替换为

props: {
 username: String,
},
computed: {
  normalizedUsername: function () {
    return this.username
    .toLowerCase()
    .replace(/\s+/, '-')
  }
}

几点好处如下:

  • 仍然可以获得prop的原始值
  • 显式定义转换后的prop名称,使得它和传入的prop有所区别

ProptwoWay选项废弃

Props总是单向传递下来的。为了对父组件的作用域产生影响,组件应该显式地触发一个事件而非隐式的双向绑定数据,更多信息请查看

指令v-bind的修饰符.once and .sync废弃

Props总是单向传递下来的。为了对父组件的作用域产生影响,组件应该显式地触发一个事件而非隐式的双向绑定数据,更多信息请查看

Prop变动 废弃

修改prop被认为是反模式(anti-pattern),例如,申明一个prop并给他赋值this.myProp = 'someOtherValue'。基于更新机制,父组件一旦重新渲染,它的子组件的本地状态将会被覆写

大多数需要修改prop的场景都可以通过以下方式来替代实现:

  • 设置一个data属性,用prop的值去初始化它(如使用修饰符once的场景)

  • 设置一个计算属性(如使用prop coerce选项的场景)

vue根组件上的Props废弃

在vue根组件实例上(例如,使用new Vue({ ... })实例化的组件),申明prop时应该使用propsData,而不是props

内建指令(Directive

v-bind与布尔值

当使用v-bind时,只有nullundefinedfalse是假值(Falsiness),也就意味着0和空字符串会被解析为真值(truthy)。例如,v-bind:draggable="''" 会被解析为 as draggable="true" 对于枚举属性,除了上述假值,字符串 "false"会被解析为attr="false",也为假值

注意:对于其它指令 (如,v-ifv-show),JavaScript本来的真假值依然生效

v-on监听组件的原生事件

对于组件来说,v-on只能监听用由$emit触发的组件自定义事件,为了监听组件根节点元素的原生DOM事件,可以使用.native修饰符,例如


<my-component v-on:click.native="doSomething"></my-component>

v-modeldebounce 废弃

debounce(去抖)一般被用来限制Ajax请求或其它高耗操作的执行频率。Vue的 debounce属性配合v-model指令可以在一些简单的场景很容易地实现去抖。但是,debounce实际上限制的是状态的更新频率而非高耗操作的执行频率,两者虽然差别细微,但是随着应用规模的增长,这种实现方式局限性越发显著。

使用debounce属性时,因为不能实时获取输入框的状态,将不能(准确)检测到输入状态。将去抖(debounce)从Vue中解耦,使得可以仅仅限制高耗操作本身的执行,而不会有其他的局限性。

下例是一个搜索提示器的实现

<!--
By using the debounce function from lodash or another dedicated
utility library, we know the specific debounce implementation we
use will be best-in-class - and we can use it ANYWHERE. Not just
in our template.
-->
<script src="https://cdn.jsdelivr.net/lodash/4.13.1/lodash.js"></script>
<div id="debounce-search-demo">
    <input v-model="searchQuery" placeholder="Type something">
    <strong>{{ searchIndicator }}</strong>
</div>
<script>
new Vue({
    el: '#debounce-search-demo',
    data: {
        searchQuery: '',
        searchQueryIsDirty: false,
        isCalculating: false
    },
    computed: {
        searchIndicator: function() {
            if (this.isCalculating) {
                return '⟳ Fetching new results'
            } else if (this.searchQueryIsDirty) {
                return '... Typing'
            } else {
                return '✓ Done'
            }
        }
    },
    watch: {
        searchQuery: function() {
            this.searchQueryIsDirty = true
            this.expensiveOperation()
        }
    },
    methods: {
        // This is where the debounce actually belongs.
        expensiveOperation: _.debounce(function() {
            this.isCalculating = true
            setTimeout(function() {
                this.isCalculating = false
                this.searchQueryIsDirty = false
            }.bind(this), 1000)
        }, 500)
    }
})
</script>

这种处理方式的另一个优点是可以自主选择节流/去抖包装函数。比如在提供搜索候选建议的时候,实际上更应该使用一个节流(throttle)函数而非去抖(debounce)函数,因为去抖总会在用户输入结束后一段时间才给出搜索建议,这是不太理想的。如果你使用了类似lodash的工具库,从debounce重构为throttle也是很方便的。

v-modellazynumber属性 废弃

现在lazynumber属性应作为修饰符配合v-model指令使用,这样更清晰一些


<input v-model="name" lazy>
<input v-model="age" type="number" number>

替换为


<input v-model.lazy="name">
<input v-model.number="age" type="number">

v-model与行内value属性 废弃

v-model不再将value属性的值视为其初始值。为了更好的可预测性,它始终把vue实例作为数据源。

也就是说


<input v-model="text" value="foo">

数据基于vue实例


data: {

 text: 'bar'

}

输入框的值将会渲染为"bar"而非"foo",给定初始值的<textarea>同理。


<textarea v-model="text">
 hello world
</textarea>

所以需要确保text的初始值是"hello world"

v-modelv-for原始类型的遍历值 废弃

下诉的表达式不再有效:


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

因为<input>编译后等价的代码如下所示


strings.map(function (str) {

 return createElement('input', ...)

})

显而易见,v-model的双向绑定不再有意义,因为设置局部变量str的值不会对strings有任何影响 应该使用一个元素为对象的数组,这样v-model`就可以更新数组内每个元素的值了(因为传入的是对象的引用)。


<input v-for="obj in objects" v-model="obj.str">

v-bind:style在对象语法中使用!important 废弃

下面的表达式不再有效


<p v-bind:style="{ color: myColor + ' !important' }">hello</p>

如果你确实需要使用!important,可以这样:


<p v-bind:style="'color: ' + myColor + ' !important'">hello</p>

v-el and v-ref 废弃

为了更简洁,v-elv-ref指令被合并到属性ref中,可以通过$refs在组件实例上获取。v-el:my-element变为ref="myElement"v-ref:my-component变为ref="myComponent"。当在普通dom元素上使用时,ref将获取到dom元素,用于组件上时,将获取到组件实例。

由于v-ref不再是一个指令,只是一个特殊的属性,因此可以被动态定义,这在与v-for组合使用是尤其有用


<p v-for="item in items" v-bind:ref="'item' + item.id"></p>

先前,v-el/v-refv-for组合使用时,由于无法给每个条目不同的名称,会得到一个dom元素或者组件的数组。现在,仍然可以通过设置相同的ref来使用这个特性。


<p v-for="item in items" ref="items"></p>

和1.x版本不一样,$refs不再是响应式的,因为它们注册/更新依赖于渲染过程本身,要使它是响应式的,需要在每次改变时重复渲染。(不太理解,附上原文。Unlike in 1.x, these $refs are not reactive, because they’re registered/updated during the render process itself. Making them reactive would require duplicate renders for every change.)

另一方面,$refs本来是设计用来在代码里获取组件/dom元素的,因此不建议在模板里面过于依赖它,会引入不属于实例本身的状态,违反了数据驱动的view模型(不太理解,附上原文。On the other hand, $refs are designed primarily for programmatic access in JavaScript - it is not recommended to rely on them in templates, because that would mean referring to state that does not belong to the instance itself. This would violate Vue's data-driven view model.)

v-elsev-show 废弃

v-else不再配合v-show使用(作用于同一个dom元素)。请使用v-if表达式替代。示例如下,


<p v-if="foo">Foo</p>

<p v-else v-show="bar">Not foo, but bar</p>

替换为


<p v-if="foo">Foo</p>

<p v-if="!foo && bar">Not foo, but bar</p>

自定义指令

指令的应用场景被大幅削减,他们目前主要被用来底层(low-level)的dom操作。大多数情况下,开发者更应该倾向于使用组件来实现代码重用,而不是通过自定义指令(比如,弃用v-drapload,使用<list-view></list-view>)。

一些需要特别之处的不同之处如下,

  • 指令不再有实例,也就意味着不能在指令内部通过this访问到该指令的实例。指令几乎将所有需要的数据作为钩子函数(hook functions,)的参数(el,binding,vnode,oldVnode)接收,如果实在需要维护跨钩子的状态,可以使用el(唯一可写的的参数,可以操作它的dataSet
  • 高级选项,例如acceptStatementdeeppriority等都已废弃。
  • 一些原有的钩子的行为发生了变化,另外还添加了一些新的钩子函数。

幸运的是,新的指令系统简单的多,你可以更容易地掌握它们。自定义指令教程

指令.literal修饰符 废弃

指令.literal修饰符被移除了,因为直接传入一个字符串字面量可以更容易地达到同样的效果

比如将


<p v-my-directive.literal="foo bar baz"></p>

替换为


<p v-my-directive="'foo bar baz'"></p>

Transitions

transition属性 废弃

Vue过渡效果(transition)体系完全改变了,现在使用<transition><transition-group>组件来作为包裹容器,而不是使用transition属性,了解更多的细节请阅读Transitions教程(内容异常丰富)。

使用Vue.transition定义可重用的Transitions 废弃

在新的transition体系内,可以使用组件来定义可重用的transition

Transition渐进过渡属性stagger 废弃

如果需要实现列表的渐进过渡效果,可以给元素设置data-index或者类似的属性,然后在transiton钩子函数中获取它来控制过渡开始的时间(delay)一个示例

Events

events配置 废弃

组件events配置项被废弃。事件处理器(Event handlers)应在created钩子内注册。查看后文$dispatch$broadcast获取详细信息

Vue.directive('on').keyCodes 废弃

一个新的更简洁的keyCodes配置方式是Vue.config.keyCodes


// enable v-on:keyup.f1

Vue.config.keyCodes.f1 = 112

$dispatch$broadcast 废弃

$dispatch$broadcast被废弃,更利于跨组件通信和以及引入可维护性更好的状态管理方案,比如Vuex

先前事件系统的问题在于事件流依赖于组件树的结构,当组件树的规模变得太大以后,事件流很难追溯,非常脆弱。这一切都是因为当初没有规划好,我们不想继续使你为此感到痛苦。另外$dispatch$broadcast也不能进行同级组件间的通信。

这些事件方法最普遍的使用场景是父组件和它的直接子组件们通信。大多数情况下,你可以用v-on监听来自子组件的$emit行为(listen to an $emit from a child with v-on)。这样保持了事件的直观,便利。

但是,当进行隔代组件之间的通信时,$emit方法并不有效。我们会使用一个集中式的事件管理器(centralized event hub),它可以允许在组件树中的任何位置进行通信,甚至是同级组件间的通信。实现的思路之一:Vue的实例提供了一个事件触发器,因此你可以创建一个空vue实例来作为这个事件管理器。

比如,一个土豆(todo)app的结构如下


Todos
|-- NewTodoInput
|-- Todo
|-- DeleteTodoButton

我们可以用一个事件管理器管理组件间的通信:


// This is the event hub we'll use in every
// component to communicate between them.

var eventHub = new Vue()

在组件中,我们可以分别使用$emit$on$off触发事件、监听事件、解绑事件


// NewTodoInput
// ...

methods: {
  addTodo: function () {
    eventHub.$emit('add-todo', { text: this.newTodoText })
    this.newTodoText = ''
  }
}

// DeleteTodoButton
// ...

methods: {
  deleteTodo: function (id) {
    eventHub.$emit('delete-todo', id)
  }
}

// Todos
// ...

created: function () {
  eventHub.$on('add-todo', this.addTodo)
  eventHub.$on('delete-todo', this.deleteTodo)
},

// It's good to clean up event listeners before
// a component is destroyed.

beforeDestroy: function () {
  eventHub.$off('add-todo', this.addTodo)
  eventHub.$off('delete-todo', this.deleteTodo)
},

methods: {
  addTodo: function (newTodo) {
    this.todos.push(newTodo)
  },
  deleteTodo: function (todoId) {
    this.todos = this.todos.filter(function (todo) {
      return todo.id !== todoId
    })
  }
}

这种模式可以在比较简单的场景下作为$dispatch$broadcast的替代,在更复杂的场景下,建议使用专用的状态管理工具比如Vuex

Filters

文本插入以外的过滤器废弃

现在过滤器只能用于文本插入({{ }})标签内。先前将过滤器用于v-modelv-on等指令内造成的麻烦比带来的便利要多;在v-for指令中使用过滤器也不如在js中使用计算属性来得复用性好。

通常,如果某些功能可以通过纯js代码实现,就尽量避免引入特殊的语法比如过滤器去做相应处理。以下介绍如何来替换这些内建的过滤器。

替代debounce过滤器

不再使用


<input v-on:keyup="doStuff | debounce 500">

methods: {
  doStuff: function () {
  // ...
  }
}

而是使用lodash's debounce(或者可以节流throttle的工具)直接限制高耗操作的调用.可以像下面这样实现上面的dobounce功能:


<input v-on:keyup="doStuff">

methods: {
  doStuff: _.debounce(function () {
  // ...
  }, 500)
}

了解这种实现方式的更多好处可以查看前文v-modeldebounce

替代limitBy过滤器

不再使用


<p v-for="item in items | limitBy 10">{{ item }}</p>

而是在一个计算属性里使用js原生.slice方法:


<p v-for="item in filteredItems">{{ item }}</p>

computed: {
  filteredItems: function () {
    return this.items.slice(0, 10)
  }
}

替代filterBy过滤器

不再使用


<p v-for="user in users | filterBy searchQuery in 'name'">{{ user.name }}</p>

而是在一个计算属性里使用js原生.filter方法


<p v-for="user in filteredUsers">{{ user.name }}</p>

computed: {
  filteredUsers: function () {
    return this.users.filter(function (user) {
       return user.name.indexOf(this.searchQuery)
    })
  }
}

js的原生.filter方法可以在计算属性里处理更复杂的过滤操作,能发挥出js的全部的能力。例如过滤出所有激活且他们的邮箱或名字能大小写不敏感地匹配搜索关键字的用户。


this.users.filter(function (user) {
  var searchRegex = new RegExp(this.searchQuery, 'i')
  return user.isActive && (
    searchRegex.test(user.name) ||
    searchRegex.test(user.email)
  )
})

替代orderBy过滤器

不再使用


<p v-for="user in users | orderBy 'name'">{{ user.name }}</p>

而是在一个计算属性里使用lodash's orderBy(或者类似的排序的工具):


<p v-for="user in orderedUsers">{{ user.name }}</p>

computed: {
  orderedUsers: function () {
    return _.orderBy(this.users, 'name')
  }
}

甚至可以依据多条件排序:


_.orderBy(this.users, ['name', 'last_login'], ['asc', 'desc'])

过滤器参数语法

过滤器参数语法现在更类似于js的函数调用,先前用空格隔开参数的方式不再使用


<p>{{ date | formatDate 'YY-MM-DD' timeZone }}</p>

使用括号包裹所有参数,参数之间用逗号分隔:


<p>{{ date | formatDate('YY-MM-DD', timeZone) }}</p>

内建的文本过滤器废弃

虽然文本插入标签被还是允许使用过滤器的,但是这个内建的文本过滤器全被移除。建议使用专门的工具库实现日期格式装换(date-fns)或者货币处理(accounting)等

我们提供了每个原有内建文本过滤器的替换方式,可以将他们使用在自定义帮助函数中、方法、计算属性中。

替代json过滤器

实际上,根本不需要将debug信息转成json字符串,vue自动会做这些事,无论是什么类型的数据。如果还是需要这种功能,可以在方法或者计算属性内使用JSON.stringify

替代capitalize过滤器


text[0].toUpperCase() + text.slice(1)

替代uppercase过滤器


text.toUpperCase()

替代lowercase过滤器


text.toLowerCase()

替代pluralize过滤器

pluralizenpm包可以很好的实现“复数化”这个功能。如果只是想要处理特定语汇的复数形式或者仅仅是处理输出为“零”的情况,可以自定义一个pluralize方法,例如:


function pluralizeKnife (count) {
  if (count === 0) {
    return 'no knives'
  } else if (count === 1) {
    return '1 knife'
  } else {
    return count + 'knives'
  }
}

Replacing the currency Filter

一个非常简单的实现如下


'$' + price.toFixed(2)

在很多情况下,toFixed方法会出现一些怪异行为,比如0.035.toFixed(2)向上舍入为0.04,但是0.045.toFixed(2)却向下舍入为0.04。为了解决这个问题,可以使用accounting获得更可靠的货币格式化结果。

双向过滤器 废弃

一些用户喜欢配合v-model使用双向过滤器来实现一些有趣的输入,只需要很少的几行代码。但这只是一个看上去简单的方式,双向过滤器会造成大量不易察觉的复杂性,甚至因为状态更新的延迟带来糟糕的用户体验。建议使用组件包装input标签,这是一种更显式、更功能丰富的自定义输入组件解决方案。

下面是一个双向过滤器的迁移示例:

在多数情况下,它都能正常工作,但是由于状态的延迟更新会造成一些怪异的行为。比如,切换到上面的demo到Result页面,在任意一个输入框中输入9.999,当输入框失焦以后,它的值会更新为$10.00,但是计算结果却是9.999,也就是说输入框实际存储值为9.999,实际数据和用户感知并不同步。

以下使用Vue2.0来实现一个更健壮的解决方案。首先用<currency-input>组件包裹这个双向过滤器:

这样可以允许添加一些过滤器单独不能封装的功能,比如选择在输入框获得焦点以后选中全部文本。下一步是提取过滤器的业务逻辑。通过引入一个外部依赖currencyValidator来实现所有操作:

模块化的增强不仅使过滤器更易于向Vue2.0迁移,也让货币值解析和格式化可以:

  • 独立于vue进行单元测试
  • 用于应用的其他部分,比如api请求的参数校验。

将验证器抽取出来,利于更顺畅地构建一个健壮的解决方案。异常的状态都被排除,实际上用户不会不会输入任何错误内容。

最后一步,升级到Vue2.0

也许你应经注意到了:

  • 使用生命周期钩子函数和DOM事件来替代隐式的双向过滤器操作,写入和读取过程都更明晰

  • 仍然可以直接在自定义input组件上使用v-model指令,不仅与普通输入框保持一致,而且是Vuex友好的。

  • 由于我们不使用过滤器,货币格式化处理可以异步进行,这意味着如果有很多app需要处理诸如货币格式化的问题,可以很容易地将其重构为一个共享的微服务。

Slots

重复插槽Slots 废弃

同一个template里不再支持同名的<slot>。当一个slot被渲染过后,就不能在同一渲染树(render tree)再次渲染。如果非要在template里不同位置渲染相同内容,请将内容作为prop传入。

slot属性用于css样式(选择器) 废弃

通过具名<slot>插入的内容不再保留slot属性(因此不再能用[slot="my-slot-name"]定义样式了)。使用一个包裹元素来定义样式,或者以编程方式 使用渲染函数来控制插入内容。

特殊属性

keep-alive属性 废弃

keep-alive不再是一个特殊属性,而是一个容器组件(wrapper component),类似于<transition>。例如:


<keep-alive>

 <component v-bind:is="view"></component>

</keep-alive>

<keep-alive>使得条件引入子组件得以实现


<keep-alive>

 <todo-list v-if="todos.length > 0"></todo-list>

 <no-todos-gif v-else></no-todos-gif>

</keep-alive>

注意:当 <keep-alive>有多个子组件时,最终只有第一个能渲染出来,其他都被忽略。

当与<transition>一同使用的时候,确保<keep-alive>被嵌套在<transition>内部:


<transition>

 <keep-alive>

 <component v-bind:is="view"></component>

 </keep-alive>

</transition>

插值Interpolation

属性内插值 废弃

在属性内插值不再有效,例如:


<button class="btn btn-{{ size }}"></button>

应该使用行内表达式:


<button v-bind:class="'btn btn-' + size"></button>

或者使用data属性/计算属性:


<button v-bind:class="buttonClasses"></button>

computed: {
  buttonClasses: function () {
    return 'btn btn-' + size
  }
}

HTML插值(插入html) 废弃

使用{{{ foo }}}插入hmtl已被废弃,更好的方法是使用v-html指令

One-Time Bindings 废弃

单次绑定({{* foo }})已被废弃,更好的方法是使用[v-once指令]v-once directive

响应性(Reactivity)

vm.$watch

通过vm.$watch创建的watcher对象现在会在关联组件渲染前被触发(todo:之前?)。这给了在组件再次渲染以前更新状态的机会,因此避免了一些不必要的重新渲染。举例来说,watch一个组件的某prop,然后在这个prop更新时更新组件的自身数据(,然后才会发生渲染)。

如果之前依赖vm.$watch做了一些渲染后的dom操作(todo:似乎并没有在1.0文档中明确表示vm.$watch的回调在渲染完成后执行),可以在updated钩子内来重构。

vm.$set

先前vm.$set的行为已被废弃(最直观的,旧的vm.$set和新的vm.$set参数形式不同),现在只是全局Vue.set的别名。

vm.$delete

先前vm.$deleteset的行为已被废弃,现在只是全局Vue.delete的别名。

Array.prototype.$set 废弃

使用Vue.set替代

Array.prototype.$remove 废弃

使用Vue.set替代。例如:


methods: {
  removeTodo: function (todo) {
    var index = this.todos.indexOf(todo)
    this.todos.splice(index, 1)
  }
}

或者更好的实现方式是传入一个索引


methods: {
  removeTodo: function (index) {
    this.todos.splice(index, 1)
  }
}

vue实例上的Vue.setVue.delete 废弃

实例上的Vue.setVue.delete方法不再能使用。现在强制性的要求所有顶级(top-level)data属性必须在data属性内显示声明(由于Vue.set不允许第一个参数为vue实例的$data对象,所以不可能动态添加顶级data属性)。如果需要移除vue实例上的某个属性或者它的$data,直接将属性设置为null即可。

替换vm.$data 废弃

现在禁止替换一个组件实例的vm.$data。这是为了防止在响应系统中一些边界情况(edge cases),使得组件状态更可预测,特别是在类型检查系统中(type-checking,TypeScipt?)

vm.$get 废弃

直接访问响应属性即可。

DOM操作实例方法

vm.$appendTo 废弃

使用原生方法:


myElement.appendChild(vm.$el)

vm.$before 废弃

使用原生方法:


myElement.parentNode.insertBefore(vm.$el, myElement)

vm.$after 废弃

使用原生方法:


myElement.parentNode.insertBefore(vm.$el, myElement.nextSibling)

如果myElement是最后一个子元素:


myElement.parentNode.appendChild(vm.$el)

vm.$remove 废弃

使用原生方法:


vm.$el.remove()

元实例方法(Meta Instance Methods)

vm.$eval 废弃

没有实际用途。如果使用了这个特性且不知道怎么重构处理,到论坛上问问吧the forum

vm.$interpolate 废弃

(用来计算插值{{...}}的输出结果)没有实际用途。如果使用了这个特性且不知道怎么重构处理,到论坛上问问吧the forum

vm.$log 废弃

使用Vue Devtools获的可视化的调试体验。

实例上的DOM相关配置

replace: false 废弃

组件现在总会覆盖掉它的挂载元素。为了模拟replace: false的行为,可以用一个和将被替换元素相似的元素包裹组件的根节点,例如:


new Vue({
  el: '#app',
  template: '<div id="app"> ... </div>'
})

或者使用渲染函数


new Vue({
  el: '#app',
  render: function (h) {
    h('div', {
      attrs: {
        id: 'app',
      }
    }, /* ... */)
  }
})

全局配置

Vue.config.debug 废弃

不再必要,默认会呈现错误警告的调用栈。

Vue.config.async 废弃

为了更好的渲染性能,异步模式是必须的(不能使用同步模式,这个配置就没什么意义了)。

Vue.config.delimiters 废弃

插值符号{{}}的配置被整合到了组件的顶级配置中,可被替代的插值符号可以允许你在app中使用第三方组件,而不破坏第三方库。

Vue.config.unsafeDelimiters 废弃

HTML插值符号{{{}}}被废弃,请使用v-html指令。

全局API

Vue.extendel 废弃

el配置不再用于Vue.extend(组件的定义),只在实例创建中有效(new Vue({el:"#selector"})

Vue.elementDirective 废弃

元素指令被废弃,使用组件代替。

Vue.partial 废弃

partial(html片段)被废弃。除用于性能关键(performance-critical)的场景外,建议使用普通组件代替。如果使用了partial name可以动态绑定的特性,使用动态组件代替。

如果确实是用于性能关键场景,可以使用functional components。这种组件无状态,无实例(内部不能用this访问),常常是JS/JSX文件而不是.vue文件,就像partials一样(似乎在1.0文档里没有明确提到过partials渲染性能高的特性,但是也可以想象得出来),渲染速度回极快。

functional components优于partials的地方在于它可以更灵活(dynamic),因为可以使用JavaScript的全部功能。但是如果从来没有使用过具有渲染函数的组件框架(React应该算是吧),也许需要花点功夫去学习学习。



水平有限,译文在尽量尊重原文的原则下保证中文表达的顺畅,如有不妥,欢迎邮件PR

results matching ""

    No results matching ""