HTMLParserOptions.start()
用来解析标签的开始部分(匹配到标签开始部分时调用),主要区分标签类型、解析标签指令配置与动态绑定参数等等。
let root let currentParent function start(tag, attrs, unary, start, end) { const ns = (currentParent && currentParent.ns) || platformGetTagNamespace(tag) if (isIE && ns === 'svg') attrs = guardIESVGBug(attrs) let element: ASTElement = createASTElement(tag, attrs, currentParent) if (ns) element.ns = ns if (__DEV__) { if (options.outputSourceRange) { element.start = start element.end = end element.rawAttrsMap = element.attrsList.reduce((cumulated, attr) ={ cumulated[attr.name] = attr return cumulated }, {}) } attrs.forEach(attr =invalidAttributeRE.test(attr.name) && warn('')) } if (isForbiddenTag(element) && !isServerRendering()) { element.forbidden = true __DEV__ && warn('') } for (let i = 0; i < preTransforms.length; i++) { element = preTransforms[i](element, options) || element } if (!inVPre) { processPre(element) if (element.pre) inVPre = true } if (platformIsPreTag(element.tag)) inPre = true if (inVPre) processRawAttrs(element) else if (!element.processed) { processFor(element) processIf(element) processOnce(element) } if (!root) { root = element if (__DEV__) checkRootConstraints(root) } if (!unary) { currentParent = element stack.push(element) } else { closeElement(element) } },
start 函数在解析完标签的开始部分后被调用,接收的五个参数分别是:标签名 tag,标签的属性数组 attrs,是否自闭合 unary,起点位置 start,结束位置 end
- 进入函数之后,首先会验证 当前元素的父元素的标签命名空间(svg,math或者undefined),如果是 svg 元素,还会对解析出来的 attrs 对象进行处理,去掉 svg 标签定义属性(xmlns 之类的属性)
- 调用 createASTElement(tag, attrs, currentParent) 方法创建当前元素对应的 AST 对象 element。此时结构如下:
{ type: 1, tag: tag, attrsList: attrs, attrsMap: makeAttrsMap(attrs), rawAttrsMap: {}, parent: currentParent, children: [] }
- 在开发环境下,还会将节点在字符串中的位置与节点原有的属性进行记录,并且 校验属性名 是否合法(禁止空格,引号,尖括号,反斜杠和等号)
- 校验标签合法性,如果是 style,script 之类的标签会被标记为“被禁止”(element.forbidden = true)
- 遍历 preTransforms 数组配置的处理函数,分别处理当前节点的 ast 结果,并重新更新节点的 ast 对象(这里只处理 input)
这里处理后的 input ast element,会比基础的 ast element 要多一些属性:
{ attrs: [], attrsList: [], attrsMap: { 'v-model': 'xxx' }, chidlren: [], derectives: [{ isDynamicArg: false, modifiers: undefined, name: 'model', rawName: 'model', value: 'xxx' }], events: { input: { dynamic: undefined, value: "if($event.target.composing)return;xxx=$event.target.value" } }, hasBindings: true, parent: currentParent, plain: false, props: [{ dynamic: undefined, name: 'value', value: '(xxx)' }], rawAttrsMap: {}, static: false }
虽然上面也省略了几个属性和部分属性值,但是重点属性都在里面。在 preTransforms 过程中,实际上是通过 preTransformNode() 函数处理 input 标签,并且该标签具有 v-model 配置,没有 v-model 时直接退出。
之后会判断该元素是否有动态绑定类型,如果是 动态绑定的元素类型,则会增加一个 ifConditions 配置,内部会填充 checkbox, radio 和 其他 input 类型的标签,用来根据不同的情况显示不同的展示形式(个人理解这里为什么只有三种,是因为 checkbox 和 radio 与其他的 input 输入框差别比较大,而且需要 label 标签配合)
- 判断元素有没有设置 v-pre 指令或者是一个 pre 标签,重新设置 inVPre, inPre 的状态
- 如果此时 inVPre === true,则直接跳过这个节点内部的编译;否则会依次判断 v-for,v-if 和 v-once 配置并进行编译
这里会先判断 for 循环再判断 if 条件,所以才有 for 的优先级高于 if。
- 如果存在 v-for,会在 ast 对象中添加 for 和 forProcessed 属性,并解析条件;如果内部有文本节点要显示循环的值,则会在标签最末级创建一个文本节点并绑定显示条件
- 如果存在 v-if,会在 ast 对象中添加 if 和 ifProcessed 属性,并添加一个 ifConditions 属性,存放不同条件下的 ast 节点对象和渲染条件
- 如果有 v-once,一样会在 ast 对象中添加 once 和 onceProcessed,并且会标记 staticProcessed
- 上面的过程执行完之后,如果此时外部的 root 是 undefined,则会将当前的节点作为根元素赋值给 root,并调用 checkRootConstraints 检查根节点
- 如果当前节点是一个自闭合标签,则直接调用 closeElement 结束该节点;不然则将该节点赋值给 currentParent 并插入 stack 解析栈,以供子节点的解析