关于vue.js:Vue-源码解读11-render-helper

前言

上一篇文章 Vue 源码解读（10）—— 编译器 之 生成渲染函数 最初讲到组件更新时，须要先执行编译器生成的渲染函数失去组件的 vnode。

渲染函数之所以能生成 vnode 是通过其中的 _c、_l、、_v、_s 等办法实现的。比方：

• 一般的节点被编译成了可执行 _c 函数
• v-for 节点被编译成了可执行的 _l 函数
• …

然而到目前为止咱们都不分明这些办法的原理，它们是如何生成 vnode 的？只晓得它们是 Vue 实例办法，明天咱们就从源码中找答案。

指标

在 Vue 编译器的根底上，进一步深刻了解一个组件是如何通过这些运行时的工具办法（render helper）生成 VNode 的

源码解读

入口

咱们晓得这些办法是 Vue 实例办法，依照之前对源码的理解，实例办法个别都放在 /src/core/instance 目录下。其实之前在 Vue 源码解读（6）—— 实例办法 浏览中见到过 render helper，在文章的最初。

/src/core/instance/render.js

export function renderMixin (Vue: Class<Component>) {
  // install runtime convenience helpers
  // 在组件实例上挂载一些运行时须要用到的工具办法
  installRenderHelpers(Vue.prototype)
  
  // ...
}

installRenderHelpers

/src/core/instance/render-helpers/index.js

/**
 * 在实例上挂载简写的渲染工具函数，这些都是运行时代码
 * 这些工具函数在编译器生成的渲染函数中被应用到了
 * @param {*} target Vue 实例
 */
export function installRenderHelpers(target: any) {
  /**
   * v-once 指令的运行时帮忙程序，为 VNode 加上打上动态标记
   * 有点多余，因为含有 v-once 指令的节点都被当作动态节点解决了，所以也不会走这儿
   */
  target._o = markOnce
  // 将值转换为数字
  target._n = toNumber
  /**
   * 将值转换为字符串模式，一般值 => String(val)，对象 => JSON.stringify(val)
   */
  target._s = toString
  /**
   * 运行时渲染 v-for 列表的帮忙函数，循环遍历 val 值，顺次为每一项执行 render 办法生成 VNode，最终返回一个 VNode 数组
   */
  target._l = renderList
  target._t = renderSlot
  /**
   * 判断两个值是否相等
   */
  target._q = looseEqual
  /**
   * 相当于 indexOf 办法
   */
  target._i = looseIndexOf
  /**
   * 运行时负责生成动态树的 VNode 的帮忙程序，实现了以下两件事
   *   1、执行 staticRenderFns 数组中指定下标的渲染函数，生成动态树的 VNode 并缓存，下次在渲染时从缓存中间接读取（isInFor 必须为 true）*   2、为动态树的 VNode 打动态标记
   */
  target._m = renderStatic
  target._f = resolveFilter
  target._k = checkKeyCodes
  target._b = bindObjectProps
  /**
   * 为文本节点创立 VNode
   */
  target._v = createTextVNode
  /**
   * 为空节点创立 VNode
   */
  target._e = createEmptyVNode
}

_o = markOnce

/src/core/instance/render-helpers/render-static.js

/**
 * Runtime helper for v-once.
 * Effectively it means marking the node as static with a unique key.
 * v-once 指令的运行时帮忙程序，为 VNode 加上打上动态标记
 * 有点多余，因为含有 v-once 指令的节点都被当作动态节点解决了，所以也不会走这儿
 */
export function markOnce (
  tree: VNode | Array<VNode>,
  index: number,
  key: string
) {markStatic(tree, `__once__${index}${key ? `_${key}` : ``}`, true)
  return tree
}

markStatic

/src/core/instance/render-helpers/render-static.js

/**
 * 为 VNode 打动态标记，在 VNode 上增加三个属性：* {isStatick: true, key: xx, isOnce: true or false} 
 */
function markStatic (
  tree: VNode | Array<VNode>,
  key: string,
  isOnce: boolean
) {if (Array.isArray(tree)) {
    // tree 为 VNode 数组，循环遍历其中的每个 VNode，为每个 VNode 做动态标记
    for (let i = 0; i < tree.length; i++) {if (tree[i] && typeof tree[i] !== 'string') {markStaticNode(tree[i], `${key}_${i}`, isOnce)
      }
    }
  } else {markStaticNode(tree, key, isOnce)
  }
}

markStaticNode

/src/core/instance/render-helpers/render-static.js

/**
 * 标记动态 VNode
 */
function markStaticNode (node, key, isOnce) {
  node.isStatic = true
  node.key = key
  node.isOnce = isOnce
}

_l = renderList

/src/core/instance/render-helpers/render-list.js

/**
 * Runtime helper for rendering v-for lists.
 * 运行时渲染 v-for 列表的帮忙函数，循环遍历 val 值，顺次为每一项执行 render 办法生成 VNode，最终返回一个 VNode 数组
 */
export function renderList (
  val: any,
  render: (
    val: any,
    keyOrIndex: string | number,
    index?: number
  ) => VNode
): ?Array<VNode> {
  let ret: ?Array<VNode>, i, l, keys, key
  if (Array.isArray(val) || typeof val === 'string') {
    // val 为数组或者字符串
    ret = new Array(val.length)
    for (i = 0, l = val.length; i < l; i++) {ret[i] = render(val[i], i)
    }
  } else if (typeof val === 'number') {
    // val 为一个数值，则遍历 0 - val 的所有数字
    ret = new Array(val)
    for (i = 0; i < val; i++) {ret[i] = render(i + 1, i)
    }
  } else if (isObject(val)) {
    // val 为一个对象，遍历对象
    if (hasSymbol && val[Symbol.iterator]) {
      // val 为一个可迭代对象
      ret = []
      const iterator: Iterator<any> = val[Symbol.iterator]()
      let result = iterator.next()
      while (!result.done) {ret.push(render(result.value, ret.length))
        result = iterator.next()}
    } else {
      // val 为一个一般对象
      keys = Object.keys(val)
      ret = new Array(keys.length)
      for (i = 0, l = keys.length; i < l; i++) {key = keys[i]
        ret[i] = render(val[key], key, i)
      }
    }
  }
  if (!isDef(ret)) {ret = []
  }
  // 返回 VNode 数组
  (ret: any)._isVList = true
  return ret
}

_m = renderStatic

/src/core/instance/render-helpers/render-static.js

/**
 * Runtime helper for rendering static trees.
 * 运行时负责生成动态树的 VNode 的帮忙程序，实现了以下两件事
 *   1、执行 staticRenderFns 数组中指定下标的渲染函数，生成动态树的 VNode 并缓存，下次在渲染时从缓存中间接读取（isInFor 必须为 true）*   2、为动态树的 VNode 打动态标记
 * @param {number} index 示意以后动态节点的渲染函数在 staticRenderFns 数组中的下标索引
 * @param {boolean} isInFor 示意以后动态节点是否被包裹在含有 v-for 指令的节点外部
 */
 export function renderStatic (
  index: number,
  isInFor: boolean
): VNode | Array<VNode> {
  // 缓存，动态节点第二次被渲染时就从缓存中间接获取已缓存的 VNode
  const cached = this._staticTrees || (this._staticTrees = [])
  let tree = cached[index]
  // if has already-rendered static tree and not inside v-for,
  // we can reuse the same tree.
  // 如果以后动态树曾经被渲染过一次（即有缓存）而且没有被包裹在 v-for 指令所在节点的外部，则间接返回缓存的 VNode
  if (tree && !isInFor) {return tree}
  // 执行 staticRenderFns 数组中指定元素（动态树的渲染函数）生成该动态树的 VNode，并缓存
  // otherwise, render a fresh tree.
  tree = cached[index] = this.$options.staticRenderFns[index].call(
    this._renderProxy,
    null,
    this // for render fns generated for functional component templates
  )
  // 动态标记，为动态树的 VNode 打标记，即增加 {isStatic: true, key: `__static__${index}`, isOnce: false }
  markStatic(tree, `__static__${index}`, false)
  return tree
}

_c

/src/core/instance/render.js

/**
 * 定义 _c，它是 createElement 的一个柯里化办法
 * @param {*} a 标签名
 * @param {*} b 属性的 JSON 字符串
 * @param {*} c 子节点数组
 * @param {*} d 节点的规范化类型
 * @returns VNode or Array<VNode>
 */
vm._c = (a, b, c, d) => createElement(vm, a, b, c, d, false)

createElement

/src/core/vdom/create-element.js

/**
 * 生成组件或一般标签的 vnode，一个包装函数，不必管
 * wrapper function for providing a more flexible interface
 * without getting yelled at by flow
 */
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}
  // 执行 _createElement 办法创立组件的 VNode
  return _createElement(context, tag, data, children, normalizationType)
}

_createElement

/src/core/vdom/create-element.js

/**
 * 生成 vnode，*   1、平台保留标签和未知元素执行 new Vnode() 生成 vnode
 *   2、组件执行 createComponent 生成 vnode
 *     2.1 函数式组件执行本人的 render 函数生成 VNode
 *     2.2 一般组件则实例化一个 VNode，并且在其 data.hook 对象上设置 4 个办法，在组件的 patch 阶段会被调用，*         从而进入子组件的实例化、挂载阶段，直至实现渲染
 * @param {*} context 上下文
 * @param {*} tag 标签
 * @param {*} data 属性 JSON 字符串
 * @param {*} children 子节点数组
 * @param {*} normalizationType 节点规范化类型
 * @returns VNode or Array<VNode>
 */
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
    )
    // 如果属性是一个响应式对象，则返回一个空节点的 VNode
    return createEmptyVNode()}
  // object syntax in v-bind
  if (isDef(data) && isDef(data.is)) {tag = data.is}
  if (!tag) {
    // 动静组件的 is 属性是一个假值时 tag 为 false，则返回一个空节点的 VNode
    // in case of component :is set to falsy value
    return createEmptyVNode()}
  // 检测惟一键 key，只能是字符串或者数字
  // 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') {
    // 标签是字符串时，该标签有三种可能：//   1、平台保留标签
    //   2、自定义组件
    //   3、不出名标签
    let Ctor
    // 命名空间
    ns = (context.$vnode && context.$vnode.ns) || config.getTagNamespace(tag)
    if (config.isReservedTag(tag)) {
      // tag 是平台原生标签
      // platform built-in elements
      if (process.env.NODE_ENV !== 'production' && isDef(data) && isDef(data.nativeOn)) {
        // v-on 指令的 .native 只在组件上失效
        warn(`The .native modifier for v-on is only valid on components but it was used on <${tag}>.`,
          context
        )
      }
      // 实例化一个 VNode
      vnode = new VNode(config.parsePlatformTagName(tag), data, children,
        undefined, undefined, context
      )
    } else if ((!data || !data.pre) && isDef(Ctor = resolveAsset(context.$options, 'components', tag))) {
      // tag 是一个自定义组件
      // 在 this.$options.components 对象中找到指定标签名称的组件构造函数
      // 创立组件的 VNode，函数式组件间接执行其 render 函数生成 VNode，// 一般组件则实例化一个 VNode，并且在其 data.hook 对象上设置了 4 个办法，在组件的 patch 阶段会被调用，// 从而进入子组件的实例化、挂载阶段，直至实现渲染
      // component
      vnode = createComponent(Ctor, data, context, children, tag)
    } else {
      // 不出名的一个标签，但也生成 VNode，因为思考到在运行时可能会给一个适合的名字空间
      // 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 {
     // tag 为非字符串，比方可能是一个组件的配置对象或者是一个组件的构造函数
    // direct component options / constructor
    vnode = createComponent(tag, data, context, children)
  }
  // 返回组件的 VNode
  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()
  }
}

createComponent

/src/core/vdom/create-component.js

/**
 * 创立组件的 VNode，*   1、函数式组件通过执行其 render 办法生成组件的 VNode
 *   2、一般组件通过 new VNode() 生成其 VNode，然而一般组件有一个重要操作是在 data.hook 对象上设置了四个钩子函数，*      别离是 init、prepatch、insert、destroy，在组件的 patch 阶段会被调用，*      比方 init 办法，调用时会进入子组件实例的创立挂载阶段，直到实现渲染
 * @param {*} Ctor 组件构造函数
 * @param {*} data 属性组成的 JSON 字符串
 * @param {*} context 上下文
 * @param {*} children 子节点数组
 * @param {*} tag 标签名
 * @returns VNode or Array<VNode>
 */
export function createComponent(
  Ctor: Class<Component> | Function | Object | void,
  data: ?VNodeData,
  context: Component,
  children: ?Array<VNode>,
  tag?: string
): VNode | Array<VNode> | void {
  // 组件构造函数不存在，间接完结
  if (isUndef(Ctor)) {return}

  // Vue.extend
  const baseCtor = context.$options._base

  // 当 Ctor 为配置对象时，通过 Vue.extend 将其转为构造函数
  // plain options object: turn it into a constructor
  if (isObject(Ctor)) {Ctor = baseCtor.extend(Ctor)
  }

  // 如果到这个为止，Ctor 依然不是一个函数，则示意这是一个有效的组件定义
  // if at this stage it's not a constructor or an async component factory,
  // reject.
  if (typeof Ctor !== 'function') {if (process.env.NODE_ENV !== 'production') {warn(`Invalid Component definition: ${String(Ctor)}`, context)
    }
    return
  }

  // 异步组件
  // async component
  let asyncFactory
  if (isUndef(Ctor.cid)) {
    asyncFactory = Ctor
    Ctor = resolveAsyncComponent(asyncFactory, baseCtor)
    if (Ctor === undefined) {
      // 为异步组件返回一个占位符节点，组件被渲染为正文节点，但保留了节点的所有原始信息，这些信息将用于异步服务器渲染 和 hydration
      return createAsyncPlaceholder(
        asyncFactory,
        data,
        context,
        children,
        tag
      )
    }
  }

  // 节点的属性 JSON 字符串
  data = data || {}

  // 这里其实就是组件做选项合并的中央，即编译器将组件编译为渲染函数，渲染时执行 render 函数，而后执行其中的 _c，就会走到这里了
  // 解析构造函数选项，并合基类选项，以避免在组件构造函数创立后利用全局混入
  // resolve constructor options in case global mixins are applied after
  // component constructor creation
  resolveConstructorOptions(Ctor)

  // 将组件的 v-model 的信息（值和回调）转换为 data.attrs 对象的属性、值和 data.on 对象上的事件、回调
  // transform component v-model data into props & events
  if (isDef(data.model)) {transformModel(Ctor.options, data)
  }

  // 提取 props 数据，失去 propsData 对象，propsData[key] = val
  // 以组件 props 配置中的属性为 key，父组件中对应的数据为 value
  // extract props
  const propsData = extractPropsFromVNodeData(data, Ctor, tag)

  // 函数式组件
  // functional component
  if (isTrue(Ctor.options.functional)) {
    /**
     * 执行函数式组件的 render 函数生成组件的 VNode，做了以下 3 件事：*   1、设置组件的 props 对象
     *   2、设置函数式组件的渲染上下文，传递给函数式组件的 render 函数
     *   3、调用函数式组件的 render 函数生成 vnode
     */
    return createFunctionalComponent(Ctor, propsData, data, context, children)
  }

  // 获取事件监听器对象 data.on，因为这些监听器须要作为子组件监听器解决，而不是 DOM 监听器
  // extract listeners, since these needs to be treated as
  // child component listeners instead of DOM listeners
  const listeners = data.on
  // 将带有 .native 修饰符的事件对象赋值给 data.on
  // replace with listeners with .native modifier
  // so it gets processed during parent component patch.
  data.on = data.nativeOn

  if (isTrue(Ctor.options.abstract)) {
    // 如果是形象组件，则值保留 props、listeners 和 slot
    // abstract components do not keep anything
    // other than props & listeners & slot

    // work around flow
    const slot = data.slot
    data = {}
    if (slot) {data.slot = slot}
  }

  /**
   * 在组件的 data 对象上设置 hook 对象，* hook 对象减少四个属性，init、prepatch、insert、destroy，* 负责组件的创立、更新、销毁，这些办法在组件的 patch 阶段会被调用
   * install component management hooks onto the placeholder node
   */
  installComponentHooks(data)

  const name = Ctor.options.name || tag
  // 实例化组件的 VNode，对于一般组件的标签名会比拟非凡，vue-component-${cid}-${name}
  const vnode = new VNode(`vue-component-${Ctor.cid}${name ? `-${name}` : ''}`,
    data, undefined, undefined, undefined, context,
    {Ctor, propsData, listeners, tag, children},
    asyncFactory
  )

  // Weex specific: invoke recycle-list optimized @render function for
  // extracting cell-slot template.
  // https://github.com/Hanks10100/weex-native-directive/tree/master/component
  /* istanbul ignore if */
  if (__WEEX__ && isRecyclableComponent(vnode)) {return renderRecyclableComponentTemplate(vnode)
  }

  return vnode
}

resolveConstructorOptions

/src/core/instance/init.js

/**
 * 从构造函数上解析配置项
 */
export function resolveConstructorOptions (Ctor: Class<Component>) {
  // 从实例构造函数上获取选项
  let options = Ctor.options
  if (Ctor.super) {const superOptions = resolveConstructorOptions(Ctor.super)
    // 缓存
    const cachedSuperOptions = Ctor.superOptions
    if (superOptions !== cachedSuperOptions) {
      // 阐明基类的配置项产生了更改
      // super option changed,
      // need to resolve new options.
      Ctor.superOptions = superOptions
      // check if there are any late-modified/attached options (#4976)
      // 找到更改的选项
      const modifiedOptions = resolveModifiedOptions(Ctor)
      // update base extend options
      if (modifiedOptions) {
        // 将更改的选项和 extend 选项合并
        extend(Ctor.extendOptions, modifiedOptions)
      }
      // 将新的选项赋值给 options
      options = Ctor.options = mergeOptions(superOptions, Ctor.extendOptions)
      if (options.name) {options.components[options.name] = Ctor
      }
    }
  }
  return options
}

resolveModifiedOptions

/src/core/instance/init.js

/**
 * 解析构造函数选项中后续被批改或者减少的选项
 */
function resolveModifiedOptions (Ctor: Class<Component>): ?Object {
  let modified
  // 构造函数选项
  const latest = Ctor.options
  // 密封的构造函数选项，备份
  const sealed = Ctor.sealedOptions
  // 比照两个选项，记录不统一的选项
  for (const key in latest) {if (latest[key] !== sealed[key]) {if (!modified) modified = {}
      modified[key] = latest[key]
    }
  }
  return modified
}

transformModel

src/core/vdom/create-component.js

/**
 * 将组件的 v-model 的信息（值和回调）转换为 data.attrs 对象的属性、值和 data.on 对象上的事件、回调
 * transform component v-model info (value and callback) into
 * prop and event handler respectively.
 */
function transformModel(options, data: any) {
  // model 的属性和事件，默认为 value 和 input
  const prop = (options.model && options.model.prop) || 'value'
  const event = (options.model && options.model.event) || 'input'
    // 在 data.attrs 对象上存储 v-model 的值
    ; (data.attrs || (data.attrs = {}))[prop] = data.model.value
  // 在 data.on 对象上存储 v-model 的事件
  const on = data.on || (data.on = {})
  // 已存在的事件回调函数
  const existing = on[event]
  // v-model 中事件对应的回调函数
  const callback = data.model.callback
  // 合并回调函数
  if (isDef(existing)) {
    if (Array.isArray(existing)
        ? existing.indexOf(callback) === -1
        : existing !== callback
    ) {on[event] = [callback].concat(existing)
    }
  } else {on[event] = callback
  }
}

extractPropsFromVNodeData

/src/core/vdom/helpers/extract-props.js

/**
 * <comp :msg="hello vue"></comp>
 * 
 * 提取 props，失去 res[key] = val 
 * 
 * 以 props 配置中的属性为 key，父组件中对应的的数据为 value
 * 当父组件中数据更新时，触发响应式更新，从新执行 render，生成新的 vnode，又走到这里
 * 这样子组件中相应的数据就会被更新 
 */
export function extractPropsFromVNodeData (data: VNodeData, // { msg: 'hello vue'}
  Ctor: Class<Component>, // 组件构造函数
  tag?: string // 组件标签名
): ?Object {// 组件的 props 选项，{ props: { msg: { type: String, default: xx} } }
  
  // 这里只提取原始值，验证和默认值在子组件中解决
  // we are only extracting raw values here.
  // validation and default values are handled in the child
  // component itself.
  const propOptions = Ctor.options.props
  if (isUndef(propOptions)) {
    // 未定义 props 间接返回
    return
  }
  // 以组件 props 配置中的属性为 key，父组件传递下来的值为 value
  // 当父组件中数据更新时，触发响应式更新，从新执行 render，生成新的 vnode，又走到这里
  // 这样子组件中相应的数据就会被更新
  const res = {}
  const {attrs, props} = data
  if (isDef(attrs) || isDef(props)) {
    // 遍历 propsOptions
    for (const key in propOptions) {
      // 将小驼峰模式的 key 转换为 连字符 模式
      const altKey = hyphenate(key)
      // 提醒，如果申明的 props 为小驼峰模式（testProps），但因为 html 不辨别大小写，所以在 html 模版中应该应用 test-props 代替 testProps
      if (process.env.NODE_ENV !== 'production') {const keyInLowerCase = key.toLowerCase()
        if (
          key !== keyInLowerCase &&
          attrs && hasOwn(attrs, keyInLowerCase)
        ) {
          tip(`Prop "${keyInLowerCase}" is passed to component ` +
            `${formatComponentName(tag || Ctor)}, but the declared prop name is` +
            ` "${key}". ` +
            `Note that HTML attributes are case-insensitive and camelCased ` +
            `props need to use their kebab-case equivalents when using in-DOM ` +
            `templates. You should probably use "${altKey}" instead of "${key}".`
          )
        }
      }
      checkProp(res, props, key, altKey, true) ||
      checkProp(res, attrs, key, altKey, false)
    }
  }
  return res
}

checkProp

/src/core/vdom/helpers/extract-props.js

/**
 * 失去 res[key] = val
 */
function checkProp (
  res: Object,
  hash: ?Object,
  key: string,
  altKey: string,
  preserve: boolean
): boolean {if (isDef(hash)) {
    // 判断 hash（props/attrs）对象中是否存在 key 或 altKey
    // 存在则设置给 res => res[key] = hash[key]
    if (hasOwn(hash, key)) {res[key] = hash[key]
      if (!preserve) {delete hash[key]
      }
      return true
    } else if (hasOwn(hash, altKey)) {res[key] = hash[altKey]
      if (!preserve) {delete hash[altKey]
      }
      return true
    }
  }
  return false
}

createFunctionalComponent

/src/core/vdom/create-functional-component.js

installRenderHelpers(FunctionalRenderContext.prototype)

/**
 * 执行函数式组件的 render 函数生成组件的 VNode，做了以下 3 件事：*   1、设置组件的 props 对象
 *   2、设置函数式组件的渲染上下文，传递给函数式组件的 render 函数
 *   3、调用函数式组件的 render 函数生成 vnode
 * 
 * @param {*} Ctor 组件的构造函数 
 * @param {*} propsData 额定的 props 对象
 * @param {*} data 节点属性组成的 JSON 字符串
 * @param {*} contextVm 上下文
 * @param {*} children 子节点数组
 * @returns Vnode or Array<VNode>
 */
export function createFunctionalComponent (
  Ctor: Class<Component>,
  propsData: ?Object,
  data: VNodeData,
  contextVm: Component,
  children: ?Array<VNode>
): VNode | Array<VNode> | void {
  // 组件配置项
  const options = Ctor.options
  // 获取 props 对象
  const props = {}
  // 组件自身的 props 选项
  const propOptions = options.props
  // 设置函数式组件的 props 对象
  if (isDef(propOptions)) {
    // 阐明该函数式组件自身提供了 props 选项，则将 props.key 的值设置为组件上传递下来的对应 key 的值
    for (const key in propOptions) {props[key] = validateProp(key, propOptions, propsData || emptyObject)
    }
  } else {
    // 以后函数式组件没有提供 props 选项，则将组件上的 attribute 主动解析为 props
    if (isDef(data.attrs)) mergeProps(props, data.attrs)
    if (isDef(data.props)) mergeProps(props, data.props)
  }

  // 实例化函数式组件的渲染上下文
  const renderContext = new FunctionalRenderContext(
    data,
    props,
    children,
    contextVm,
    Ctor
  )

  // 调用 render 函数，生成 vnode，并给 render 函数传递 _c 和 渲染上下文
  const vnode = options.render.call(null, renderContext._c, renderContext)

  // 在最初生成的 VNode 对象上加一些标记，示意该 VNode 是一个函数式组件生成的，最初返回 VNode
  if (vnode instanceof VNode) {return cloneAndMarkFunctionalResult(vnode, data, renderContext.parent, options, renderContext)
  } else if (Array.isArray(vnode)) {const vnodes = normalizeChildren(vnode) || []
    const res = new Array(vnodes.length)
    for (let i = 0; i < vnodes.length; i++) {res[i] = cloneAndMarkFunctionalResult(vnodes[i], data, renderContext.parent, options, renderContext)
    }
    return res
  }
}

installComponentHooks

/src/core/vdom/create-component.js

const hooksToMerge = Object.keys(componentVNodeHooks)
/**
 * 在组件的 data 对象上设置 hook 对象，* hook 对象减少四个属性，init、prepatch、insert、destroy，* 负责组件的创立、更新、销毁
 */
 function installComponentHooks(data: VNodeData) {const hooks = data.hook || (data.hook = {})
  // 遍历 hooksToMerge 数组，hooksToMerge = ['init', 'prepatch', 'insert' 'destroy']
  for (let i = 0; i < hooksToMerge.length; i++) {
    // 比方 key = init
    const key = hooksToMerge[i]
    // 从 data.hook 对象中获取 key 对应的办法
    const existing = hooks[key]
    // componentVNodeHooks 对象中 key 对象的办法
    const toMerge = componentVNodeHooks[key]
    // 合并用户传递的 hook 办法和框架自带的 hook 办法，其实就是别离执行两个办法
    if (existing !== toMerge && !(existing && existing._merged)) {hooks[key] = existing ? mergeHook(toMerge, existing) : toMerge
    }
  }
}

function mergeHook(f1: any, f2: any): Function {const merged = (a, b) => {
    // flow complains about extra args which is why we use any
    f1(a, b)
    f2(a, b)
  }
  merged._merged = true
  return merged
}

componentVNodeHooks

/src/core/vdom/create-component.js

// patch 期间在组件 vnode 上调用内联钩子
// inline hooks to be invoked on component VNodes during patch
const componentVNodeHooks = {
  // 初始化
  init(vnode: VNodeWithData, hydrating: boolean): ?boolean {
    if (
      vnode.componentInstance &&
      !vnode.componentInstance._isDestroyed &&
      vnode.data.keepAlive
    ) {
      // 被 keep-alive 包裹的组件
      // kept-alive components, treat as a patch
      const mountedNode: any = vnode // work around flow
      componentVNodeHooks.prepatch(mountedNode, mountedNode)
    } else {// 创立组件实例，即 new vnode.componentOptions.Ctor(options) => 失去 Vue 组件实例
      const child = vnode.componentInstance = createComponentInstanceForVnode(
        vnode,
        activeInstance
      )
      // 执行组件的 $mount 办法，进入挂载阶段，接下来就是通过编译器失去 render 函数，接着走挂载、patch 这条路，直到组件渲染到页面
      child.$mount(hydrating ? vnode.elm : undefined, hydrating)
    }
  },

  // 更新 VNode，用新的 VNode 配置更新旧的 VNode 上的各种属性
  prepatch(oldVnode: MountedComponentVNode, vnode: MountedComponentVNode) {
    // 新 VNode 的组件配置项
    const options = vnode.componentOptions
    // 老 VNode 的组件实例
    const child = vnode.componentInstance = oldVnode.componentInstance
    // 用 vnode 上的属性更新 child 上的各种属性
    updateChildComponent(
      child,
      options.propsData, // updated props
      options.listeners, // updated listeners
      vnode, // new parent vnode
      options.children // new children
    )
  },

  // 执行组件的 mounted 申明周期钩子
  insert(vnode: MountedComponentVNode) {const { context, componentInstance} = vnode
    // 如果组件未挂载，则调用 mounted 申明周期钩子
    if (!componentInstance._isMounted) {
      componentInstance._isMounted = true
      callHook(componentInstance, 'mounted')
    }
    // 解决 keep-alive 组件的异常情况
    if (vnode.data.keepAlive) {if (context._isMounted) {
        // vue-router#1212
        // During updates, a kept-alive component's child components may
        // change, so directly walking the tree here may call activated hooks
        // on incorrect children. Instead we push them into a queue which will
        // be processed after the whole patch process ended.
        queueActivatedComponent(componentInstance)
      } else {activateChildComponent(componentInstance, true /* direct */)
      }
    }
  },

  /**
   * 销毁组件
   *   1、如果组件被 keep-alive 组件包裹，则使组件失活，不销毁组件实例，从而缓存组件的状态
   *   2、如果组件没有被 keep-alive 包裹，则间接调用实例的 $destroy 办法销毁组件
   */
  destroy (vnode: MountedComponentVNode) {
    // 从 vnode 上获取组件实例
    const {componentInstance} = vnode
    if (!componentInstance._isDestroyed) {
      // 如果组件实例没有被销毁
      if (!vnode.data.keepAlive) {
        // 组件没有被 keep-alive 组件包裹，则间接调用 $destroy 办法销毁组件
        componentInstance.$destroy()} else {
        // 负责让组件失活，不销毁组件实例，从而缓存组件的状态
        deactivateChildComponent(componentInstance, true /* direct */)
      }
    }
  }
}

createComponentInstanceForVnode

/src/core/vdom/create-component.js

/**
 * new vnode.componentOptions.Ctor(options) => 失去 Vue 组件实例 
 */
export function createComponentInstanceForVnode(
  // we know it's MountedComponentVNode but flow doesn't
  vnode: any,
  // activeInstance in lifecycle state
  parent: any
): Component {
  const options: InternalComponentOptions = {
    _isComponent: true,
    _parentVnode: vnode,
    parent
  }
  // 查看内联模版渲染函数
  const inlineTemplate = vnode.data.inlineTemplate
  if (isDef(inlineTemplate)) {
    options.render = inlineTemplate.render
    options.staticRenderFns = inlineTemplate.staticRenderFns
  }
  // new VueComponent(options) => Vue 实例
  return new vnode.componentOptions.Ctor(options)
}

总结

面试官 问：一个组件是如何变成 VNode？

答：

• 组件实例初始化，最初执行 $mount 进入挂载阶段
• 如果是只蕴含运行时的 vue.js，只间接进入挂载阶段，因为这时候的组件曾经变成了渲染函数，编译过程通过模块打包器 + vue-loader + vue-template-compiler 实现的
• 如果没有应用预编译，则必须应用全量的 vue.js
• 挂载时如果发现组件配置项上没有 render 选项，则进入编译阶段
• 将模版字符串编译成 AST 语法树，其实就是一个一般的 JS 对象
• 而后优化 AST，遍历 AST 对象，标记每一个节点是否为动态动态；而后再进一步标记出动态根节点，在组件后续更新时会跳过这些动态节点的更新，以进步性能

• 接下来从 AST 生成渲染函数，生成的渲染函数有两局部组成：

  • 负责生成动静节点 VNode 的 render 函数
  • 还有一个 staticRenderFns 数组，外面每一个元素都是一个生成动态节点 VNode 的函数，这些函数会作为 render 函数的组成部分，负责生成动态节点的 VNode
• 接下来将渲染函数放到组件的配置对象上，进入挂载阶段，即执行 mountComponent 办法
• 最终负责渲染组件和更新组件的是一个叫 updateComponent 办法，该办法每次执行前首先须要执行 vm._render 函数，该函数负责执行编译器生成的 render，失去组件的 VNode
• 将一个组件生成 VNode 的具体工作是由 render 函数中的 _c、_o、_l、_m 等办法实现的，这些办法都被挂载到 Vue 实例下面，负责在运行时生成组件 VNode

提醒：到这里首先要明确什么是 VNode，一句话形容就是 —— 组件模版的 JS 对象表现形式，它就是一个一般的 JS 对象，详细描述了组件中各节点的信息

上面说的有点多，其实记住一句就能够了，设置组件配置信息，而后通过 new VNode(组件信息) 生成组件的 VNode

• _c，负责生成组件或 HTML 元素的 VNode，_c 是所有 render helper 办法中最简单，也是最外围的一个办法，其它的 _xx 都是它的组成部分

  • 接管标签、属性 JSON 字符串、子节点数组、节点规范化类型作为参数
  • 如果标签是平台保留标签或者一个未知的元素，则间接 new VNode(标签信息) 失去 VNode

  • 如果标签是一个组件，则执行 createComponent 办法生成 VNode

    • 函数式组件执行本人的 render 函数生成 VNode
    • 一般组件则实例化一个 VNode，并且在在 data.hook 对象上设置 4 个办法，在组件的 patch 阶段会被调用，从而进入子组件的实例化、挂载阶段，而后进行编译生成渲染函数，直至实现渲染

    • 当然生成 VNode 之前会进行一些配置解决比方：

      • 子组件选项合并，合并全局配置项到组件配置项上
      • 解决自定义组件的 v-model
      • 解决组件的 props，提取组件的 props 数据，以组件的 props 配置中的属性为 key，父组件中对应的数据为 value 生成一个 propsData 对象；当组件更新时生成新的 VNode，又会进行这一步，这就是 props 响应式的原理
      • 解决其它数据，比方监听器
      • 装置内置的 init、prepatch、insert、destroy 钩子到 data.hooks 对象上，组件 patch 阶段会用到这些钩子办法
• _l，运行时渲染 v-for 列表的帮忙函数，循环遍历 val 值，顺次为每一项执行 render 办法生成 VNode，最终返回一个 VNode 数组
• _m，负责生成动态节点的 VNode，即执行 staticRenderFns 数组中指定下标的函数

简略总结 render helper 的作用就是：在 Vue 实例上挂载一些运行时的工具办法，这些办法用在编译器生成的渲染函数中，用于生成组件的 VNode。

好了，到这里，一个组件从初始化开始到最终怎么变成 VNode 就讲完了，最初剩下的就是 patch 阶段了，下一篇文章将讲述如何将组件的 VNode 渲染到页面上。

链接

• 精通 Vue 技术栈源码原理 专栏
• github 仓库 liyongning/Vue 欢送 Star

感激各位的：关注 、 点赞 、 珍藏 和评论，咱们下期见。