基于JavaScript寫一款EJS模板引擎

更新時間：2022年02月14日 10:15:09 作者：隱冬

這篇文章主要介紹了基于JavaScript寫一款EJS模板引擎，基本語法就是定義render函數(shù)，接收html字符串，和data參數(shù)，下面其他具體介紹，需要的朋友可以參考一下

1. 起因

部門最近的一次分享中，有人提出來要實現(xiàn)一個ejs模板引擎，突然發(fā)現(xiàn)之前似乎從來都沒有考慮過這個問題，一直都是直接拿過來用的。那就動手實現(xiàn)一下吧。本文主要介紹ejs的簡單使用，并非全部實現(xiàn)，其中涉及到options配置的部分直接省略了。如有不對請指出，最后歡迎點贊 + 收藏。

2. 基本語法實現(xiàn)

定義render函數(shù)，接收html字符串，和data參數(shù)。

const render = (ejs = '', data = {}) => {

}

事例模板字符串如下:

<body>
? ? <div><%= name %></div>
? ? <div><%= age %></div>
</body>

可以使用正則將<%= name %>匹配出來，只保留name。這里借助ES6的模板字符串。將name用${}包裹起來。

props中第2個值就是匹配到的變量。直接props[1]替換。

[
? '<%= name %>',
? ' name ',
? 16,
? '<body>\n ? ?<div><%= name %></div>\n ? ?<div><%= age %></div>\n</body>'
]

const render = (ejs = '', data = {}) => {
? ? const html = ejs.replace(/<%=(.*?)%>/g, (...props) => {
? ? ? ? return '${' + props[1] + '}';
? ? ? ? // return data[props[1].trim()];
? ? });
}

3. Function函數(shù)

這里得到的html是一個模板字符串?？梢酝ㄟ^Function將字符串編程可執(zhí)行的函數(shù)。當然這里也可以使用eval，隨你。

<body>
? ? <div>${ name }</div>
? ? <div>${ age }</div>
</body>

Function是一個構造函數(shù)，實例化后返回一個真正的函數(shù)，構造函數(shù)的最后一個參數(shù)是函數(shù)體的字符串，前面的參數(shù)都為形式參數(shù)。比如這里傳入形參name，函數(shù)體通過console.log打印一句話。

const func = new Function('name', 'console.log("我是通過Function構建的函數(shù)，我叫：" + name)');
// 執(zhí)行函數(shù)，傳入?yún)?shù)
func('yindong'); // 我是通過Function構建的函數(shù)，我叫：yindong

利用Function的能力可以將html模板字符串執(zhí)行返回。函數(shù)字符串編寫return，返回一個拼裝好的模板字符串、

const getHtml = (html, data) => {
? ? const func = new Function('data', `return \`${html}\`;`);
? ? return func(data);
? ? // return eval(`((data) => { ?return \`${html}\`; })(data)`)
}

const render = (ejs = '', data = {}) => {
? ? const html = ejs.replace(/<%=(.*?)%>/g, (...props) => {
? ? ? ? return '${' + props[1] + '}';
? ? });
? ? return getHtml(html, data);
}

4 with

這里render函數(shù)中props[1]的實際上是變量名稱，也就是name和age，可以替換成data[props[1].trim()]，不過這樣寫會有一些問題，偷個懶利用with代碼塊的特性。

with語句用于擴展一個語句的作用域鏈。換句人話來說就是在with語句中使用的變量都會先在with中尋找，找不到才會向上尋找。

比如這里定義一個age數(shù)字和data對象，data中包含一個name字符串。with包裹的代碼塊中輸出的name會先在data中尋找，age在data中并不存在，則會向上尋找。當然這個特性也是一個with不推薦使用的原因，因為不確定with語句中出現(xiàn)的變量是否是data中。

const age = 18;
const data = {
? ? name: 'yindong'
}

with(data) {
? ? console.log(name);
? ? console.log(age);
}

這里使用with改造一下getHtml函數(shù)。函數(shù)體用with包裹起來，data就是傳入的參數(shù)data，這樣with體中的所有使用的變量都從data中查找了。

const getHtml = (html, data) => {
? ? const func = new Function('data', `with(data) { return \`${html}\`; }`);
? ? return func(data);
? ? // return eval(`((data) => { with(data) { return \`${html}\`; } })(data)`)
}

const render = (ejs = '', data = {}) => {
? ? // 優(yōu)化一下代碼，直接用$1替代props[1];
? ? // const html = ejs.replace(/<%=(.*?)%>/g, (...props) => {
? ? // ? ? return '${' + props[1] + '}';
? ? // });
? ? const html = ejs.replace(/<%=(.*?)%>/gi, '${$1}');
? ? return getHtml(html, data);
}

這樣就可以打印出真是的html了。

<body>
? ? <div>yindong</div>
? ? <div>18</div>
</body>

5. ejs語句

這里擴展一下ejs，加上一個arr.join語句。

<body>
? ? <div><%= name %></div>
? ? <div><%= age %></div>
? ? <div><%= arr.join('--') %></div>
</body>

const data = {
? ? name: "yindong",
? ? age: 18,
? ? arr: [1, 2, 3, 4]
}

const html = fs.readFileSync('./html.ejs', 'utf-8');

const getHtml = (html, data) => {
? ? const func = new Function('data', ` with(data) { return \`${html}\`; }`);
? ? return func(data);
}

const render = (ejs = '', data = {}) => {
? ? const html = html = ejs.replace(/<%=(.*?)%>/gi, '${$1}');
? ? return getHtml(html, data);
}

const result = render(html, data);

console.log(result);

可以發(fā)現(xiàn)ejs也是可以正常編譯的。因為模板字符串支持arr.join語法，輸出：

<body>
? ? <div>yindong</div>
? ? <div>18</div>
? ? <div>1--2--3--4</div>
</body>

如果ejs中包含forEach語句，就比較復雜了。此時render函數(shù)就無法正常解析。

<body>
? ? <div><%= name %></div>
? ? <div><%= age %></div>
? ? <% arr.forEach((item) => {%>
? ? ? ? <div><%= item %></div>
? ? <%})%>
</body>

這里分兩步來處理。仔細觀察可以發(fā)現(xiàn)，使用變量值得方式存在=號，而語句是沒有=號的?？梢詫js字符串進行第一步處理，將<%=變量替換成對應的變量，也就是原本的render函數(shù)代碼不變。

const render = (ejs = '', data = {}) => {
? ? const html = ejs.replace(/<%=(.*?)%>/gi, '${$1}');
? ? console.log(html);
}

<body>
? ? <div>${ name }</div>
? ? <div>${ age }</div>
? ? <% arr.forEach((item) => {%>
? ? ? ? <div>${ item }</div>
? ? <%})%>
</body>

第二步比較繞一點，可以將上面的字符串處理成多個字符串拼接。簡單舉例，將a加上arr.forEach的結果再加上c轉換為，str存儲a，再拼接arr.forEach每項結果，再拼接c。這樣就可以獲得正確的字符串了。

// 原始字符串
retrun `
? ? a
? ? <% arr.forEach((item) => {%>
? ? ? ? item
? ? <%})%>
? ? c
`
// 拼接后的
let str;
str = `a`;

arr.forEach((item) => {
? ? str += item;
});

str += c;

return str;

在第一步的結果上使用/<%(.*?)%>/g正則匹配出<%%>中間的內容，也就是第二步。

const render = (ejs = '', data = {}) => {
? ? // 第一步
? ? let html = ejs.replace(/<%=(.*?)%>/gi, '${$1}');
? ? // 第二步
? ? html = html.replace(/<%(.*?)%>/g, (...props) => {
? ? ? ? return '`\r\n' + props[1] + '\r\n str += `';
? ? });
? ? console.log(html);
}

替換后得到的字符串長成這個樣子。

<body>
? ? <div>${ name }</div>
? ? <div>${ age }</div>
? ? `
?arr.forEach((item) => {
?str += `
? ? ? ? <div>${ item }</div>
? ? `
})
?str += `
</body>

添加換行會更容易看一些?？梢园l(fā)現(xiàn)，第一部分是缺少首部`的字符串，第二部分是用str存儲了forEach循環(huán)內容的完整js部分，并且可執(zhí)行。第三部分是缺少尾部`的字符串。

<body>
? ? <div>${ name }</div>
? ? <div>${ age }</div>
? ? `

// 第二部分
?arr.forEach((item) => {
?str += `
? ? ? ? <div>${ item }</div>
? ? `
})

// 第三部分
?str += `
</body>

處理一下將字符串補齊，在第一部分添加let str = `，這樣就是一個完整的字串了，第二部分不需要處理，會再第一部分基礎上拼接上第二部分的執(zhí)行結果，第三部分需要在結尾出拼接`; return str; 也就是補齊尾部的模板字符串，并且通過return返回str完整字符串。

// 第一部分

let str = `<body>
? ? <div>${ name }</div>
? ? <div>${ age }</div>
? ? `

// 第二部分
?arr.forEach((item) => {
?str += `
? ? ? ? <div>${ item }</div>
? ? `
})

// 第三部分
?str += `
</body>
`;

return str;

這部分邏輯可以在getHtml函數(shù)中添加，首先在with中定義str用于存儲第一部分的字符串，尾部通過return返回str字符串。

const getHtml = (html, data) => {
? ? const func = new Function('data', ` with(data) { let str = \`${html}\`; return str; }`);
? ? return func(data);
}

這樣就可以實現(xiàn)執(zhí)行ejs語句了。

const data = {
? ? name: "yindong",
? ? age: 18,
? ? arr: [1, 2, 3, 4],
? ? html: '<div>html</div>',
? ? escape: '<div>escape</div>'
}

const html = fs.readFileSync('./html.ejs', 'utf-8');

const getHtml = (html, data) => {
? ? const func = new Function('data', ` with(data) { var str = \`${html}\`; return str; }`);
? ? return func(data);
}

const render = (ejs = '', data = {}) => {
? ? // 替換所有變量
? ? let html = ejs.replace(/<%=(.*?)%>/gi, '${$1}');
? ? // 拼接字符串
? ? html = html.replace(/<%(.*?)%>/g, (...props) => {
? ? ? ? return '`\r\n' + props[1] + '\r\n str += `';
? ? });
? ? return getHtml(html, data);
}

const result = render(html, data);

console.log(result);

輸出結果:

<body>
<div>yindong</div>
<div>18</div>

<div>1</div>

<div>2</div>

<div>3</div>

<div>4</div>

</body>

6. 標簽轉義

<%=會對傳入的html進行轉義，這里編寫一個escapeHTML轉義函數(shù)。

const escapeHTML = (str) => {
? ? if (typeof str === 'string') {
? ? ? ? return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/ /g, "&nbsp;").replace(/"/g, "&#34;").replace(/'/g, "&#39;");
? ? } else {
? ? ? ? return str;
? ? }
}

變量替換的時候使用escapeHTML函數(shù)處理變量。這里通過\s*去掉空格。為了避免命名沖突，這里將escapeHTML改造成自執(zhí)行函數(shù)，函數(shù)參數(shù)為$1變量名。

const render = (ejs = '', data = {}) => {
? ? // 替換轉移變量
? ? // let html = ejs.replace(/<%=\s*(.*?)\s*%>/gi, '${escapeHTML($1)}');
? ? let html = ejs.replace(/<%=\s*(.*?)\s*%>/gi, `\${
? ? ? ? ((str) => {
? ? ? ? ? ? if (typeof str === 'string') {
? ? ? ? ? ? ? ? return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/ /g, "&nbsp;").replace(/"/g, "&#34;").replace(/'/g, "&#39;");
? ? ? ? ? ? } else {
? ? ? ? ? ? ? ? return str;
? ? ? ? ? ? }
? ? ? ? })($1)
? ? }`);
? ? // 拼接字符串
? ? html = html.replace(/<%(.*?)%>/g, (...props) => {
? ? ? ? return '`\r\n' + props[1] + '\r\n str += `';
? ? });
? ? return getHtml(html, data);
}

getHtml函數(shù)不變。

const getHtml = (html, data) => {
? ? const func = new Function('data', `with(data) { var str = \`${html}\`; return str; }`);
? ? return func(data);
}

<%-會保留原本格式輸出，只需要再加一條不使用escapeHTML函數(shù)處理的就可以了。

const render = (ejs = '', data = {}) => {
? ? // 替換轉義變量
? ? let html = ejs.replace(/<%=\s*(.*?)\s*%>/gi, '${escapeHTML($1)}');
? ? // 替換其余變量
? ? html = html.replace(/<%-(.*?)%>/gi, '${$1}');
? ? // 拼接字符串
? ? html = html.replace(/<%(.*?)%>/g, (...props) => {
? ? ? ? return '`\r\n' + props[1] + '\r\n str += `';
? ? });
? ? return getHtml(html, data, escapeHTML);
}

輸出樣式:

<body>
<div>yindong</div>
<div>18</div>

<div>1</div>

<div>2</div>

<div>3</div>

<div>4</div>

<div><div>escapeHTML</div></div>
</body>

至此一個簡單的ejs模板解釋器就寫完了。

到此這篇關于基于JavaScript寫一款EJS模板引擎的文章就介紹到這了,更多相關寫一款EJS模板引擎內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

javascript實現(xiàn)圖片輪播簡單效果
這篇文章主要為大家詳細介紹了javascript實現(xiàn)圖片輪播簡單效果，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2022-07-07
JavaScript 繼承封裝多態(tài)實現(xiàn)及原理詳解
這篇文章主要介紹了JavaScript 繼承封裝多態(tài)實現(xiàn)及原理詳解,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下
2019-07-07
JavaScript 中 avalon綁定屬性總結
avalon是前端MVVM框架，在js中經(jīng)常會用到。這篇文章主要介紹了JavaScript 中 avalon綁定屬性總結的相關資料,需要的朋友可以參考下
2016-10-10
一起來了解一下JavaScript的預編譯(小結)
這篇文章主要介紹了一起來了解一下JavaScript的預編譯(小結)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2021-03-03
JavaScript避免代碼的重復執(zhí)行經(jīng)驗技巧分享
經(jīng)常會發(fā)現(xiàn)一個問題，那就是重復的代碼執(zhí)行，下面就是一些在查看它們的源代碼時發(fā)現(xiàn)一些問題，把這些分享給大家，希望能讓你們更加簡潔高效的寫出JavaScript代碼
2014-04-04
js+html5繪制圖片到canvas的方法
這篇文章主要介紹了js+html5繪制圖片到canvas的方法,涉及html5元素操作的相關技巧,需要的朋友可以參考下
2015-06-06
在頁面中js獲取光標/鼠標的坐標及光標的像素坐標
頁面JS光標/鼠標坐標，百度統(tǒng)計中有個熱點統(tǒng)計圖，我們要做的就是獲取光標的像素坐標
2013-11-11
微信小程序的開發(fā)范式BeautyWe.js入門詳解
這篇文章主要介紹了微信小程序的開發(fā)范式BeautyWe.js詳解，它是一套專注于微信小程序的企業(yè)級開發(fā)范式，它的愿景是：讓企業(yè)級的微信小程序項目中的代碼，更加簡單、漂亮,需要的朋友可以參考下
2019-07-07
詳解Bootstrap按鈕
本文給大家介紹bootstrap按鈕相關知識，包括按鈕大小、按鈕狀態(tài)、按鈕標簽相關樣式定義，對bootstrap按鈕相關知識感興趣的朋友一起學習吧
2016-01-01
JavaScript+HTML5實現(xiàn)的日期比較功能示例
這篇文章主要介紹了JavaScript+HTML5實現(xiàn)的日期比較功能,涉及javascript結合HTML5針對日期的轉換與運算相關操作技巧,需要的朋友可以參考下
2017-07-07