三羊

三羊的小站

看vue源码解决组件style更新问题

December 03, 2018/「 vue / Edit on Github ✏️

最近在项目碰到了一个 vue 组件更新导致 style 异常的问题。下面记录一下我自己的解决思路。

问题背景

由于公司项目业务复杂,就不具体描述了。简单说一下问题,就是项目使用 vue 框架,在一个页面中根据 a 值来显示不同组件,当a = true时显示 A 组件,否则就显示 B 组件。示例代码如下

<template>
  <div>
      <div v-if="a" :style="getBackground('a')">a组件</div>
      <div v-else :style="getBackground('b')">b组件</div>
  </div>
</template>

<script>
    export default {
        name:'Example',
        data: {
            a: false
        },
        computed: {
            getBackground: function(type) {
                return {
                    background: `url(https://${type}.png) no-repeat`,
                    backgroundSize: '100% 100%',
                }
            }
        }
        mounted() {
            setTimeout(() => { this.a = true }, 1000)
        }
    }
</script>

问题描述

如上代码,页面加载时,显示 a 组件,且它的背景样式是设置了backgroundImagebackgroundSize100% 100%,一秒之后,a 变为false了,这是显示 b 组件,预期之中,它也是应该设置了backgroundImagebackgroundSize100% 100%,但是呢,在显示 b 组件,它的样式,backgroundSize并不是100% 100%,而是默认的initial,这样导致样式并非我们预期想要的。究竟为什么在显示 b 组件 时,这个backgroundSize不是我们在getBackground中返回的 100%呢?

分析问题

为什么显示 b 组件 时样式不是我们预期的呢,这里,可以看到 a 组件b 组件 都是 div标签,根据vue 官方文档描述,它们在更新时会被复用的,就是说只会创建 a 组件 的 div 元素,在更新 b 组件时,会复用 a 组件 创建出来的 div 元素的。并且翻看了vue 更新组件部分源码,也确实会先判断是否是相同的元素类型,如果是,就只是更新,而不会重新创建。但是,就算是复用,那也不应该把backgroundSize覆盖了initial呀?何况这 2 个组件都设置的backgroundSize100% 100%

接着,我又翻看了更新 style 部分的源码才发现了原因出在哪。下面贴出 vue 更新 stye 部分的源码如下

// 获取待更新vnode的style绑定值
const newStyle = getStyle(vnode, true)

// 如果在旧的vnode中且不在新的vnode的style中,则删除
for (name in oldStyle) {
  if (isUndef(newStyle[name])) {
    setProp(el, name, "")
  }
}
// 如果在新的vnode中,且不等于旧的vnode中值,则更新为新的vnode中style值
for (name in newStyle) {
  cur = newStyle[name]
  if (cur !== oldStyle[name]) {
    // ie9 setting to null has no effect, must use empty string
    setProp(el, name, cur == null ? "" : cur)
  }
}

源码逻辑很简单,就是先删除了在旧的 vnode 中 style 而不在新的 vnode 中 style 的值,接着设置在新的 vnode 中且不等于旧的 vnode 中值的。结合上面我们问题代码,逻辑应该是,

  1. background 存在 a 组件b 组件 中,但是值不相等,应该被更新,
  2. backgroundSize 存在 a 组件b 组件 中,值相等,不更新

这样一来,由于 a 组件b 组件 是复用的同一个 div 元素,我们再来具体看一下 div 元素 style 被更新的过程,

  • 先是在 a 组件 中,div 被设置的应该是如下样式
div {
  background: "url(https://a.png) no-repeat",
  backgroundSize: '100% 100%',
}

我们知道,只设置background的话,它的backgroundSize默认值是initial,但是后面的backgroundSize会覆盖background中默认值,所以这时没有毛病,显示正常

  • 接着,更新为 b 组件 了,div 被设置的样式应该如下
div {
  //background: "url(https://a.png) no-repeat", //a组件中设置样式
  backgroundSize: '100% 100%', //a组件中设置样式
  background: "url(https://b.png) no-repeat", //b组件中设置样式
}

这个时候,我们发现,实际上,设置的background会用默认值initial覆盖掉之前 a 组件中设置的backgroundSize100% 100%,所以这个时候,在显示 b 组件 时,backgroundSize变为了默认值initial。坑爹呀,😢。

解决问题

知道问题是出现在组件复用和background设置顺序问题上,那么解决的办法就非常简单了,

  1. 方法一就是给 a 组件b 组件 设置不同的 key,这样就不会复用,也不会出现上面的问题了,但是呢,感觉跟 vue 遵循的复用原则相违背,性能也会有所损失(我们就是要追求极致 😂)。
  2. 方法二就是设置 background 时直接使用backgroundImage而不是background,因为设置background会附带设置了其他一些背景相关的 css 样式值,实际上background是一系列背景样式值的简写,

The property is a shorthand that sets the following properties in a single declaration: background-clip, background-color, background-image, background-origin, background-position, background-repeat, background-size, and background-attachment.

总结

就业务背景而言,业务上是不可能出现页面内 a 会变化的,也就是说,用户打开页面,那么页面根据 a 来选择显示哪个组件,之后是不会变的。但是就有某种特殊情况下,a 在页面未刷新情况下,变化了,导致更新为显示另一个组件了。自己在做业务需求时,代码逻辑一定要多加严谨,同时要深入理解框架的底层实现原理,才能更好的避免未知 bug。

就这个 bug 而言,应该有三个基础知识点:

  1. css 规则中,后面的会覆盖前面的
  2. background 等实际上是一系列 css 规则的简写
  3. vue 中组件复用以及高效更新 style 逻辑

若有收获,小额鼓励