前言

Vue.js 提供了 2 个版本,一个是 Runtime + Compiler 版本,一个是 Runtime only 版本。Runtime + Compiler 版本是包含编译代码的,可以把编译过程放在运行时做,Runtime only 版本不包含编译代码的,需要借助 webpack 的 vue-loader 事先把模板编译成 render 函数。
如果你需要在客户端编译模板 (比如传入一个字符串给 template 选项,或挂载到一个元素上并以其 DOM 内部的 HTML 作为模板),就将需要加上编译器,即完整版:

  1. // 需要编译器
  2. new Vue({
  3. template: '<div>{{ hi }}</div>'
  4. })
  5. // 不需要编译器
  6. new Vue({
  7. render (h) {
  8. return h('div', this.hi)
  9. }
  10. })

当使用 vue-loader 或 vueify 的时候,*.vue 文件内部的模板会在构建时预编译成 JavaScript。你在最终打好的包里实际上是不需要编译器的,所以只用运行时版本即可。因为运行时版本相比完整版体积要小大约 30%,所以应该尽可能使用这个版本。
在 Vue 的整个编译过程中,会做三件事:

  • 解析模板 **parse**,生成 AST
  • 优化 AST **optimize**
  • 生成代码 **generate**

对编译过程的了解会让我们对 Vue 的指令、内置组件等有更好的理解。不过由于编译的过程是一个相对复杂的过程,我们只要求理解整体的流程、输入和输出即可,对于细节我们不必抠太细。由于篇幅较长,这里会用三篇文章来讲这三件事。这是第一篇,**模板解析,template -> AST**

注:全文源码来源,Vue(2.6.11),Runtime + Compiler 的 Vue.js

编译准备

源码编译链式调用

Vue 编译三部曲:如何将 template 编译成 AST ? - 图1

compileToFunctions

从源码找了一遭,发现经过一系列的调用,最后 createCompiler返回的这个 compileToFunctions 对应的就是 $mount 函数调用的 compileToFunctions 方法,它是调用 createCompileToFunctionFn 方法的返回值。

  1. // 伪代码
  2. function createCompilerCreator (baseCompile) {
  3. return function createCompiler (baseOptions) {
  4. function compile (
  5. template,
  6. options
  7. ) {
  8. ...
  9. return compiled
  10. }
  11. return {
  12. compile: compile,
  13. compileToFunctions: createCompileToFunctionFn(compile)
  14. }
  15. }
  16. }
  17. function createCompileToFunctionFn (compile) {
  18. var cache = Object.create(null);
  19. return function compileToFunctions (
  20. template,
  21. options,
  22. vm
  23. ) {
  24. ...
  25. }
  26. }

方法接受三个参数。

  • 编译模板 template
  • 编译配置 options
  • Vue 的实例

这个方法编译的核心代码就一行。

  1. // compile
  2. var compiled = compile(template, options);

而 compile 方法的核心代码也就一行。

  1. const compiled = baseCompile(template, finalOptions)

并且 baseCompile方法是在执行 createCompilerCreator 方法执行的时候传入的。

  1. var createCompiler = createCompilerCreator(function baseCompile (
  2. template,
  3. options
  4. ) {
  5. var ast = parse(template.trim(), options);
  6. if (options.optimize !== false) {
  7. optimize(ast, options);
  8. }
  9. var code = generate(ast, options);
  10. return {
  11. ast: ast,
  12. render: code.render,
  13. staticRenderFns: code.staticRenderFns
  14. }
  15. });

baseCompile会做三件事情。
Vue 编译三部曲:如何将 template 编译成 AST ? - 图2
其实看到这里你就会发现,这编译的准备工作,做了一些列函数的调用,但是兜兜转转之后,最后回头来还是调用了最开始**createCompilerCreator**传入的函数。我理解这样做的原因是 Vue 本身是支持多平台的编译,在不同平台下的编译会有所有不同,但是在同一平台编译是相同的,所以在使用**createCompiler(baseOptions)** 时,baseOptions 会有所有不同。
在 Vue 中利用**函数柯里化**的思想,将 **baseOptions** 的配置参数进行了保存。并且在调用链中,不断的进行函数调用并返回函数,这其实也是利用了**函数柯里化**的思想把很多基础的函数抽离出来,通过 createCompilerCreator(baseCompile) 的方式把真正编译的过程和其它逻辑如对编译配置处理、缓存处理等剥离开,这样的设计还是非常巧妙的。
编译准备已经做完,我们接下来看看 Vue 是如何做 parseoptimizegenerate这三件事情的。

parse

第一件事情就是对 template 做解析,生成 AST 抽象语法树。

抽象语法树(Abstract Syntax Tree,AST),或简称语法树(Syntax tree),是源代码语法结构的一种抽象表示。它以树状的形式表现编程语言的语法结构,树上的每个节点都表示源代码中的一种结构。

例如现在有这样一段代码:

  1. <body>
  2. <div id="app"></div>
  3. <script>
  4. new Vue({
  5. el: '#app',
  6. template: `
  7. <ul>
  8. <li>1</li>
  9. <li>1</li>
  10. <li>1</li>
  11. <li>1</li>
  12. <li>1</li>
  13. <li>1</li>
  14. <li>1</li>
  15. <li>1</li>
  16. <li>1</li>
  17. <li>1</li>
  18. </ul>
  19. `
  20. });
  21. </script>
  22. </body>

经过parse,就变成了一个嵌套的树状结构的对象。
image.png
在 AST 中,每一个树节点都是一个 element,并且维护了上下文关系(父子关系)。

解析 template

parse的过程核心就是 parseHTML 函数,这个函数的作用就是解析 template 模板。下面将解析过程中一些重要的点解读一下。

  1. function parseHTML (html, options) {
  2. var stack = [];
  3. ...
  4. // 遍历模板字符串
  5. while (html) {
  6. ...
  7. }
  8. // 清楚所有剩余的标签
  9. parseEndTag();
  10. // 将 html 字符串的指针前移
  11. function advance (n) {
  12. ...
  13. }
  14. // 解析开始标签
  15. function parseStartTag () {
  16. ...
  17. }
  18. // 处理解析的开始标签的结果
  19. function handleStartTag (match) {
  20. ...
  21. }
  22. // 解析结束标签
  23. function parseEndTag (tagName, start, end) {
  24. ...
  25. }
  26. }

标签匹配相关的正则

下面也会讲到关于一些指令匹配相关的正则。其实这些正则大家在平时的项目中有涉及也可以用起来,毕竟这些正则是经过千万人测试的。

  1. // 识别合法的xml标签
  2. var ncname = '[a-zA-Z_][\\w\\-\\.]*';
  3. // 复用拼接,这在我们项目中完成可以学起来
  4. var qnameCapture = "((?:" + ncname + "\\:)?" + ncname + ")";
  5. // 匹配注释
  6. var comment =/^<!\--/;
  7. // 匹配<!DOCTYPE> 声明标签
  8. var doctype = /^<!DOCTYPE [^>]+>/i;
  9. // 匹配条件注释
  10. var conditionalComment =/^<!\[/;
  11. // 匹配开始标签
  12. var startTagOpen = new RegExp(("^<" + qnameCapture));
  13. // 匹配解说标签
  14. var endTag = new RegExp(("^<\\/" + qnameCapture + "[^>]*>"));
  15. // 匹配单标签
  16. var startTagClose = /^\s*(\/?)>/;
  17. // 匹配属性,例如 id、class
  18. var attribute = /^\s*([^\s"'<>\/=]+)(?:\s*(=)\s*(?:"([^"]*)"+|'([^']*)'+|([^\s"'=<>`]+)))?/;
  19. // 匹配动态属性,例如 v-if、v-else
  20. var dynamicArgAttribute = /^\s*((?:v-[\w-]+:|@|:|#)\[[^=]+\][^\s"'<>\/=]*)(?:\s*(=)\s*(?:"([^"]*)"+|'([^']*)'+|([^\s"'=<>`]+)))?/;

stack

变量 **stack** ,它定义一个栈,作用是存储开始标签。
例如我有一个这样的简单模板:

  1. <div>
  2. <ul>
  3. <li>1</li>
  4. </ul>
  5. </div>

当在 while 循环时,如果遇到一个非单标签,就会将开始标签 push 到数组中,遇到闭合标签就开始元素出栈,这样可以检测我们写的 template 是否符合嵌套、开闭规范,这也是检测 html 字符串中是否缺少闭合标签的原理。
Vue 编译三部曲:如何将 template 编译成 AST ? - 图4

advance

当我们在解析 template 字符串的时候,需要对字符串逐一扫描,直到结束。advance 函数的作用就是移动指针。例如匹配 <字符,指针移动1,匹配到<!--字符指针移动4。在整个解析过程中,贯穿着指针的移动,因为要想解析完成就必须把模板全部编译完。

  1. function advance (n) {
  2. index += n;
  3. html = html.substring(n);
  4. }

while

template 的 while 循环是解析中最重要的一环,也是这一小节的重点。
循环的终止条件是 html 字符串为空,即 html 字符串全部编译完毕。
循环时,第一个判断是判断内容是否在存纯文本标签中。判断的作用是:确保我们没有像脚本/样式这样的纯文本内容元素。
Vue 编译三部曲:如何将 template 编译成 AST ? - 图5
内容不在纯文本标签,判断 template 字符串的第一个<字符位置,来进行不同的操作。

  1. var textEnd = html.indexOf('<');

当前 template 第一个字符是 <

在这种场景下, template 会出现以下几种情况,重点是解析开始标签和结束标签。

  • <!— 开头的注释:会找到注释的结尾,将注释截取出来,移动指针,并将注释当做当前父节点的一个子元素存储到 children 中。
  • <![ 开头的 条件注释:如果是条件注释,会直接移动指针,不做任何其他操作。
  • <!DOCTYPE 开头的 doctype:如果是 doctype,会直接移动指针,不做任何其他操作。
  • < 开头的开始标签
  • < 开头的结束标签

    解析开始标签

    ①,通过正则匹配到开始标签,如果匹配到就会返回一个 match 的匹配结果。例如:

    1. <div id="test-id" class="test-calss" v-show='show'></div>

    template 中有一个 div,当匹配到开始标签(结束标签类似)时,会返回这样数组结果。

    1. 0: "<div"
    2. 1: "div"
    3. groups: undefined
    4. index: 0
    5. input: "<div>\n <ul>\n <li>1</li>\n </ul>\n </div>"
    6. length: 2

    ②,接下来:
    定义了 match 变量,它是一个对象,初始状态下拥有三个属性:

  • tagName:存储标签的名称。 div

  • attrs :用来存储将来被匹配到的属性,例如:id、class、v-if 这些属性。
  • start:初始值为 index,是当前字符流读入位置在整个 html 字符串中的相对位置。

③,然后通过 advance函数移动指针。
④,如果没有匹配到开始标签的结束部分,并且存在属性,就会遍历找出所有属性和动态属性。保存在 match 的 attrs 中。
image.png
⑤,上一步获取了标签的属性和动态属性,但是即使这样并不能说明这是一个完整的标签,只有当匹配到开始标记的结束标记时,才能证明这是一个完整的标签,所以才会有这一步的判断。var startTagClose= /^\s*(\/?)>/;并且标记 unarySlash属性。
image.png
⑥,假设正常匹配了,有匹配结果,也返回了 match (结构如上),就会走到handleStartTag 这个函数的作用就是用来处理开始标签的解析结果,所以它接收 parseStartTag 函数的返回值作为参数。
handleStartTag 的核心逻辑很简单,先判断开始标签是否是一元标签,类似 Vue 编译三部曲:如何将 template 编译成 AST ? - 图8
这样,接着对 match.attrs 遍历并做了一些处理,最后判断如果非一元标签,则往 stack 里 push 一个对象,并且把 tagName 赋值给 lastTag。

  1. function parseStartTag () {
  2. // ①
  3. var start = html.match(startTagOpen);
  4. if (start) {
  5. // ②
  6. var match = {
  7. tagName: start[1],
  8. attrs: [],
  9. start: index
  10. };
  11. // ③
  12. advance(start[0].length);
  13. var end, attr;
  14. // ④
  15. while (!(end = html.match(startTagClose)) && (attr = html.match(dynamicArgAttribute) || html.match(attribute))) {
  16. ...
  17. }
  18. // ⑤
  19. if (end) {
  20. match.unarySlash = end[1];
  21. advance(end[0].length);
  22. match.end = index;
  23. return match
  24. }
  25. }
  26. }
  27. // Start tag:
  28. var startTagMatch = parseStartTag();
  29. if (startTagMatch) {
  30. handleStartTag(startTagMatch);
  31. ...
  32. }
  33. // ⑥
  34. function handleStartTag (match) {
  35. ...
  36. }

解析结束标签

有解析开始标签就会解析结束标签。所以接下来我们来看看如何解析结束标签。
①,正则匹配结束标签(具体的正则看前面)。
②,匹配到结束标签,进行解析处理,获取到结束标签的标签名称、开始位置和结束位置,开始进行解析操作。
③,查找同一类型的最近打开的标记,并记录位置。
④,如果存在同一类型的标记,就将 stack 中匹配的标记弹出。
⑤,如果没有同一类型的标记,分别处理 </br>、</p> 标签。这是为了和浏览器保持同样的行为。举个例子:在代码中,分别写了

的结束标签,但注意我们并没有写起始标签,但是浏览器是能够正常解析他们的,其中
标签被正常解析为
标签,而

标签被正常解析为

。除了 br 与 p 其他任何标签如果你只写了结束标签那么浏览器都将会忽略。所以为了与浏览器的行为相同,parseEndTag 函数也需要专门处理br与p的结束标签,即:

  1. <div>
  2. </br>
  3. </p>
  4. </div>

image.png

  1. // ①
  2. var endTagMatch = html.match(endTag);
  3. if (endTagMatch) {
  4. var curIndex = index;
  5. advance(endTagMatch[0].length);
  6. // ②
  7. // 获取到结束标签的标签名称、开始位置和结束位置
  8. parseEndTag(endTagMatch[1], curIndex, index);
  9. continue
  10. }
  11. function parseEndTag (tagName, start, end) {
  12. ...
  13. // ③
  14. if (tagName) {
  15. lowerCasedTagName = tagName.toLowerCase();
  16. for (pos = stack.length - 1; pos >= 0; pos--) {
  17. if (stack[pos].lowerCasedTag === lowerCasedTagName) {
  18. break
  19. }
  20. }
  21. } else {
  22. pos = 0;
  23. }
  24. // ④
  25. if (pos >= 0) {
  26. ...
  27. stack.length = pos;
  28. lastTag = pos && stack[pos - 1].tag;
  29. // ⑤
  30. } else if (lowerCasedTagName === 'br') {
  31. if (options.start) {
  32. options.start(tagName, [], true, start, end);
  33. }
  34. } else if (lowerCasedTagName === 'p') {
  35. if (options.start) {
  36. options.start(tagName, [], false, start, end);
  37. }
  38. if (options.end) {
  39. options.end(tagName, start, end);
  40. }
  41. }
  42. }

到这里结束标签页解析完成,但是在 Vue 中对开始标签和结束标签的解析远不止这样,因为为了浏览器行为保持一下在解析的过程中还会对一些特殊标签特殊处理,典型的就是 p、br标签,我会在后面出一片文章来详细讲讲 Vue 是如何处理它们的。

当前 template 不存在 <

当解析到的 template 中不存在 < 时,这是认为是一个文本。操作很简单就是移动指针。

并且这里在源码中发现初始化变量的时候,都是这样写的 var text =(void0), rest =(void0), next =(void0);而不是直接 var xx = undefined。原因是这样操作更加的安全,我在之前的一篇文章中专门解析过,有兴趣的可以再去看看。 JavaScript void 运算符

  1. if (textEnd < 0) {
  2. text = html;
  3. }
  4. if (text) {
  5. advance(text.length);
  6. }

当前 template < 不在第一个字符串

这里的判断处理就是为了处理我们在一些纯文本中也会写 <标记的场景。例如:

  1. <div>1<2</div>

现在有这样一段模块,<div>被解析之后,还剩 1<2,这时解析到存在 <标记但是位置不在第一个。就循环找出包含<的这一段文本,并将这一段当成一个纯文本处理。

  1. if (textEnd >= 0) {
  2. rest = html.slice(textEnd);
  3. while (
  4. !endTag.test(rest) &&
  5. !startTagOpen.test(rest) &&
  6. !comment.test(rest) &&
  7. !conditionalComment.test(rest)
  8. ) {
  9. next = rest.indexOf('<', 1);
  10. if (next < 0) { break }
  11. textEnd += next;
  12. rest = html.slice(textEnd);
  13. }
  14. text = html.substring(0, textEnd);
  15. }

Vue 编译三部曲:如何将 template 编译成 AST ? - 图10

处理 stack 栈中剩余未处理的标签

当 while 循环解析了一遍 template 之后,会在调用一次 parseEndTag,这样做的目的是为了处理 stack 栈中剩余未处理的标签。当调用时,没有传递任何参数,也意味着 tagName, start, end 都是空的,这时 pos 为 0 ,所以 i >= pos 始终成立,这个时候 stack 栈中如果有剩余未处理的标签,则会逐个警告缺少闭合标签,并调用 options.end 将其闭合。

  1. // Clean up any remaining tags
  2. parseEndTag();
  3. function parseEndTag (tagName, start, end) {
  4. if (tagName) {
  5. ...
  6. } else {
  7. pos = 0;
  8. }
  9. if (pos >= 0) {
  10. for (var i = stack.length - 1; i >= pos; i--) {
  11. if (i > pos || !tagName && options.warn) {
  12. options.warn(
  13. ("tag <" + (stack[i].tag) + "> has no matching end tag."),
  14. { start: stack[i].start, end: stack[i].end }
  15. );
  16. }
  17. }
  18. ...
  19. }
  20. }

到这里解析 template 的重点过程都基本结束了,整个过程就是遍历 template 字符串,然后通过正则一点一点的匹配解析字符串,直到整个字符串被解析完成。

生成 AST

当然解析完 template 目的是生成 AST,进过上面的一些列操作,只是解析完 template 字符串,并没有生成一颗 AST 抽象语法树。正常的来说抽象语法树应该是如下这样的,节点与节点之间通过 parent 和 children 建立联系,每个节点的 type 属性用来标识该节点的类别,比如 type 为 1 代表该节点为元素节点,type 为 3 代表该节点为文本节点。
image.png
生成 AST 的主要步骤是在解析的过程中,会调用对应的钩子函数。解析到开始标签,就调用开始的钩子函数,解析到结束标签就调用结束的钩子函数,解析到文本就会调用文本的钩子,解析到注释就调用注释的钩子函数。这些钩子函数就会将所有的节点串联起来,并生成 AST 树的结构。

start 钩子函数

这个钩子函数会在解析到开始标签的时候被调用。为了更加清楚的解析,我们引入如下一个模板,如下:

  1. <div><span></span><p></p></div>

解析

①,解析到<div>会调用 start 钩子函数。
②,创建一个基础元素对象。

  1. {
  2. type: 1,
  3. tag:"div",
  4. parent: null,
  5. children: [],
  6. attrsList: []
  7. }
  8. function createASTElement (
  9. tag,
  10. attrs,
  11. parent
  12. ) {
  13. return {
  14. type: 1,
  15. tag: tag,
  16. attrsList: attrs,
  17. attrsMap: makeAttrsMap(attrs),
  18. rawAttrsMap: {},
  19. parent: parent,
  20. children: []
  21. }
  22. }

③,接着判断 root 是否存在,如果不存在则直接将 element 赋值给 root 。root 是一个记录值,也就是最后解析返回的整个 AST。
④,如果当前标签不是一元标签时,会将当前的 element赋值给 currentParent目的是为建立父子元素的关系。
⑤,将元素入栈,入栈的目的是为了做回退操作,这里先不讲为什么需要做回退,后面在讲。此时 stack **=** [{ tag**:**"div"... }]

  1. // parseHTML函数 解析到开始标签
  2. function handleStartTag (match) {
  3. if (options.start) {
  4. // ①
  5. options.start(tagName, attrs, unary, match.start, match.end);
  6. }
  7. }
  8. // start 钩子函数
  9. start: {
  10. // ②
  11. var element = createASTElement(tag, attrs, currentParent);
  12. // element:
  13. // {
  14. // type: 1,
  15. // tag:"div",
  16. // parent: null,
  17. // children: [],
  18. // attrsList: []
  19. // }
  20. // ③
  21. if (!root) {
  22. root = element;
  23. }
  24. // ④
  25. if (!unary) {
  26. currentParent = element;
  27. // currentParent:
  28. // {
  29. // type: 1,
  30. // tag:"div",
  31. // parent: null,
  32. // children: [],
  33. // attrsList: []
  34. // }
  35. // ⑤
  36. stack.push(element);
  37. }
  38. }

解析

接着解析到 <span>。此时 root 已经存在,currentParent 也存在,所以会将 span 元素的描述对象添加到 currentParent 的 children 数组中作为子节点,并将自己的 parent 元素进行标记。所以最终生成的描述对象为:

  1. {
  2. type: 1,
  3. tag:"div",
  4. parent: {/*div 元素的描述*/},
  5. attrsList: []
  6. children: [{
  7. type: 1,
  8. tag:"span",
  9. parent: div,
  10. attrsList: [],
  11. children:[]
  12. }],
  13. }

此时 stack **=** [{ tag**:**"div"... }, {tag**:**"span"...}]

end 钩子函数

当解析到结束标签就会调用结束标签的钩子函数,还是这段模板代码,解析完<div><span>后遇到了</span>

  1. <div><span></span><p></p></div>

解析

①,首先就是保存最后一个元素,将 stack 的最后一个元素删除,也就是变成 stack = [{tag:”div”…}],这就是做了一个回退操作 。
②,设置 currentParent 为 stack 的最后一个元素。

  1. end: function end (tag, start, end$1) {
  2. // ①
  3. var element = stack[stack.length - 1];
  4. stack.length -= 1;
  5. // ②
  6. currentParet = stack[stack.length - 1];
  7. ...
  8. },

为什么回退?

解析

当再次解析到开始标签时,就会再次调用 start 钩子函数,这里重点是在解析 p 的开始标签时:stack = [{tag:”div”…},{tag:”p”…}] ,由于在解析到上一个 **</span>**标签时做了一个回退操作, 这就能保证在解析p开始标签的时候,stack 中存储的是 p 标签父级元素的描述对象。

解析

解析结束标签,做回退操作。
遇到开始标签就生成元素,勾勒上下文关系 parent、children 等,每当遇到一个非一元标签的结束标签时,都会回退 currentParent 变量的值为之前的值,这样就修正了当前正在解析的元素的父级元素。

chars 钩子函数

当然在我们的代码中肯定不止是开始和结束标签,还会有文本。当遇到文本时,就会调用 chars 钩子函数。
①,首先判断 currentParent(指向的是当前节点的父节点) 变量是否存在,不存在就说明,说明1:只有文本节点。2:文本在根元素之外。这两种情况都会警告⚠️提醒,接触后面的操作。
②,第二个判断主要是解决 ie textarea 占位符的问题。issue
③,判断当前元素未使用 v-pre 指令,text不为空,使用 parseText 函数成功解析当前文本节点的内容。这里的重点在于 parseText 函数,parseText 函数的作用就是用来解析如果我们的文本包含了字面量表达式。例如:

  1. <div>1111: {{ text }}</div>

这样的文本就会解析成如下的一个描述对象, 包含 expression 、tokens (包含原始的文本)。
image.png
解析完之后会生成一个 type = 2 的描述对象:

  1. child = {
  2. type: 2,
  3. expression: res.expression,
  4. tokens: res.tokens,
  5. text: text
  6. };

④,如果使用了 v-pre || test 为空 || parseText 解析失败,那么就会生成一个 type = 3 的存文本描述对象。

  1. child = {
  2. type: 3,
  3. text: text
  4. };

⑤,最后将解析到描述对象,添加到当前父元素的 children 列表中,注意:这里之前说明过因为我们的整个 template 是不能是纯文本的,必须由根元素,所以如果是文本节点,一点是会有父元素的。

  1. chars: function chars (text, start, end) {
  2. // ①
  3. if (!currentParent) {
  4. {
  5. if (text === template) {
  6. ...警告
  7. } else if ((text = text.trim())) {
  8. ...警告
  9. }
  10. }
  11. return
  12. }
  13. // ②
  14. if (isIE &&
  15. currentParent.tag === 'textarea' &&
  16. currentParent.attrsMap.placeholder === text
  17. ) {
  18. return
  19. }
  20. var children = currentParent.children;
  21. ...
  22. if (text) {
  23. ...
  24. // ③
  25. if (!inVPre && text !== ' ' && (res = parseText(text, delimiters))) {
  26. child = {
  27. type: 2,
  28. expression: res.expression,
  29. tokens: res.tokens,
  30. text: text
  31. };
  32. // ④
  33. } else if (text !== ' ' || !children.length || children[children.length - 1].text !== ' ') {
  34. child = {
  35. type: 3,
  36. text: text
  37. };
  38. }
  39. // ⑤
  40. if (child) {
  41. ...
  42. children.push(child);
  43. }
  44. }
  45. },

到这里文本节点的解析完成。接下来看看注释解析的钩子函数。

commit 钩子函数

当我们配置了 options.comments = true ,也就以为着我们需要保留我们的注释,这个配置需要我们手动开启,开启后就会在页面渲染后保留注释。

注意:如果开启了保留注释匹配后,浏览器会保留注释。但是可能对布局产生影响,尤其是对行内元素的影响。为了消除这些影响带来的问题,好的做法是将它们去掉。

image.png
注释的解析比较简单,就是创建注释节点,然后添加当当前父元素的子阶段列表中。要注意的是纯文本节点和注释节点的描述对象的 type 都是3,不同的是注释节点的元素描述对象拥有 isComment 属性,并且该属性的值为 true,目的就是用来与普通文本节点作区分的。

  1. shouldKeepComment: options.comments,
  2. if (textEnd === 0) {
  3. ...
  4. if (options.shouldKeepComment) {
  5. options.comment(html.substring(4, commentEnd), index, index + commentEnd + 3);
  6. }
  7. ...
  8. }
  9. comment: function comment (text, start, end) {
  10. if (currentParent) {
  11. var child = {
  12. type: 3,
  13. text: text,
  14. isComment: true
  15. };
  16. ...
  17. currentParent.children.push(child);
  18. }
  19. }

到这里在生成 AST 过程中的 四个钩子函数已经全部讲完。但是 Vue 本身在对元素做处理的时候的时候肯定不会是这么简单的,因为这处理的过程中还要处理一元标签、静态属性、动态属性等。

番外(可跳过)

这一小节注意是看看在生成 AST 过程中的一些重要的工具函数。

createASTElement 函数

创建元素的描述对象。

  1. function createASTElement (
  2. tag,
  3. attrs,
  4. parent
  5. ) {
  6. return {
  7. type: 1,
  8. tag: tag,
  9. attrsList: attrs,
  10. attrsMap: makeAttrsMap(attrs),
  11. rawAttrsMap: {},
  12. parent: parent,
  13. children: []
  14. }
  15. }

指令解析相关的正则

前面也讲到关于一些标签匹配相关的正则。其实这些正则大家在平时的项目中有涉及也可以用起来,毕竟这些正则是经过千万人测试的。

  1. var onRE = /^@|^v-on:/;
  2. var dirRE = /^v-|^@|^:|^#/;
  3. var forAliasRE = /([\s\S]*?)\s+(?:in|of)\s+([\s\S]*)/;
  4. var forIteratorRE = /,([^,\}\]]*)(?:,([^,\}\]]*))?$/;
  5. var stripParensRE = /^\(|\)$/g;
  6. var dynamicArgRE = /^\[.*\]$/;
  7. var argRE = /:(.*)$/;
  8. var bindRE = /^:|^\.|^v-bind:/;
  9. var modifierRE = /\.[^.\]]+(?=[^\]]*$)/g;

onRE
匹配已字符 @ 或者 v-on开头的字符串,检测标签属性是够是监听事件的指令。

  1. var onRE = /^@|^v-on:/;

dirRE
匹配 v-@:#开头的字符串,检测属性名是否是指令。v-开头的属性统统都任务是指令。@字符是 v-on 的缩写。: 是 v-bind 的缩写。 #是 v-slot 的缩写。

  1. var dirRE = /^v-|^@|^:|^#/;

forAliasRE
匹配 v-for属性的值,目的是捕获 in 或者 of 前后的字符串。

  1. var forAliasRE = /([\s\S]*?)\s+(?:in|of)\s+([\s\S]*)/;

forIteratorRE
这个也是用来匹配 v-for属性的,不同的是,这里是匹配遍历时的 value 、 key 、index 。

  1. var forIteratorRE = /,([^,\}\]]*)(?:,([^,\}\]]*))?$/;

stripParensRE
匹配以字符 (开头、)结尾的字符串。作用是配合上面的正则对字符进行处理()

  1. var stripParensRE = /^\(|\)$/g;

argRE
匹配指令中的参数。作用是捕获指令中的参数。常见的就是指令中的修饰符。

  1. var argRE = /:(.*)$/;

bindRE
匹配:.v-bind:开头的字符串。作用是检查属性是否是绑定。

  1. var bindRE = /^:|^\.|^v-bind:/;

modifierRE
匹配修饰符。主要作用是判断是否有修饰符。

  1. var modifierRE = /\.[^.\]]+(?=[^\]]*$)/g;

parseText 函数

这个函数的作用是解析 text,在上面讲 chars 钩子函数的时候也说道这个函数。函数有两个参数textdelimitersdelimiters参数作用就是:改变纯文本插入分隔符。例如:

  1. delimiters: ['${', '}'],
  2. // 模板
  3. <div>{{ text }}</div>

模板会被编译成这样。
image.png
在 parseText 函数中,重点逻辑是开启一个 while 循环,使用 tagRE 正则匹配文本内容,并将匹配结果保存在 match 变量中,直到匹配失败循环才会终止,这时意味着所有的字面量表达式都已经处理完毕了。

  1. while ((match = tagRE.exec(text))) {
  2. index = match.index;
  3. if (index > lastIndex) {
  4. rawTokens.push(tokenValue = text.slice(lastIndex, index));
  5. tokens.push(JSON.stringify(tokenValue));
  6. }
  7. var exp = parseFilters(match[1].trim());
  8. tokens.push(("_s(" + exp + ")"));
  9. rawTokens.push({ '@binding': exp });
  10. lastIndex = index + match[0].length;
  11. }

例如有一段这样的 template:

  1. // text: '小白',
  2. // message: '好久不见'
  3. <div>hello, {{ text }},{{ message }}</div>

会被解析成如下 AST:
image.png

closeElement 函数

这个函数会在解析非一元开始标签和解析结束标签的时候调用,主要作用有两个:

  1. 对数据状态进行还原,
  2. 调用后置处理转换钩子函数。

    整体流程

    Vue 编译三部曲:如何将 template 编译成 AST ? - 图16

    总结

    Vue 编译三部曲第一步 parse的整个流程就已经分享完了,虽然源码看似非常的复制,但是如果只是抽离主流程的话,还是比较简单的。parse 的目的是将开发者写的 template 模板字符串转换成抽象语法树 AST ,AST 就这里来说就是一个树状结构的 JavaScript 对象,描述了这个模板,这个对象包含了每一个元素的上下文关系。那么整个 parse 的过程是利用很多正则表达式顺序解析模板,当解析到开始标签、闭合标签、文本的时候都会分别执行对应的回调函数,来达到构造 AST 树的目的。

    参考