美文网首页
阅读vue源码笔记(六)createElement

阅读vue源码笔记(六)createElement

作者: 景阳冈大虫在此 | 来源:发表于2020-03-30 00:03 被阅读0次
    // src/core/instance/lifecycle.js
     updateComponent = () => {
          vm._update(vm._render(), hydrating)
      }
    

    上篇提到,在initRender中在实例vm上提供了createElement方法,在render函数中会调用它去创建VNode,那么这个方法具体做了些什么呢?

    // src/core/instance/render.js
    export function initRender (vm: Component) {
    ……
      vm._c = (a, b, c, d) => createElement(vm, a, b, c, d, false)
     
      vm.$createElement = (a, b, c, d) => createElement(vm, a, b, c, d, true)
    ……
    }
    

    createElement

    // src/core/vdom/create-element.js
    export function createElement (
      context: Component,
      tag: any,
      data: any,
      children: any,
      normalizationType: any,
      alwaysNormalize: boolean
    ): VNode | Array<VNode> {
      if (Array.isArray(data) || isPrimitive(data)) {
        normalizationType = children
        children = data
        data = undefined
      }
      if (isTrue(alwaysNormalize)) {
        normalizationType = ALWAYS_NORMALIZE
      }
      return _createElement(context, tag, data, children, normalizationType)
    }
    
    export function _createElement (
      context: Component,
      tag?: string | Class<Component> | Function | Object,
      data?: VNodeData,
      children?: any,
      normalizationType?: number
    ): VNode | Array<VNode> {
    ……
    }
    

    createElement里首先判断了data是否为数组或者基础类型,我们可以先看看_createElement里对data类型的限制,是一个VNode
    所以,如果判断为真,则表示data的这个位置放的是children,将会把之后的每一个参数重新纠正赋值。

    _createElement 1

    export function _createElement (
      context: Component,
      tag?: string | Class<Component> | Function | Object,
      data?: VNodeData,
      children?: any,
      normalizationType?: number
    ): VNode | Array<VNode> {
      if (isDef(data) && isDef((data: any).__ob__)) {
        process.env.NODE_ENV !== 'production' && warn(
          `Avoid using observed data object as vnode data: ${JSON.stringify(data)}\n` +
          'Always create fresh vnode data objects in each render!',
          context
        )
        return createEmptyVNode()
      }
      // object syntax in v-bind
      if (isDef(data) && isDef(data.is)) {
        tag = data.is
      }
      if (!tag) {
        // in case of component :is set to falsy value
        return createEmptyVNode()
      }
      // warn against non-primitive key
      if (process.env.NODE_ENV !== 'production' &&
        isDef(data) && isDef(data.key) && !isPrimitive(data.key)
      ) {
        if (!__WEEX__ || !('@binding' in data.key)) {
          warn(
            'Avoid using non-primitive value as key, ' +
            'use string/number value instead.',
            context
          )
        }
      }
      // support single function children as default scoped slot
      if (Array.isArray(children) &&
        typeof children[0] === 'function'
      ) {
        data = data || {}
        data.scopedSlots = { default: children[0] }
        children.length = 0
      }
      if (normalizationType === ALWAYS_NORMALIZE) {
        children = normalizeChildren(children)
      } else if (normalizationType === SIMPLE_NORMALIZE) {
        children = simpleNormalizeChildren(children)
      }
      let vnode, ns
      if (typeof tag === 'string') {
        let Ctor
    ns = (context.$vnode && context.$vnode.ns) || config.getTagNamespace(tag)
        if (config.isReservedTag(tag)) {
          // platform built-in elements
          if (process.env.NODE_ENV !== 'production' && isDef(data) && isDef(data.nativeOn)) {
            warn(
              `The .native modifier for v-on is only valid on components but it was used on <${tag}>.`,
              context
            )
          }
          vnode = new VNode(
            config.parsePlatformTagName(tag), data, children,
            undefined, undefined, context
          )
        } else if ((!data || !data.pre) && isDef(Ctor = resolveAsset(context.$options, 'components', tag))) {
          // component
          vnode = createComponent(Ctor, data, context, children, tag)
        } else {
          // unknown or unlisted namespaced elements
          // check at runtime because it may get assigned a namespace when its
          // parent normalizes children
          vnode = new VNode(
            tag, data, children,
            undefined, undefined, context
          )
        }
      } else {
        // direct component options / constructor
        vnode = createComponent(tag, data, context, children)
      }
      if (Array.isArray(vnode)) {
        return vnode
      } else if (isDef(vnode)) {
        if (isDef(ns)) applyNS(vnode, ns)
        if (isDef(data)) registerDeepBindings(data)
        return vnode
      } else {
        return createEmptyVNode()
      }
    }
    
    1. if (isDef(data) && isDef((data: any).__ob__)):如果data有值且为响应式对象,报错并返回空VNode。

    2.if (isDef(data) && isDef(data.is)):如果data有is属性,则存为tag

    normalizationType和simpleNormalizeChildren

      if (normalizationType === ALWAYS_NORMALIZE) {
        children = normalizeChildren(children)
      } else if (normalizationType === SIMPLE_NORMALIZE) {
        children = simpleNormalizeChildren(children)
      }
    

    这里会根据normalizationType的值去获得children

    simpleNormalizeChildren
    // 1. When the children contains components - because a functional component
    // may return an Array instead of a single root. In this case, just a simple
    // normalization is needed - if any child is an Array, we flatten the whole
    // thing with Array.prototype.concat. It is guaranteed to be only 1-level deep
    // because functional components already normalize their own children.
    export function simpleNormalizeChildren (children: any) {
      for (let i = 0; i < children.length; i++) {
        if (Array.isArray(children[i])) {
          return Array.prototype.concat.apply([], children)
        }
      }
      return children
    }
    

    这里的注释说明,如果child包括了components,那么他就是一个函数式组件,当读到一个为数组的属性时则将这个数组返回。
    参考https://cn.vuejs.org/v2/guide/render-function.html#createElement-%E5%8F%82%E6%95%B0
    此时,传入的数组可能就是这样的

     [
        '先写一些文字',
        createElement('h1', '一则头条'),
        createElement(MyComponent, {
          props: {
            someProp: 'foobar'
          }
        })
      ]
    

    为许多个createElement生成的VNode。

    normalizationType
    // 2. When the children contains constructs that always generated nested Arrays,
    // e.g. <template>, <slot>, v-for, or when the children is provided by user
    // with hand-written render functions / JSX. In such cases a full normalization
    // is needed to cater to all possible types of children values.
    export function normalizeChildren (children: any): ?Array<VNode> {
      return isPrimitive(children)
        ? [createTextVNode(children)]
        : Array.isArray(children)
          ? normalizeArrayChildren(children)
          : undefined
    }
    
    function isTextNode (node): boolean {
      return isDef(node) && isDef(node.text) && isFalse(node.isComment)
    }
    
    function normalizeArrayChildren (children: any, nestedIndex?: string): Array<VNode> {
      const res = []
      let i, c, lastIndex, last
      for (i = 0; i < children.length; i++) {
        c = children[i]
        if (isUndef(c) || typeof c === 'boolean') continue
        lastIndex = res.length - 1
        last = res[lastIndex]
        //  nested
        if (Array.isArray(c)) {
          if (c.length > 0) {
            c = normalizeArrayChildren(c, `${nestedIndex || ''}_${i}`)
            // merge adjacent text nodes
            if (isTextNode(c[0]) && isTextNode(last)) {
              res[lastIndex] = createTextVNode(last.text + (c[0]: any).text)
              c.shift()
            }
            res.push.apply(res, c)
          }
        } else if (isPrimitive(c)) {
          if (isTextNode(last)) {
            // merge adjacent text nodes
            // this is necessary for SSR hydration because text nodes are
            // essentially merged when rendered to HTML strings
            res[lastIndex] = createTextVNode(last.text + c)
          } else if (c !== '') {
            // convert primitive to vnode
            res.push(createTextVNode(c))
          }
        } else {
          if (isTextNode(c) && isTextNode(last)) {
            // merge adjacent text nodes
            res[lastIndex] = createTextVNode(last.text + c.text)
          } else {
            // default key for nested array children (likely generated by v-for)
            if (isTrue(children._isVList) &&
              isDef(c.tag) &&
              isUndef(c.key) &&
              isDef(nestedIndex)) {
              c.key = `__vlist${nestedIndex}_${i}__`
            }
            res.push(c)
          }
        }
      }
      return res
    }
    

    1.首先遍历children,判断如果当前值c为数组,则递归调用当前normalizeArrayChildren函数,得到VNode 数组c。有个优化,如果得到的c最后一个元素和res最后一个元素同为TextNode,则将这两个TextNode合并。然后把c push进res里。
    2.判断c是否为基础类型,若为是,则对其处理
    3.else里是正常的VNode,对c赋予key值并push

    normalizationTypesimpleNormalizeChildren 的区别:
    simpleNormalizeChildren简单地遍历入参,判断是否为数组,是则返回。
    normalizationType 首先判断当前是否为数组,是则递归调用,得到数组内的所有处理过的VNode数组。接下来是一些TextNode的合并,对于正常的VNode对key属性赋值。

    _createElement 2

    让我们回到_createElement
    1.接下来判断的是typeof tag === 'string',如果为真则通过if (config.isReservedTag(tag))判断tag是否为原生的保留标签,如果是,则将tag用parsePlatformTagName处理后(其实是转化成了一个返回入参的箭头函数)与data,children实例化一个VNode

    // src/core/config.js
    parsePlatformTagName: identity,
    
    // src/shared/util.js
    export const identity = (_: any) => _
    

    2.之后的components是对组件的解析。
    3.如果不是上述两种情况,则用tag,data,children直接实例化一个VNode

    终上所述,在本篇最开始的那段关键代码中,其实_render的返回值就是这里说到的经过createElement处理后的返回值:VNode一维数组

    相关文章

      网友评论

          本文标题:阅读vue源码笔记(六)createElement

          本文链接:https://www.haomeiwen.com/subject/qjmxuhtx.html