關(guān)于parseHTML 函數(shù)源碼解析 AST 相關(guān)知識(shí)已做過(guò)介紹,下面可以看看Vue start鉤子函數(shù)源碼。
start: function start(tag, attrs, unary) { // check namespace. // inherit parent ns if there is one var ns = (currentParent && currentParent.ns) || platformGetTagNamespace(tag); // handle IE svg bug /* istanbul ignore if */ if (isIE && ns === 'svg') { attrs = guardIESVGBug(attrs); } var element = createASTElement(tag, attrs, currentParent); if (ns) { element.ns = ns; } if (isForbiddenTag(element) && !isServerRendering()) { element.forbidden = true; warn$2( 'Templates should only be responsible for mapping the state to the ' + 'UI. Avoid placing tags with side-effects in your templates, such as ' + "<" + tag + ">" + ', as they will not be parsed.' ); } // apply pre-transforms for (var 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) { // structural directives processFor(element); processIf(element); processOnce(element); // element-scope stuff processElement(element, options); } function checkRootConstraints(el) { { if (el.tag === 'slot' || el.tag === 'template') { warnOnce( "Cannot use <" + (el.tag) + "> as component root element because it may " + 'contain multiple nodes.' ); } if (el.attrsMap.hasOwnProperty('v-for')) { warnOnce( 'Cannot use v-for on stateful component root element because ' + 'it renders multiple elements.' ); } } } // tree management if (!root) { root = element; checkRootConstraints(root); } else if (!stack.length) { // allow root elements with v-if, v-else-if and v-else if (root.if && (element.elseif || element.else)) { checkRootConstraints(element); addIfCondition(root, { exp: element.elseif, block: element }); } else { warnOnce( "Component template should contain exactly one root element. " + "If you are using v-if on multiple elements, " + "use v-else-if to chain them instead." ); } } if (currentParent && !element.forbidden) { if (element.elseif || element.else) { processIfConditions(element, currentParent); } else if (element.slotScope) { // scoped slot currentParent.plain = false; var name = element.slotTarget || '"default"'; (currentParent.scopedSlots || (currentParent.scopedSlots = {}))[name] = element; } else { currentParent.children.push(element); element.parent = currentParent; } } if (!unary) { currentParent = element; stack.push(element); } else { closeElement(element); } }
在上面的代碼中start 鉤子函數(shù)能接受的參數(shù)有三個(gè),分別是 tag 標(biāo)簽名稱,attrs表示該標(biāo)簽的屬性數(shù)組,和unary是代表著是否是一元標(biāo)簽的標(biāo)識(shí) 。
不懂的不要擔(dān)心,現(xiàn)在我們一起來(lái)解析函數(shù)體中的代碼。
var ns = (currentParent && currentParent.ns) || platformGetTagNamespace(tag);
上面的開(kāi)頭定義了標(biāo)簽的命名空間的 ns 變量,主要是為獲取當(dāng)前元素的命名空間,那如何實(shí)現(xiàn)?我們要首先檢測(cè)currentParent 變量是否存在,眾所周知當(dāng)前元素的父級(jí)元素描述對(duì)象就是 currentParent 變量,比如,當(dāng)前父級(jí)元素存在命名空間,那當(dāng)前元素的命名空間就是父級(jí)的命名空間名稱。
假如父級(jí)元素不存在或父級(jí)元素沒(méi)有命名空間,調(diào)用platformGetTagNamespace函數(shù),platformGetTagNamespace 函數(shù)顯示獲取svg 和 math 這兩個(gè)標(biāo)簽的命名空間,它們兩個(gè)的命名空間是繼承所有子標(biāo)簽。
platformGetTagNamespace 源碼
function getTagNamespace(tag) { if (isSVG(tag)) { return "svg" } if (tag === "math") { return "math" } } 接下來(lái)源碼: 1 2 3 if (isIE && ns === "svg") { attrs = guardIESVGBug(attrs); }
這里通過(guò)isIE來(lái)判斷宿主環(huán)境是不是IE瀏覽器,并且前元素的命名空間為svg, 如果是通過(guò)guardIESVGBug處理當(dāng)前元素的屬性數(shù)組attrs,并使用處理后的結(jié)果重新賦值給attrs變量,該問(wèn)題是svg標(biāo)簽中渲染多余的屬性,如下svg標(biāo)簽:
<svg xmlns:feature="http://www.openplans.org/topp"></svg>
被渲染為:
<svg xmlns:NS1="" NS1:xmlns:feature="http://www.openplans.org/topp"></svg>
標(biāo)簽中多了 'xmlns:NS1="" NS1:' 這段字符串,解決辦法也很簡(jiǎn)單,將整個(gè)多余的字符串去掉即可。而 guardIESVGBug 函數(shù)就是用來(lái)修改NS1:xmlns:feature屬性并移除xmlns:NS1="" 屬性的。
接下來(lái)源碼:
var element = createASTElement(tag, attrs, currentParent); if (ns) { element.ns = ns; }
在上章節(jié)聊過(guò),createASTElement 它將生成當(dāng)前標(biāo)簽的元素描述對(duì)象并且賦值給 element 變量。緊接著檢查當(dāng)前元素是否存在命名空間 ns ,如果存在則在元素對(duì)象上添加 ns 屬性,其值為命名空間的值。
接下來(lái)源碼:
if (isForbiddenTag(element) && !isServerRendering()) { element.forbidden = true; warn$2( 'Templates should only be responsible for mapping the state to the ' + 'UI. Avoid placing tags with side-effects in your templates, such as ' + "<" + tag + ">" + ', as they will not be parsed.' ); }
這里的作用就是判斷在非服務(wù)端渲染情況下,當(dāng)前解析的開(kāi)始標(biāo)簽是否是禁止在模板中使用的標(biāo)簽。哪些是禁止的呢?
isForbiddenTag 函數(shù)
function isForbiddenTag(el) { return ( el.tag === 'style' || (el.tag === 'script' && ( !el.attrsMap.type || el.attrsMap.type === 'text/javascript' )) ) }
可以看到,style,script 都是在禁止名單中,但通過(guò)isForbiddenTag 也發(fā)現(xiàn)一個(gè)彩蛋。
<script type="text/x-template" id="hello-world-template"> <p>Hello hello hello</p> </script>
當(dāng)定義模板的方式如上,在 <script> 元素上添加 type="text/x-template" 屬性。 此時(shí)的script不會(huì)被禁止。
最后還會(huì)在當(dāng)前元素的描述對(duì)象上添加 element.forbidden 屬性,并將其值設(shè)置為true。
接下來(lái)源碼:
for (var i = 0; i < preTransforms.length; i++) { element = preTransforms[i](element, options) || element; }
如上代碼中使用 for 循環(huán)遍歷了preTransforms 數(shù)組,preTransforms 是通過(guò)pluckModuleFunction 函數(shù)從options.modules 選項(xiàng)中篩選出名字為preTransformNode 函數(shù)所組成的數(shù)組。實(shí)際上 preTransforms 數(shù)組中只有一個(gè) preTransformNode 函數(shù)該函數(shù)只用來(lái)處理 input 標(biāo)簽我們?cè)诤竺嬲鹿?jié)會(huì)來(lái)講它。
接下來(lái)源碼:
if (!inVPre) { processPre(element); if (element.pre) { inVPre = true; } } if (platformIsPreTag(element.tag)) { inPre = true; } if (inVPre) { processRawAttrs(element); } else if (!element.processed) { // structural directives processFor(element); processIf(element); processOnce(element); // element-scope stuff processElement(element, options); }
可以看到這里會(huì)有大量的process*的函數(shù),這些函數(shù)是做什么用的呢?實(shí)際上process* 系列函數(shù)的作用就是對(duì)元素描述對(duì)象做進(jìn)一步處理,比如其中一個(gè)函數(shù)叫做 processPre,這個(gè)函數(shù)的作用就是用來(lái)檢測(cè)元素是否擁有v-pre 屬性,如果有v-pre 屬性則會(huì)在 element 描述對(duì)象上添加一個(gè) pre 屬性,如下:
{ type: 1, tag, attrsList: attrs, attrsMap: makeAttrsMap(attrs), parent, children: [], pre: true }
總結(jié):所有process* 系列函數(shù)的作用都是為了讓一個(gè)元素的描述對(duì)象更加充實(shí),使這個(gè)對(duì)象能更加詳細(xì)地描述一個(gè)元素, 不過(guò)我們本節(jié)主要總結(jié)解析一個(gè)開(kāi)始標(biāo)簽需要做的事情,所以稍后去看這些代碼的實(shí)現(xiàn)。
接下來(lái)源碼:
function checkRootConstraints(el) { { if (el.tag === 'slot' || el.tag === 'template') { warnOnce( "Cannot use <" + (el.tag) + "> as component root element because it may " + 'contain multiple nodes.' ); } if (el.attrsMap.hasOwnProperty('v-for')) { warnOnce( 'Cannot use v-for on stateful component root element because ' + 'it renders multiple elements.' ); } } }
我們知道在編寫(xiě) Vue 模板的時(shí)候會(huì)受到兩種約束,首先模板必須有且僅有一個(gè)被渲染的根元素,第二不能使用 slot 標(biāo)簽和 template 標(biāo)簽作為模板的根元素。
checkRootConstraints 函數(shù)內(nèi)部首先通過(guò)判斷 el.tag === 'slot' || el.tag === 'template' 來(lái)判斷根元素是否是slot 標(biāo)簽或 template 標(biāo)簽,如果是則打印警告信息。接
著又判斷當(dāng)前元素是否使用了 v-for 指令,因?yàn)関-for 指令會(huì)渲染多個(gè)節(jié)點(diǎn)所以根元素是不允許使用 v-for 指令的。
接下來(lái)源碼:
if (!root) { root = element; checkRootConstraints(root); } else if (!stack.length) { // allow root elements with v-if, v-else-if and v-else if (root.if && (element.elseif || element.else)) { checkRootConstraints(element); addIfCondition(root, { exp: element.elseif, block: element }); } else { warnOnce( "Component template should contain exactly one root element. " + "If you are using v-if on multiple elements, " + "use v-else-if to chain them instead." ); } }
這個(gè) if 語(yǔ)句先檢測(cè) root 是否存在!我們知道 root 變量在一開(kāi)始是不存在的,如果 root 不存在那說(shuō)明當(dāng)前元素應(yīng)該就是根元素,所以在 if 語(yǔ)句塊內(nèi)直接把當(dāng)前元素的描述對(duì)象 element 賦值給 root 變量,同時(shí)會(huì)調(diào)用 checkRootConstraints函數(shù)檢查根元素是否符合要求。
再來(lái)看 else if 語(yǔ)句的條件,當(dāng) stack 為空的情況下會(huì)執(zhí)行 else if 語(yǔ)句塊內(nèi)的代碼, 那stack 什么情況下才為空呢?前面已經(jīng)多次提到每當(dāng)遇到一個(gè)非一元標(biāo)簽時(shí)就會(huì)將該標(biāo)簽的描述對(duì)象放進(jìn)數(shù)組,并且每當(dāng)遇到一個(gè)結(jié)束標(biāo)簽時(shí)都會(huì)將該標(biāo)簽的描述對(duì)象從 stack 數(shù)組中拿掉,那也就是說(shuō)在只有一個(gè)根元素的情況下,正常解析完成一段 html 代碼后 stack 數(shù)組應(yīng)該為空,或者換個(gè)說(shuō)法,即當(dāng) stack 數(shù)組被清空后則說(shuō)明整個(gè)模板字符串已經(jīng)解析完畢了,但此時(shí) start 鉤子函數(shù)仍然被調(diào)用了,這說(shuō)明模板中存在多個(gè)根元素,這時(shí) else if 語(yǔ)句塊內(nèi)的代碼將被執(zhí)行:
接下來(lái)源碼:
if (root.if && (element.elseif || element.else)) { checkRootConstraints(element); addIfCondition(root, { exp: element.elseif, block: element }); } else { warnOnce( "Component template should contain exactly one root element. " + "If you are using v-if on multiple elements, " + "use v-else-if to chain them instead." ); }
想要能看懂這個(gè)代碼,你需要懂一些前置知識(shí)。
[ Vue條件渲染 ] (https://cn.vuejs.org/v2/guide/conditional.html)
我們知道在編寫(xiě) Vue 模板時(shí)的約束是必須有且僅有一個(gè)被渲染的根元素,但你可以定義多個(gè)根元素,只要能夠保證最終只渲染其中一個(gè)元素即可,能夠達(dá)到這個(gè)目的的方式只有一種,那就是在多個(gè)根元素之間使用 v-if 或 v-else-if 或 v-else 。
示例代碼:
<div v-if="type === 'A'"> A </div> <div v-else-if="type === 'B'"> B </div> <div v-else-if="type === 'C'"> C </div> <div v-else> Not A/B/C </div>
在回歸到代碼部分。
if (root.if && (element.elseif || element.else))
root 對(duì)象中的 .if 屬性、.elseif 屬性以及 .else 屬性都是哪里來(lái)的,它們是在通過(guò) processIf 函數(shù)處理元素描述對(duì)象時(shí),如果發(fā)現(xiàn)元素的屬性中有 v-if 或 v-else-if 或 v-else ,則會(huì)在元素描述對(duì)象上添加相應(yīng)的屬性作為標(biāo)識(shí)。
上面代碼如果第一個(gè)根元素上有 .if 的屬性,而非第一個(gè)根元素 element 有 .elseif 屬性或者 .else 屬性,這說(shuō)明根元素都是由 v-if、v-else-if、v-else 指令控制的,同時(shí)也保證了被渲染的根元素只有一個(gè)。
接下來(lái)繼續(xù)看:
if (root.if && (element.elseif || element.else)) { checkRootConstraints(element); addIfCondition(root, { exp: element.elseif, block: element }); } else { warnOnce( "Component template should contain exactly one root element. " + "If you are using v-if on multiple elements, " + "use v-else-if to chain them instead." ); }
checkRootConstraints 函數(shù)檢查當(dāng)前元素是否符合作為根元素的要求,這都能理解。
addIfCondition是什么
看下它的源代碼。
function addIfCondition(el, condition) { if (!el.ifConditions) { el.ifConditions = []; } el.ifConditions.push(condition); }
代碼很簡(jiǎn)單,調(diào)用addIfCondition 傳遞的參數(shù) root 對(duì)象,在函數(shù)體中擴(kuò)展一個(gè)屬性addIfCondition, root.addIfCondition 屬性值是一個(gè)對(duì)象。 此對(duì)象中有兩個(gè)屬性exp、block。實(shí)際上該函數(shù)是一個(gè)通用的函數(shù),不僅僅用在根元素中,它用在任何由 v-if、v-else-if 以及 v-else 組成的條件渲染的模板中。
通過(guò)如上分析我們可以發(fā)現(xiàn),具有 v-else-if 或 v-else 屬性的元素的描述對(duì)象會(huì)被添加到具有 v-if 屬性的元素描述對(duì)象的 .ifConnditions 數(shù)組中。
舉個(gè)例子,如下模板:
<div v-if="A"></div> <div v-else-if="B"></div> <div v-else-if="C"></div> <div v-else></div>
解析后生成的 AST 如下(簡(jiǎn)化版):
{ type: 1, tag: 'div', ifConditions: [ { exp: 'A', block: { type: 1, tag: 'div' /* 省略其他屬性 */ } }, { exp: 'B', block: { type: 1, tag: 'div' /* 省略其他屬性 */ } }, { exp: 'C', block: { type: 1, tag: 'div' /* 省略其他屬性 */ } }, { exp: 'undefined', block: { type: 1, tag: 'div' /* 省略其他屬性 */ } } ] // 省略其他屬性... }
假如當(dāng)前元素不滿足條件:root.if && (element.elseif || element.else) ,那么在非生產(chǎn)環(huán)境下會(huì)打印了警告信息。
接下來(lái)源碼:
if (currentParent && !element.forbidden) { if (element.elseif || element.else) { processIfConditions(element, currentParent); } else if (element.slotScope) { // scoped slot currentParent.plain = false; var name = element.slotTarget || '"default"'; (currentParent.scopedSlots || (currentParent.scopedSlots = {}))[name] = element; } else { currentParent.children.push(element); element.parent = currentParent; } } if (!unary) { currentParent = element; stack.push(element); } else { closeElement(element); }
我們先從下往上講, 為什么呢?原因是在解析根元素的時(shí)候currentParent并沒(méi)有賦值。
!unary 表示解析的是非一元標(biāo)簽,此時(shí)把該元素的描述對(duì)象添加到stack 棧中,并且將 currentParent 變量的值更新為當(dāng)前元素的描述對(duì)象。如果一個(gè)元素是一元標(biāo)簽,那么應(yīng)該調(diào)用 closeElement 函數(shù)閉合該元素。
老生常談的總結(jié):每當(dāng)遇到一個(gè)非一元標(biāo)簽都會(huì)將該元素的描述對(duì)象添加到stack數(shù)組,并且currentParent 始終存儲(chǔ)的是 stack 棧頂?shù)脑兀串?dāng)前解析元素的父級(jí)。
if (currentParent && !element.forbidden) { if (element.elseif || element.else) { processIfConditions(element, currentParent); } else if (element.slotScope) { // scoped slot currentParent.plain = false; var name = element.slotTarget || '"default"'; (currentParent.scopedSlots || (currentParent.scopedSlots = {}))[name] = element; } else { currentParent.children.push(element); element.parent = currentParent; } }
這里的條件要成立,則說(shuō)明當(dāng)前元素存在父級(jí)( currentParent ),并且當(dāng)前元素不是被禁止的元素。
常見(jiàn)的情況如下:
if (currentParent && !element.forbidden) { if (element.elseif || element.else) { //... } else if (element.slotScope) { // scoped slot //... } else { currentParent.children.push(element); element.parent = currentParent; } }
在 else 語(yǔ)句塊內(nèi),會(huì)把當(dāng)前元素描述對(duì)象添加到父級(jí)元素描述對(duì)象 ( currentParent ) 的children 數(shù)組中,同時(shí)將當(dāng)前元素對(duì)象的 parent 屬性指向父級(jí)元素對(duì)象,這樣就建立了元素描述對(duì)象間的父子級(jí)關(guān)系。
如果一個(gè)標(biāo)簽使用 v-else-if 或 v-else 指令,那么該元素的描述對(duì)象實(shí)際上會(huì)被添加到對(duì)應(yīng)的v-if 元素描述對(duì)象的 ifConditions 數(shù)組中,而非作為一個(gè)獨(dú)立的子節(jié)點(diǎn),這個(gè)工作就是由如下代碼完成:
if (currentParent && !element.forbidden) { if (element.elseif || element.else) { processIfConditions(element, currentParent); } else if (element.slotScope) { // scoped slot currentParent.plain = false; var name = element.slotTarget || '"default"'; (currentParent.scopedSlots || (currentParent.scopedSlots = {}))[name] = element; } else { //... } }
如當(dāng)前解析的元素使用了 v-else-if 或 v-else 指令,則會(huì)調(diào)用 processIfConditions 函數(shù),同時(shí)將當(dāng)前元素描述對(duì)象 element 和父級(jí)元素的描述對(duì)象 currentParent 作為參數(shù)傳遞:
processIfConditions 源碼
function processIfConditions(el, parent) { var prev = findPrevElement(parent.children); if (prev && prev.if) { addIfCondition(prev, { exp: el.elseif, block: el }); } else { warn$2( "v-" + (el.elseif ? ('else-if="' + el.elseif + '"') : 'else') + " " + "used on element <" + (el.tag) + "> without corresponding v-if." ); } }
findPrevElement 函數(shù)是去查找到當(dāng)前元素的前一個(gè)元素描述對(duì)象,并將其賦值給 prev 常量,addIfCondition 不用多說(shuō)如果prev 、prev.if 存在,調(diào)用 addIfCondition 函數(shù)在當(dāng)前元素描述對(duì)象添加 ifConditions 屬性,傳入的對(duì)象存儲(chǔ)相關(guān)信息。
如果當(dāng)前元素沒(méi)有使用 v-else-if 或 v-else 指令,下面就是判斷 slot-scope 特性,如下:
if (currentParent && !element.forbidden) { if (element.elseif || element.else) { //... } else if (element.slotScope) { // scoped slot currentParent.plain = false; var name = element.slotTarget || '"default"'; (currentParent.scopedSlots || (currentParent.scopedSlots = {}))[name] = element; } else { //... } }
slot-scope 特性就是該元素的描述對(duì)象會(huì)被添加到父級(jí)元素的scopedSlots 對(duì)象下,這也說(shuō)明使用 slot-scope 特性的元素與使用了v-else-if 或 v-else 指令的元素一樣,無(wú)法作為父級(jí)元素的子節(jié)點(diǎn), slot-scope 的特性就是父級(jí)元素描述對(duì)象的 scopedSlots 對(duì)象下。
后續(xù)更多相關(guān)精彩內(nèi)容,請(qǐng)大家多多關(guān)注。
文章版權(quán)歸作者所有,未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請(qǐng)注明本文地址:http://systransis.cn/yun/127761.html
vue parseHTML函數(shù)解析器遇到結(jié)束標(biāo)簽,在之前文章中已講述完畢。 例如有html(template)字符串: <divid="app"> <p>{{message}}</p> </div> 產(chǎn)出如下: { attrs:["id="app"","id...
摘要:模板解析器原理本文來(lái)自深入淺出模板編譯原理篇的第九章,主要講述了如何將模板解析成,這一章的內(nèi)容是全書(shū)最復(fù)雜且燒腦的章節(jié)。循環(huán)模板的偽代碼如下截取模板字符串并觸發(fā)鉤子函數(shù)為了方便理解,我們手動(dòng)模擬解析器的解析過(guò)程。 Vue.js 模板解析器原理 本文來(lái)自《深入淺出Vue.js》模板編譯原理篇的第九章,主要講述了如何將模板解析成AST,這一章的內(nèi)容是全書(shū)最復(fù)雜且燒腦的章節(jié)。本文未經(jīng)排版,真...
摘要:當(dāng)前正在處理的節(jié)點(diǎn),以及該節(jié)點(diǎn)的和等信息。源碼解析之一整體分析源碼解析之三寫(xiě)作中源碼解析之四寫(xiě)作中作者博客作者作者微博 筆者系 vue-loader 貢獻(xiàn)者之一(#16) 前言 vue-loader 源碼解析系列之一,閱讀該文章之前,請(qǐng)大家首先參考大綱 vue-loader 源碼解析系列之 整體分析 selector 做了什么 const path = require(path) co...
我們現(xiàn)在要講述的是當(dāng)解析器遇到一個(gè)文本節(jié)點(diǎn)時(shí)會(huì)如何為文本節(jié)點(diǎn)創(chuàng)建元素描述對(duì)象,那又該作何處理。 parseHTML(template,{ chars:function(){ //... }, //... }) chars源碼: chars:functionchars(text){ if(!currentParent){ { if(text===templ...
寫(xiě)文章不容易,點(diǎn)個(gè)贊唄兄弟 專注 Vue 源碼分享,文章分為白話版和 源碼版,白話版助于理解工作原理,源碼版助于了解內(nèi)部詳情,讓我們一起學(xué)習(xí)吧研究基于 Vue版本 【2.5.17】 如果你覺(jué)得排版難看,請(qǐng)點(diǎn)擊 下面鏈接 或者 拉到 下面關(guān)注公眾號(hào)也可以吧 【Vue原理】Compile - 源碼版 之 Parse 主要流程 本文難度較繁瑣,需要耐心觀看,如果你對(duì) compile 源碼暫時(shí)...
知道嗎?Vue.js 有 2 個(gè)版本,一個(gè)是Runtime + Compiler版本,另一個(gè)是Runtime only版本。Runtime + Compiler版本是包含編譯代碼的,簡(jiǎn)單來(lái)說(shuō)就是Runtime only版本不包含編譯代碼的,在運(yùn)行時(shí)候,需要借助 webpack 的 vue-loader 事先把模板編譯成 render 函數(shù)?! 〖偃缭谀阈枰诳蛻舳司幾g模板 (比如傳入一個(gè)字符串...
閱讀 566·2023-03-27 18:33
閱讀 755·2023-03-26 17:27
閱讀 656·2023-03-26 17:14
閱讀 608·2023-03-17 21:13
閱讀 541·2023-03-17 08:28
閱讀 1829·2023-02-27 22:32
閱讀 1324·2023-02-27 22:27
閱讀 2207·2023-01-20 08:28