Close
升级到 Vue 3 | Vue 2 EOL

混入

基础

混入是一种灵活的方式,用于为 Vue 组件分发可重用的功能。混入对象可以包含任何组件选项。当组件使用混入时,混入中的所有选项将“混合”到组件自身的选项中。

示例

// define a mixin object
var myMixin = {
created: function () {
this.hello()
},
methods: {
hello: function () {
console.log('hello from mixin!')
}
}
}

// define a component that uses this mixin
var Component = Vue.extend({
mixins: [myMixin]
})

var component = new Component() // => "hello from mixin!"

选项合并

当混入和组件本身包含重叠的选项时,它们将使用适当的策略“合并”。

例如,数据对象进行递归合并,在发生冲突的情况下,组件的数据优先。

var mixin = {
data: function () {
return {
message: 'hello',
foo: 'abc'
}
}
}

new Vue({
mixins: [mixin],
data: function () {
return {
message: 'goodbye',
bar: 'def'
}
},
created: function () {
console.log(this.$data)
// => { message: "goodbye", foo: "abc", bar: "def" }
}
})

具有相同名称的钩子函数将合并到一个数组中,以便所有钩子函数都将被调用。混入钩子函数将在组件自身的钩子函数**之前**被调用。

var mixin = {
created: function () {
console.log('mixin hook called')
}
}

new Vue({
mixins: [mixin],
created: function () {
console.log('component hook called')
}
})

// => "mixin hook called"
// => "component hook called"

期望对象值的选项,例如 methodscomponentsdirectives,将合并到同一个对象中。在这些对象中存在冲突的键时,组件的选项将优先。

var mixin = {
methods: {
foo: function () {
console.log('foo')
},
conflicting: function () {
console.log('from mixin')
}
}
}

var vm = new Vue({
mixins: [mixin],
methods: {
bar: function () {
console.log('bar')
},
conflicting: function () {
console.log('from self')
}
}
})

vm.foo() // => "foo"
vm.bar() // => "bar"
vm.conflicting() // => "from self"

请注意,Vue.extend() 中使用了相同的合并策略。

全局混入

您也可以全局应用混入。谨慎使用!一旦您全局应用了混入,它将影响之后创建的**所有** Vue 实例。如果使用得当,这可以用于为自定义选项注入处理逻辑。

// inject a handler for `myOption` custom option
Vue.mixin({
created: function () {
var myOption = this.$options.myOption
if (myOption) {
console.log(myOption)
}
}
})

new Vue({
myOption: 'hello!'
})
// => "hello!"

谨慎且适度地使用全局混入,因为它会影响创建的每个 Vue 实例,包括第三方组件。在大多数情况下,您应该只将其用于自定义选项处理,如上面的示例所示。将它们作为插件发布也是一个好主意,以避免重复应用。

自定义选项合并策略

当自定义选项合并时,它们使用默认策略,该策略会覆盖现有值。如果您希望自定义选项使用自定义逻辑合并,则需要将一个函数附加到 Vue.config.optionMergeStrategies

Vue.config.optionMergeStrategies.myOption = function (toVal, fromVal) {
// return mergedVal
}

对于大多数基于对象的选项,您可以使用 methods 使用的相同策略。

var strategies = Vue.config.optionMergeStrategies
strategies.myOption = strategies.methods

可以在 Vuex 的 1.x 合并策略中找到更高级的示例。

const merge = Vue.config.optionMergeStrategies.computed
Vue.config.optionMergeStrategies.vuex = function (toVal, fromVal) {
if (!toVal) return fromVal
if (!fromVal) return toVal
return {
getters: merge(toVal.getters, fromVal.getters),
state: merge(toVal.state, fromVal.state),
actions: merge(toVal.actions, fromVal.actions)
}
}