摘要:簡單前端模板引擎實現(xiàn)本身主要是以的模塊的形式發(fā)布的,不過它也會發(fā)布客戶端版本。按照之前的想法,這個模板引擎最終返回的應(yīng)該是一個編譯好的模板。最后一個改進(jìn)可以使我們的模板引擎更為強(qiáng)大。
簡單前端模板引擎實現(xiàn)
AbsurdJS本身主要是以NodeJS的模塊的形式發(fā)布的,不過它也會發(fā)布客戶端版本??紤]到這些,我就不能直接使用現(xiàn)有的引擎了,因為它們大部分都是在NodeJS上運行的,而不能跑在瀏覽器上。我需要的是一個小巧的,純粹以Javascript編寫的東西,能夠直接運行在瀏覽器上。當(dāng)我某天偶然發(fā)現(xiàn)John Resig的這篇博客,我驚喜地發(fā)現(xiàn),這不正是我苦苦尋找的東西嘛!我稍稍做了一些修改,代碼行數(shù)差不多20行左右。其中的邏輯非常有意思。在這篇文章中我會一步一步重現(xiàn)編寫這個引擎的過程,如果你能一路看下去的話,你就會明白John的這個想法是多么犀利!
最初我的想法是這樣子的:
JavaScript
var TemplateEngine = function(tpl, data) { // magic here ... } var template = "Hello, my name is <%name%>. I"m <%age%> years old.
"; console.log(TemplateEngine(template, { name: "Krasimir", age: 29 })); var TemplateEngine = function(tpl, data) { // magic here ... } var template = "Hello, my name is <%name%>. I"m <%age%> years old.
"; console.log(TemplateEngine(template, { name: "Krasimir", age: 29 }));
一個簡單的函數(shù),輸入是我們的模板以及數(shù)據(jù)對象,輸出么估計你也很容易想到,像下面這樣子:
XHTML
Hello, my name is Krasimir. I"m 29 years old.
Hello, my name is Krasimir. I"m 29 years old.
其中第一步要做的是尋找里面的模板參數(shù),然后替換成傳給引擎的具體數(shù)據(jù)。我決定使用正則表達(dá)式來完成這一步。不過我不是最擅長這個,所以寫的不好的話歡迎隨時來噴。
XHTML
var re = /<%([^%>]+)?%>/g; var re = /<%([^%>]+)?%>/g;
這句正則表達(dá)式會捕獲所有以<%開頭,以%>結(jié)尾的片段。末尾的參數(shù)g(global)表示不只匹配一個,而是匹配所有符合的片段。Javascript里面有很多種使用正則表達(dá)式的方法,我們需要的是根據(jù)正則表達(dá)式輸出一個數(shù)組,包含所有的字符串,這正是exec所做的。
JavaScript
var re = /<%([^%>]+)?%>/g; var match = re.exec(tpl); var re = /<%([^%>]+)?%>/g; var match = re.exec(tpl);
如果我們用console.log把變量match打印出來,我們會看見:
JavaScript
[ "<%name%>", " name ", index: 21, input: "Hello, my name is <%name%>. I"m <%age%> years old.
" ] [ "<%name%>", " name ", index: 21, input: "Hello, my name is <%name%>. I"m <%age%> years old.
" ]
不過我們可以看見,返回的數(shù)組僅僅包含第一個匹配項。我們需要用while循環(huán)把上述邏輯包起來,這樣才能得到所有的匹配項。
JavaScript
var re = /<%([^%>]+)?%>/g; while(match = re.exec(tpl)) { console.log(match); } var re = /<%([^%>]+)?%>/g; while(match = re.exec(tpl)) { console.log(match); }
如果把上面的代碼跑一遍,你就會看見<%name%> 和 <%age%>都被打印出來了。
下面,有意思的部分來了。識別出模板中的匹配項后,我們要把他們替換成傳遞給函數(shù)的實際數(shù)據(jù)。最簡單的辦法就是使用replace函數(shù)。我們可以像這樣來寫:
JavaScript
var TemplateEngine = function(tpl, data) { var re = /<%([^%>]+)?%>/g; while(match = re.exec(tpl)) { tpl = tpl.replace(match[0], data[match[1]]) } return tpl; } var TemplateEngine = function(tpl, data) { var re = /<%([^%>]+)?%>/g; while(match = re.exec(tpl)) { tpl = tpl.replace(match[0], data[match[1]]) } return tpl; }
好了,這樣就能跑了,但是還不夠好。這里我們以data[“property”]的方式使用了一個簡單對象來傳遞數(shù)據(jù),但是實際情況下我們很可能需要更復(fù)雜的嵌套對象。所以我們稍微修改了一下data對象:
JavaScript
{ name: "Krasimir Tsonev", profile: { age: 29 } } { name: "Krasimir Tsonev", profile: { age: 29 } }
不過直接這樣子寫的話還不能跑,因為在模板中使用<%profile.age%>的話,代碼會被替換成data[‘profile.age’],結(jié)果是undefined。這樣我們就不能簡單地用replace函數(shù),而是要用別的方法。如果能夠在<%和%>之間直接使用Javascript代碼就最好了,這樣就能對傳入的數(shù)據(jù)直接求值,像下面這樣:
JavaScript
var template = "Hello, my name is <%this.name%>. I"m <%this.profile.age%> years old.
"; var template = "Hello, my name is <%this.name%>. I"m <%this.profile.age%> years old.
";
你可能會好奇,這是怎么實現(xiàn)的?這里John使用了new Function的語法,根據(jù)字符串創(chuàng)建一個函數(shù)。我們不妨來看個例子:
JavaScript
var fn = new Function("arg", "console.log(arg + 1);"); fn(2); // outputs 3 var fn = new Function("arg", "console.log(arg + 1);"); fn(2); // outputs 3
fn可是一個貨真價實的函數(shù)。它接受一個參數(shù),函數(shù)體是console.log(arg + 1);。上述代碼等價于下面的代碼:
JavaScript
var fn = function(arg) { console.log(arg + 1); } fn(2); // outputs 3 var fn = function(arg) { console.log(arg + 1); } fn(2); // outputs 3
通過這種方法,我們可以根據(jù)字符串構(gòu)造函數(shù),包括它的參數(shù)和函數(shù)體。這不正是我們想要的嘛!不過先別急,在構(gòu)造函數(shù)之前,我們先來看看函數(shù)體是什么樣子的。按照之前的想法,這個模板引擎最終返回的應(yīng)該是一個編譯好的模板。還是用之前的模板字符串作為例子,那么返回的內(nèi)容應(yīng)該類似于:
JavaScript
return "Hello, my name is " + this.name + ". I"m " + this.profile.age + " years old.
"; return "Hello, my name is " + this.name + ". I"m " + this.profile.age + " years old.
";
當(dāng)然啦,實際的模板引擎中,我們會把模板切分為小段的文本和有意義的Javascript代碼。前面你可能看見我使用簡單的字符串拼接來達(dá)到想要的效果,不過這并不是100%符合我們要求的做法。由于使用者很可能會傳遞更加復(fù)雜的Javascript代碼,所以我們這兒需要再來一個循環(huán),如下:
JavaScript
var template = "My skills:" + "<%for(var index in this.skills) {%>" + "<%this.skills[index]%>" + "<%}%>"; var template = "My skills:" + "<%for(var index in this.skills) {%>" + "<%this.skills[index]%>" + "<%}%>";
如果使用字符串拼接的話,代碼就應(yīng)該是下面的樣子:
JavaScript
return "My skills:" + for(var index in this.skills) { + "" + this.skills[index] + "" + } return "My skills:" + for(var index in this.skills) { + "" + this.skills[index] + "" + }
當(dāng)然,這個代碼不能直接跑,跑了會出錯。于是我用了John的文章里寫的邏輯,把所有的字符串放在一個數(shù)組里,在程序的最后把它們拼接起來。
JavaScript
var r = []; r.push("My skills:"); for(var index in this.skills) { r.push(""); r.push(this.skills[index]); r.push(""); } return r.join(""); var r = []; r.push("My skills:"); for(var index in this.skills) { r.push(""); r.push(this.skills[index]); r.push(""); } return r.join("");
下一步就是收集模板里面不同的代碼行,用于生成函數(shù)。通過前面介紹的方法,我們可以知道模板中有哪些占位符(譯者注:或者說正則表達(dá)式的匹配項)以及它們的位置。所以,依靠一個輔助變量(cursor,游標(biāo)),我們就能得到想要的結(jié)果。
JavaScript
var TemplateEngine = function(tpl, data) { var re = /<%([^%>]+)?%>/g, code = "var r=[]; ", cursor = 0; var add = function(line) { code += "r.push("" + line.replace(/"/g, """) + ""); "; } while(match = re.exec(tpl)) { add(tpl.slice(cursor, match.index)); add(match[1]); cursor = match.index + match[0].length; } add(tpl.substr(cursor, tpl.length - cursor)); code += "return r.join("");"; // <-- return the result console.log(code); return tpl; } var template = "Hello, my name is <%this.name%>. I"m <%this.profile.age%> years old.
"; console.log(TemplateEngine(template, { name: "Krasimir Tsonev", profile: { age: 29 } })); var TemplateEngine = function(tpl, data) { var re = /<%([^%>]+)?%>/g, code = "var r=[]; ", cursor = 0; var add = function(line) { code += "r.push("" + line.replace(/"/g, """) + ""); "; } while(match = re.exec(tpl)) { add(tpl.slice(cursor, match.index)); add(match[1]); cursor = match.index + match[0].length; } add(tpl.substr(cursor, tpl.length - cursor)); code += "return r.join("");"; // <-- return the result console.log(code); return tpl; } var template = "Hello, my name is <%this.name%>. I"m <%this.profile.age%> years old.
"; console.log(TemplateEngine(template, { name: "Krasimir Tsonev", profile: { age: 29 } }));
上述代碼中的變量code保存了函數(shù)體。開頭的部分定義了一個數(shù)組。游標(biāo)cursor告訴我們當(dāng)前解析到了模板中的哪個位置。我們需要依靠它來遍歷整個模板字符串。此外還有個函數(shù)add,它負(fù)責(zé)把解析出來的代碼行添加到變量code中去。有一個地方需要特別注意,那就是需要把code包含的雙引號字符進(jìn)行轉(zhuǎn)義(escape)。否則生成的函數(shù)代碼會出錯。如果我們運行上面的代碼,我們會在控制臺里面看見如下的內(nèi)容:
JavaScript
var r=[]; r.push("Hello, my name is "); r.push("this.name"); r.push(". I"m "); r.push("this.profile.age"); return r.join(""); var r=[]; r.push("
Hello, my name is "); r.push("this.name"); r.push(". I"m "); r.push("this.profile.age"); return r.join("");
等等,貌似不太對啊,this.name和this.profile.age不應(yīng)該有引號啊,再來改改。
JavaScript
var add = function(line, js) { js? code += "r.push(" + line + "); " : code += "r.push("" + line.replace(/"/g, """) + ""); "; } while(match = re.exec(tpl)) { add(tpl.slice(cursor, match.index)); add(match[1], true); // <-- say that this is actually valid js cursor = match.index + match[0].length; } var add = function(line, js) { js? code += "r.push(" + line + "); " : code += "r.push("" + line.replace(/"/g, """) + ""); "; } while(match = re.exec(tpl)) { add(tpl.slice(cursor, match.index)); add(match[1], true); // <-- say that this is actually valid js cursor = match.index + match[0].length; }
占位符的內(nèi)容和一個布爾值一起作為參數(shù)傳給add函數(shù),用作區(qū)分。這樣就能生成我們想要的函數(shù)體了。
JavaScript
var r=[]; r.push("Hello, my name is "); r.push(this.name); r.push(". I"m "); r.push(this.profile.age); return r.join(""); var r=[]; r.push("
Hello, my name is "); r.push(this.name); r.push(". I"m "); r.push(this.profile.age); return r.join("");
剩下來要做的就是創(chuàng)建函數(shù)并且執(zhí)行它。因此,在模板引擎的最后,把原本返回模板字符串的語句替換成如下的內(nèi)容:
JavaScript
return new Function(code.replace(/[ ]/g, "")).apply(data); return new Function(code.replace(/[ ]/g, "")).apply(data);
我們甚至不需要顯式地傳參數(shù)給這個函數(shù)。我們使用apply方法來調(diào)用它。它會自動設(shè)定函數(shù)執(zhí)行的上下文。這就是為什么我們能在函數(shù)里面使用this.name。這里this指向data對象。
模板引擎接近完成了,不過還有一點,我們需要支持更多復(fù)雜的語句,比如條件判斷和循環(huán)。我們接著上面的例子繼續(xù)寫。
JavaScript
var template = "My skills:" + "<%for(var index in this.skills) {%>" + "<%this.skills[index]%>" + "<%}%>"; console.log(TemplateEngine(template, { skills: ["js", "html", "css"] })); var template = "My skills:" + "<%for(var index in this.skills) {%>" + "<%this.skills[index]%>" + "<%}%>"; console.log(TemplateEngine(template, { skills: ["js", "html", "css"] }));
這里會產(chǎn)生一個異常,Uncaught SyntaxError: Unexpected token for。如果我們調(diào)試一下,把code變量打印出來,我們就能發(fā)現(xiàn)問題所在。
JavaScript
var r=[]; r.push("My skills:"); r.push(for(var index in this.skills) {); r.push(""); r.push(this.skills[index]); r.push(""); r.push(}); r.push(""); return r.join(""); var r=[]; r.push("My skills:"); r.push(for(var index in this.skills) {); r.push(""); r.push(this.skills[index]); r.push(""); r.push(}); r.push(""); return r.join("");
帶有for循環(huán)的那一行不應(yīng)該被直接放到數(shù)組里面,而是應(yīng)該作為腳本的一部分直接運行。所以我們在把內(nèi)容添加到code變量之前還要多做一個判斷。
JavaScript
var re = /<%([^%>]+)?%>/g, reExp = /(^( )?(if|for|else|switch|case|break|{|}))(.*)?/g, code = "var r=[]; ", cursor = 0; var add = function(line, js) { js? code += line.match(reExp) ? line + " " : "r.push(" + line + "); " : code += "r.push("" + line.replace(/"/g, """) + ""); "; } var re = /<%([^%>]+)?%>/g, reExp = /(^( )?(if|for|else|switch|case|break|{|}))(.*)?/g, code = "var r=[]; ", cursor = 0; var add = function(line, js) { js? code += line.match(reExp) ? line + " " : "r.push(" + line + "); " : code += "r.push("" + line.replace(/"/g, """) + ""); "; }
這里我們新增加了一個正則表達(dá)式。它會判斷代碼中是否包含if、for、else等等關(guān)鍵字。如果有的話就直接添加到腳本代碼中去,否則就添加到數(shù)組中去。運行結(jié)果如下:
JavaScript
var r=[]; r.push("My skills:"); for(var index in this.skills) { r.push(""); r.push(this.skills[index]); r.push(""); } r.push(""); return r.join(""); var r=[]; r.push("My skills:"); for(var index in this.skills) { r.push(""); r.push(this.skills[index]); r.push(""); } r.push(""); return r.join("");
當(dāng)然,編譯出來的結(jié)果也是對的。
JavaScript
My skills:jshtmlcss My skills:jshtmlcss
最后一個改進(jìn)可以使我們的模板引擎更為強(qiáng)大。我們可以直接在模板中使用復(fù)雜邏輯,例如:
JavaScript
var template = "My skills:" + "<%if(this.showSkills) {%>" + "<%for(var index in this.skills) {%>" + "<%this.skills[index]%>" + "<%}%>" + "<%} else {%>" + "none
" + "<%}%>"; console.log(TemplateEngine(template, { skills: ["js", "html", "css"], showSkills: true })); var template = "My skills:" + "<%if(this.showSkills) {%>" + "<%for(var index in this.skills) {%>" + "<%this.skills[index]%>" + "<%}%>" + "<%} else {%>" + "none
" + "<%}%>"; console.log(TemplateEngine(template, { skills: ["js", "html", "css"], showSkills: true }));
除了上面說的改進(jìn),我還對代碼本身做了些優(yōu)化,最終版本如下:
JavaScript
var TemplateEngine = function(html, options) { var re = /<%([^%>]+)?%>/g, reExp = /(^( )?(if|for|else|switch|case|break|{|}))(.*)?/g, code = "var r=[]; ", cursor = 0; var add = function(line, js) { js? (code += line.match(reExp) ? line + " " : "r.push(" + line + "); ") : (code += line != "" ? "r.push("" + line.replace(/"/g, """) + ""); " : ""); return add; } while(match = re.exec(html)) { add(html.slice(cursor, match.index))(match[1], true); cursor = match.index + match[0].length; } add(html.substr(cursor, html.length - cursor)); code += "return r.join("");"; return new Function(code.replace(/[ ]/g, "")).apply(options); var TemplateEngine = function(html, options) { var re = /<%([^%>]+)?%>/g, reExp = /(^( )?(if|for|else|switch|case|break|{|}))(.*)?/g, code = "var r=[]; ", cursor = 0; var add = function(line, js) { js? (code += line.match(reExp) ? line + " " : "r.push(" + line + "); ") : (code += line != "" ? "r.push("" + line.replace(/"/g, """) + ""); " : ""); return add; } while(match = re.exec(html)) { add(html.slice(cursor, match.index))(match[1], true); cursor = match.index + match[0].length; } add(html.substr(cursor, html.length - cursor)); code += "return r.join("");"; return new Function(code.replace(/[ ]/g, "")).apply(options); }
代碼比我預(yù)想的還要少,只有區(qū)區(qū)15行!
這篇文章中所有涉及的源代碼都可以在這里找到
文章版權(quán)歸作者所有,未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址:http://specialneedsforspecialkids.com/yun/84349.html
摘要:置換型模板引擎的優(yōu)點實現(xiàn)簡單,缺點效率低,無法滿足高負(fù)載的應(yīng)用請求。用途百度詞條模板引擎可以讓網(wǎng)站程序?qū)崿F(xiàn)界面與數(shù)據(jù)分離,業(yè)務(wù)代碼與邏輯代碼的分離,提升開發(fā)效率,良好的設(shè)計也提高了代碼的復(fù)用性。前端模板的出現(xiàn)使得前后端分離成為可能。 模板引擎 模板引擎-百度詞條 什么是模板引擎?(百度詞條) 模板引擎(這里特指用于Web開發(fā)的模板引擎)是為了使用戶界面與業(yè)務(wù)數(shù)據(jù)分離而產(chǎn)生的,它可以生成...
摘要:原作者唐斌騰訊什么原名是一個簡單易用的前端模板預(yù)編譯工具。本文作者為來自騰訊團(tuán)隊的唐斌,他在本文中為我們分析了傳統(tǒng)前端模板內(nèi)嵌的弊端,如開發(fā)調(diào)試效率低下自動化構(gòu)建復(fù)雜度比較高等特點,并針對目前現(xiàn)狀給出了較好的解決方案。 原作者: 唐斌(騰訊)| TmodJS什么 TmodJS(原名atc)是一個簡單易用的前端模板預(yù)編譯工具。它通過預(yù)編譯技術(shù)讓前端模板突破瀏覽器限制,實現(xiàn)后端模板一樣的同...
摘要:前端模板的出現(xiàn)使得前后端分離成為可能??偨Y(jié)本文簡單介紹了模板引擎在前后端的使用,下文我們回到,重點分析下的使用方式以及源碼原理。樓主對于模板引擎的認(rèn)識比較淺顯,有不正之處希望指出感謝 前言 這篇文章本來不打算寫的,實話說樓主對前端模板的認(rèn)識還處在非常初級的階段,但是為了整個 源碼解讀系列 的完整性,在深入 Underscore _.template 方法源碼后,覺得還是有必要記下此文,...
摘要:使用方法編譯模板并根據(jù)所給的數(shù)據(jù)立即渲染出結(jié)果僅編譯模版暫不渲染,它會返回一個可重用的編譯后的函數(shù)根據(jù)給定的數(shù)據(jù),對之前編譯好的模板進(jìn)行數(shù)據(jù)渲染參考資料模板引擎概述 js模版引擎介紹 JavaScript 模板是將 HTML 結(jié)構(gòu)從包含它們的內(nèi)容中分離的方法。模板系統(tǒng)通常會引入一些新語法,但通常是非常簡單的,一個要注意的有趣的點是,替換標(biāo)記通常是由雙花括號({ {……} })表示,這也...
摘要:這是一個系列文章,將會介紹目前前端領(lǐng)域里用到的三種模板引擎技術(shù),它們分別是基于字符串的模板基于操作的模板基于虛擬的模板本文是這個系列的第一篇,著重介紹基于字符串的模板引擎的實現(xiàn)原理,分析它的優(yōu)點缺點以及使用的場景。 這是一個系列文章,將會介紹目前Web前端領(lǐng)域里用到的三種模板引擎技術(shù),它們分別是: 基于字符串的模板 基于Dom操作的模板 基于虛擬Dom的模板 本文是這個系列的第一篇...
摘要:大多數(shù)模板實現(xiàn)原理基本一致模板字符串首先通過各種手段剝離出普通字符串和模板語法字符串生成抽象語法樹然后針對模板語法片段進(jìn)行編譯,期間模板變量均去引擎輸入的變量中查找模板語法片段生成出普通片段,與原始普通字符串進(jìn)行拼接輸出。 前端模板的發(fā)展 模板可以說是前端開發(fā)最常接觸的工具之一。將頁面固定不變的內(nèi)容抽出成模板,服務(wù)端返回的動態(tài)數(shù)據(jù)裝填到模板中預(yù)留的坑位,最后組裝成完整的頁面html字符...
閱讀 3125·2021-11-15 18:14
閱讀 1779·2021-09-22 10:51
閱讀 3290·2021-09-09 09:34
閱讀 3509·2021-09-06 15:02
閱讀 1025·2021-09-01 11:40
閱讀 3193·2019-08-30 13:58
閱讀 2529·2019-08-30 11:04
閱讀 1086·2019-08-28 18:31