// public mount method
// el: 可以是一個字符串或者Dom元素
// hydrating 是Virtual DOM 的補(bǔ)丁算法參數(shù)
Vue.prototype.$mount = function (
 el?: string | Element,
 hydrating?: boolean
): Component {
 // 判斷el, 以及宿主環(huán)境, 然后通過工具函數(shù)query重寫el。
 el = el && inBrowser ? query(el) : undefined
 // 執(zhí)行真正的掛載并返回
 return mountComponent(this, el, hydrating)
}

/**
 * Query an element selector if it's not an element already.
 */
export function query (el: string | Element): Element {
 if (typeof el === 'string') {
  const selected = document.querySelector(el)
  if (!selected) {
   // 開發(fā)環(huán)境下給出錯誤提示
   process.env.NODE_ENV !== 'production' && warn(
    'Cannot find element: ' + el
   )
   // 沒有找到的情況下容錯處理
   return document.createElement('div')
  }
  return selected
 } else {
  return el
 }
}

// 緩存運行時候定義的公共$mount方法
const mount = Vue.prototype.$mount
Vue.prototype.$mount = function (
 el?: string | Element,
 hydrating?: boolean
): Component {
 // 通過query方法重寫el(掛載點: 組件掛載的占位符)
 el = el && query(el)

 /* istanbul ignore if */
 // 提示不能把body/html作為掛載點, 開發(fā)環(huán)境下給出錯誤提示
 // 因為掛載點是會被組件模板自身替換點, 顯然body/html不能被替換
 if (el === document.body || el === document.documentElement) {
  process.env.NODE_ENV !== 'production' && warn(
   `Do not mount Vue to  or  - mount to normal elements instead.`
  )
  return this
 }
 // $options是在new Vue(options)時候_init方法內(nèi)執(zhí)行.
 // $options可以訪問到options的所有屬性如data, filter, components, directives等
 const options = this.$options
 // resolve template/el and convert to render function
 
 // 如果包含render函數(shù)則執(zhí)行跳出,直接執(zhí)行運行時版本的$mount方法
 if (!options.render) {
  // 沒有render函數(shù)時候優(yōu)先考慮template屬性
  let template = options.template
  if (template) {
   // template存在且template的類型是字符串
   if (typeof template === 'string') {
    if (template.charAt(0) === '#') {
     // template是ID
     template = idToTemplate(template)
     /* istanbul ignore if */
     if (process.env.NODE_ENV !== 'production' && !template) {
      warn(
       `Template element not found or is empty: ${options.template}`,
       this
      )
     }
    }
   } else if (template.nodeType) {
    // template 的類型是元素節(jié)點,則使用該元素的 innerHTML 作為模板
    template = template.innerHTML
   } else {
    // 若 template既不是字符串又不是元素節(jié)點，那么在開發(fā)環(huán)境會提示開發(fā)者傳遞的 template 選項無效
    if (process.env.NODE_ENV !== 'production') {
     warn('invalid template option:' + template, this)
    }
    return this
   }
  } else if (el) {
   // 如果template選項不存在，那么使用el元素的outerHTML 作為模板內(nèi)容
   template = getOuterHTML(el)
  }
  // template: 存儲著最終用來生成渲染函數(shù)的字符串
  if (template) {
   /* istanbul ignore if */
   if (process.env.NODE_ENV !== 'production' && config.performance && mark) {
    mark('compile')
   }
   // 獲取轉(zhuǎn)換后的render函數(shù)與staticRenderFns,并掛在$options上
   const { render, staticRenderFns } = compileToFunctions(template, {
    outputSourceRange: process.env.NODE_ENV !== 'production',
    shouldDecodeNewlines,
    shouldDecodeNewlinesForHref,
    delimiters: options.delimiters,
    comments: options.comments
   }, this)
   options.render = render
   options.staticRenderFns = staticRenderFns

   /* istanbul ignore if */
   // 用來統(tǒng)計編譯器性能, config是全局配置對象
   if (process.env.NODE_ENV !== 'production' && config.performance && mark) {
    mark('compile end')
    measure(`vue ${this._name} compile`, 'compile', 'compile end')
   }
  }
 }
 // 調(diào)用之前說的公共mount方法
 // 重寫$mount方法是為了添加模板編譯的功能
 return mount.call(this, el, hydrating)
}

const idToTemplate = cached(id => {
 const el = query(id)
 return el && el.innerHTML
})

/**
 * Get outerHTML of elements, taking care
 * of SVG elements in IE as well.
 */
function getOuterHTML (el: Element): string {
 if (el.outerHTML) {
  return el.outerHTML
 } else {
  // fix IE9-11 中 SVG 標(biāo)簽元素是沒有 innerHTML 和 outerHTML 這兩個屬性
  const container = document.createElement('div')
  container.appendChild(el.cloneNode(true))
  return container.innerHTML
 }
}

export function mountComponent (
 vm: Component, // 組件實例vm
 el: ?Element, // 掛載點
 hydrating?: boolean
): Component {
 // 在組件實例對象上添加$el屬性
 // $el的值是組件模板根元素的引用
 vm.$el = el
 if (!vm.$options.render) {
  // 渲染函數(shù)不存在, 這時將會創(chuàng)建一個空的vnode對象
  vm.$options.render = createEmptyVNode
  if (process.env.NODE_ENV !== 'production') {
   /* istanbul ignore if */
   if ((vm.$options.template && vm.$options.template.charAt(0) !== '#') ||
    vm.$options.el || el) {
    warn(
     'You are using the runtime-only build of Vue where the template ' +
     'compiler is not available. Either pre-compile the templates into ' +
     'render functions, or use the compiler-included build.',
     vm
    )
   } else {
    warn(
     'Failed to mount component: template or render function not defined.',
     vm
    )
   }
  }
 }
 // 觸發(fā) beforeMount 生命周期鉤子
 callHook(vm, 'beforeMount')

 // vm._render 函數(shù)的作用是調(diào)用 vm.$options.render 函數(shù)并返回生成的虛擬節(jié)點(vnode)。template => render => vnode
 
 // vm._update 函數(shù)的作用是把 vm._render 函數(shù)生成的虛擬節(jié)點渲染成真正的 DOM。 vnode => real dom node
 
 let updateComponent // 把渲染函數(shù)生成的虛擬DOM渲染成真正的DOM
 /* istanbul ignore if */
 if (process.env.NODE_ENV !== 'production' && config.performance && mark) {
  updateComponent = () => {
   const name = vm._name
   const id = vm._uid
   const startTag = `vue-perf-start:${id}`
   const endTag = `vue-perf-end:${id}`

   mark(startTag)
   const vnode = vm._render()
   mark(endTag)
   measure(`vue ${name} render`, startTag, endTag)

   mark(startTag)
   vm._update(vnode, hydrating)
   mark(endTag)
   measure(`vue ${name} patch`, startTag, endTag)
  }
 } else {
  updateComponent = () => {
   vm._update(vm._render(), hydrating)
  }
 }

 // we set this to vm._watcher inside the watcher's constructor
 // since the watcher's initial patch may call $forceUpdate (e.g. inside child
 // component's mounted hook), which relies on vm._watcher being already defined
 // 創(chuàng)建一個Render函數(shù)的觀察者, 關(guān)于watcher后續(xù)再講述.
 new Watcher(vm, updateComponent, noop, {
  before () {
   if (vm._isMounted && !vm._isDestroyed) {
    callHook(vm, 'beforeUpdate')
   }
  }
 }, true /* isRenderWatcher */)
 hydrating = false

 // manually mounted instance, call mounted on self
 // mounted is called for render-created child components in its inserted hook
 if (vm.$vnode == null) {
  vm._isMounted = true
  callHook(vm, 'mounted')
 }
 return vm
}