nodejs模板引擎的制作方法

這篇文章主要介紹了nodejs模板引擎的制作方法，具有一定借鑒價值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

關于模板，我倒是用過了不少。最開始要數Java的JSP了，然后接觸了PHP的smarty，再就是Python的jinja2, Django內置模板，現在剛開始看Nodejs，也發現了不少類似的模板引擎，ejs, jade等等吧。

模板帶來的最直接的好處就是加速開發，前后端分離。除此之外，對于字符串的格式化同樣是個比較好的應用。習慣了python中

string = "hello {}".format("郭璞") # hello 郭璞
string = "hello {username}".format(username="郭璞") # hello 郭璞

這樣簡便的用法，突然來到nodejs中，沒有了這類特性的原生支持，寫起來打印語句就老是覺得很別扭，一點都不優雅。然后我就想自己做一個實現上述功能的工具函數，方便自己的使用。然后就想到了模板這一個方向，雖然想法還不夠成熟，甚至是有點拙略，但是“靈（瞎）感（鬧）”還是得記錄一下不是。

Function對象

JavaScript中有這么一個神奇的對象，那就是Function。如果函數體符合語法要求，那么你就可以動態創建出一個自己的函數出來。下面來個簡單的小例子。

無參模式

function create_function(){
  var func_body = "var time = new Date(); console.log('創建時間：'+time);";
  var func = new Function('', func_body);
  func();
}
create_function();

運行結果如下：

E:\Code\Nodejs\learn\my-work\string>node one.js
創建時間：Tue Jun 13 2017 15:40:15 GMT+0800 (中國標準時間)

E:\Code\Nodejs\learn\my-work\string>

有參模式

剛才演示了一個無參數的情況，那么有參數的情況如何呢？

function create_function_with_parameters() {
  var param1 = "郭璞";
  var param2 = "遼寧大連";
  var func_body = "console.log('Hello '+param1+', welcome to '+param2+'!' );";
  var func = new Function('param1', 'param2', func_body);
  func(param1, param2);
}
create_function_with_parameters();

同樣的運行結果如下：

E:\Code\Nodejs\learn\my-work\string>node one.js
Hello 郭璞, welcome to 遼寧大連!

E:\Code\Nodejs\learn\my-work\string>

到這里，關于Function的內容就算是鋪墊完成了。只需要了解這

正則

探究模板的真實原理，有些語言中是編譯型的，有些是替換型的。但是不管是哪種類型，都離不開扣出變量關鍵字這個步驟。而這個過程用正則表達式基本上是最好的方法了。所以需要掌握一點相關的技巧。

如何表達？

在Nodejs中，使用正則表達式有兩種形式：

1. 字面量： /pattern/flags

2. RegExp: new RegExp(pattern, flags)

關于正則表達式的具體的規則，鑒于篇幅很長，這里就不再贅述了。有興趣的可以瀏覽下面的這篇文章。
https://www.jb51.net/article/39623.htm?source=1

需求獲取

根據一開始的設想，目標是獲取{{}} 和{%%} 這種語法下的變量名稱，然后替換成對應的變量值。 因此可以寫出如下的正則表達式：

var pattern1 = /{{([\s\S]+?)}}/gi;
// 或者
var pattern2 = /{%([\s\S]+?)%}/gi;

默認規則如下：

1. 在{{}} 中直接替換為變量名對應的值。

2. 在{%%} 中的則是可以添加到函數體的代碼塊，要保留起來。

簡易實現

下面簡單的對照著實現一下。

直接變量形式

function test1(){
  var tpl = "Hello {{visitorname}}, Welcome to {{worldname}}!";
  var data = {
    visitorname: "游客",
    worldname: "冰雹工作室"
  };
  var pattern = /{{([\s\S]+?)}}/gi;
  var result = tpl.replace(pattern, (match, tuple)=>{
    return data[tuple];
  });

  console.log("渲染后的數據為：\n", result);
}

實現結果：

E:\Code\Nodejs\learn\my-work\string>node one.js
渲染后的數據為：
 Hello 游客, Welcome to 冰雹工作室!

E:\Code\Nodejs\learn\my-work\string>

對象形式

function test2(){
  var tpl = "I'm {{user.name}}, and I come from {{user.address}}";
  var user = {name: "郭璞", address: "遼寧大連"};
  console.log(user.name);
  var pattern = /{{([\s\S]+?)}}/gi;
  var result = tpl.replace(pattern, function(match, tuple, offset){
    return eval(''+tuple);
  });
  console.log(result);

}

運行效果：

E:\Code\Nodejs\learn\my-work\string>node one.js
郭璞
I'm 郭璞, and I come from 遼寧大連

E:\Code\Nodejs\learn\my-work\string>

混雜多參數實現

剛才實現了只有關鍵字的和有對象性質的參數的例子，但是實際中情況可能比這要復雜的多，比如混雜模式。接下來著手實現一下混雜模式下的替換策略。

function test3(){
  var tpl = "I am {} of {} years old, and I come from {user.address}.";
  var name = '郭璞';
  var index = 0;
  var paramindex = 0;
  // var parameters = [{name: '郭璞'}, {'age': 22}, {address: '遼寧大連'}];
  var parameters = ['郭璞', 22, {user: {address: '遼寧大連'}}];
  console.log(parameters[2]);
  var result = tpl.replace(/{([\s\S])*?}/gi, function(match, tuple, offset){
    console.log('match:', match);
    console.log('tuple: ', tuple);
    tpl = tpl.slice(index, offset);
    index = offset + match.length;
    paramindex += 1;

    var temp = parameters[paramindex-1];
    if(match.length > 2){
      // 使用tuple不能正確獲取到標記中相關的變量名，故用match來代替.
      match = match.slice(1, match.length-1);
      return eval('parameters[paramindex-1].'+match);
    }else{
      return temp;
    }
    // return parameters[paramindex-1];
  });
  console.log(result);
}

運行結果如下：

E:\Code\Nodejs\learn\my-work\string>node one.js
{ user: { address: '遼寧大連' } }
match: {}
tuple: undefined
match: {}
tuple: undefined
match: {user.address}
tuple: s
******* s
I am 郭璞 of 22 years old, and I come from 遼寧大連.

E:\Code\Nodejs\learn\my-work\string>

關于正則這塊，大致的內容就是這樣了。如果要想更簡單的調用，只需要封裝起來，用外部參數代替就好了。

當然，注意變量名的命名風格。

實戰

廢話連篇說了兩個小節，還沒到正式的模板制作。下面就整合一下剛才例子。模擬著實現一下好了。

(!完整)代碼

來個不完整的代碼，示意一下算了。

/**
 * 通過正則表達式和Function語法創建一個簡單的模板引擎。
 */

const pattern = /{{([\s\S]+?)}}|{%([\s\S]+?)%}|$/img;

function template(text, params, name) {
  // 聲明最終要返回的解析好的文本串,也就是構造Function所需的函數體部分。
  var func_body = '';
  // 函數體里面最終效果是返回一個代表了解析完成的字符串的變量，因此要聲明一個出來
  func_body += 'var parsedstr="";';
  func_body += 'parsedstr+="';
  // 設置一個定位器，每次更新偏移量，進行全文替換工作
  var index = 0;
  // 開始正則匹配，根據捕獲到的元組進行剖析
  text.replace(pattern, function (matchedtext, interpolate, evaluate, offset) {
    // 匹配到正常的HTML文本，則直接添加到func_body中即可
    func_body += text.slice(index, offset);

    // 如果是evaluate類型的文本，則作為代碼進行拼接
    if (evaluate) {
      func_body += '";' + evaluate + 'parsedstr+="';
    }

    // 匹配到interpolate類型的文本，則作為變量值進行替換
    if (interpolate) {
      func_body += '"+' + interpolate + '+"';
    }

    // 更新偏移量index，讓程序向后移動
    index = offset + matchedtext.length;
    // 貌似返回值沒什么用吧
    return matchedtext;
  });

  // 完成函數體的構建之后就可以調用Function的語法實現渲染函數的構建了
  func_body += '"; return parsedstr;';

  return new Function('obj', 'name', func_body)(params, name);
}

function test() {
  var obj = [
    { text: '張三' },
    { text: '李四' },
    { text: '王五' },
    { text: '趙六' },
    { text: '韓七' },
    { text: '王八' }
  ];
  var name = '郭璞';


  var fs = require('fs');
  // var rawtext = fs.readFileSync('index.html').toString('utf8');
  var rawtext = '<ul>{%for(var i in obj){%}<li>{{ obj[i].text }}</li><br>{%}%}</ul>';
  console.log("源文件：", rawtext);
  var result = template(rawtext, obj);
  console.log("渲染后文件：", result, name);
  fs.writeFileSync('rendered.html', result);
  console.log('渲染完畢，請查看rendered.html文件')
}

test();

同級目錄下生成的文件內容為：

<ul>
  <li>張三</li><br>
  <li>李四</li><br>
  <li>王五</li><br>
  <li>趙六</li><br>
  <li>韓七</li><br>
  <li>王八</li><br></ul>

感覺效果還行，但是這里面參數太固定化了，實際封裝的時候還需要酌情指定，不然這東西也就沒什么卵用。

感謝你能夠認真閱讀完這篇文章，希望小編分享的“nodejs模板引擎的制作方法”這篇文章對大家有幫助，同時也希望大家多多支持億速云，關注億速云行業資訊頻道，更多相關知識等著你來學習!