ejs教程

一、什么是EJS

EJS是一個JavaScript模板庫,用來從JSON數據中生成HTML字符串。

二、為什么要使用EJS

與最初的JavaScript相比較,一些不太了解你的代碼的人可以更容易地通過EJS模板代碼看得懂你的代碼。 讓我們放松一下,一起來享受下令人激動的干凈簡潔的感覺。
總之可以讓代碼更加干凈整潔,讓人易懂。
可以看如下的例子:
這是用javascript實現的代碼

var html = "<h1>"+data.title+"</h1>"
html += "<ul>"
for(var i=0; i<data.supplies.length; i++) {
    html += "<li><a href='supplies/"+data.supplies[i]+"'>"
    html += data.supplies[i]+"</a></li>"
}
html += "</ul>"

最終要實現的效果如下

但是上面的代碼看起來很亂,雖然實現了功能,但是不容易讓人弄懂。不僅代碼丑陋,而且你的HTML結構完全在JavaScript代碼中丟失。
下面學習EJS同樣實現上面的功效,它的工作原理如下:



使用EJS來找回你的明確、維護性良好的HTML代碼結構。
注:data是json對象,不能使json字符串。

在HTML中引入EJS,以使javascript能夠使用它,引入EJS的語句如下:

<script type ="text/javascript"  src="/js/ejs.js"></script>

創建一個EJS模板,命名為cleaning.ejs文件,內容如下:

<h1><%=title %></h1>
 <ul>
     
 <% for (var i=0; i<supplies.length; i++) { %>
         
<li> <a href= 'supplies/<%=supplies[i] %>' >
                 
<%= supplies[i] %></a>
         
 </li>
     
 <% } %>
 </ul>

我的HTML文檔如下,引入EJS,并更加我們的提供EJS模板創建EJS對象,然后調用EJS對象成員函數解析JSON對象到模板中。

<html >
 < head>
 <script type="text/javascript" src = "/js/ejs.js"></script>
 <script type ="text/javascript" >
   function myfunction(){
var data='{"title":"cleaning","supplies":["mop","broom","duster"]}'
     
var html = new EJS({url: '/js/tmpl/cleaning.ejs'}).render(JSON.parse(data));
     
//JSON.parse(data) 把JSON字符串解析為原生的javascript值。
     
 alert(html);
     
document.getElementById("div1").innerHTML=html;
 }
 </script >
 </ head >
 <body>
 <button  onclick = "myfunction()" >點擊</button>
 < div id = "div1" ></div >
 </body >
 < html >

從上面這個例子我們可以看到EJS模板的基本用法。

三、下面介紹下EJS的語法和功能:

1、緩存功能,能夠緩存已經解析好的html模版;
2、<% code %>用于執行其中javascript代碼。
<% alert('hello world') %>
3、<%= code %>會對code進行html轉義;

<h1><%=title %></h1>                    注:會把title里面存的值給顯示出來在h1中。
 <p><%= 
'hello world'
  %></p>             注:會把hello world顯示在h1中。
 <h1><%= 
'<b>hello world</b>'
  %></h1>    注:會把hello world變粗,然后顯示在h1中。
 <h1><%=title %></h1>                    注:會把title里面存的值給顯示出來在h1中。
 <p><%= 
 'hello world'
  %></p>             注:會把hello world顯示在h1中。
 <h1><%= 
 '<b>hello world</b>'
  %></h1>    注:會把hello world變粗,然后顯示在h1中。

4、<%- code %>將不會進行轉義;,這一行代碼不會執行,像是被注釋了一樣,然后顯示原來的html。也不會影響整個頁面的執行。

<h1><%-title %>asd</h1>          最后顯示asd,及顯示原網頁
 <p><%
# 'hello world' %>asd</p>   最后顯示asd,及顯示原網頁

5、支持自定義標簽,比如'<%'可以使用'{{','%>'用'}}'代替;
ejs 里,默認的閉合標記是 <% .. %>,我們也可以定義自己的標簽。例如:
app.set("view options",{ "open":"{{", "close":"}}"});
6、提供一些輔助函數,用于模版中使用
1)、first,返回數組的第一個元素;
2)、last,返回數組的最后一個元素;
3)、capitalize,返回首字母大寫的字符串;
4)、downcase,返回字符串的小寫;
5)、upcase,返回字符串的大寫;
6)、sort,排序(Object.create(obj).sort()?);
7)、sort_by:'prop',按照指定的prop屬性進行升序排序;
8)、size,返回長度,即length屬性,不一定非是數組才行;
9)、plus:n,加上n,將轉化為Number進行運算;
10)、minus:n,減去n,將轉化為Number進行運算;
11)、times:n,乘以n,將轉化為Number進行運算;
12)、divided_by:n,除以n,將轉化為Number進行運算;
13)、join:'val',將數組用'val'最為分隔符,進行合并成一個字符串;
14)、truncate:n,截取前n個字符,超過長度時,將返回一個副本
15)、truncate_words:n,取得字符串中的前n個word,word以空格進行分割;
16)、replace:pattern,substitution,字符串替換,substitution不提供將刪除匹配的子串;
17)、prepend:val,如果操作數為數組,則進行合并;為字符串則添加val在前面;
18)、append:val,如果操作數為數組,則進行合并;為字符串則添加val在后面;
19)、map:'prop',返回對象數組中屬性為prop的值組成的數組;
20)、reverse,翻轉數組或字符串;
21)、get:'prop',取得屬性為'prop'的值;
22)、json,轉化為json格式字符串

7、利用<%- include filename %>加載其他頁面模版;

四、使用創建好的EJS模板

基于我們之前寫的模擬生成一個EJS對象
new EJS({url: '/js/tmpl/cleaning.ejs'})
對象有下面兩個成員函數
1、ejs.compile(str, options); 將返回內部解析好的Function函數
2、ejs.render(str, options); 返回經過解析的字符串

ejs的render函數有兩個參數 第一個是字符串,第二個是可選的對象,和其他javascript模版一樣需要渲染的數據也是包含在option對象中的。

ejs.render(str,option);  
 // 渲染字符串 str 一般是通過nodejs文件系統的readfile方法讀取 
   
 ejs.render(str,{  
     
 data : user_data  
 // 需要渲染的數據 
   
  });

其中options的一些參數為:
1、cache:是否緩存解析后的模版,需要filename作為key;
2、filename:模版文件名;
3、scope:complile后的Function執行所在的上下文環境;
4、debug:標識是否是debeg狀態,debug為true則會輸出生成的Function內容;
5、compileDebug:標識是否是編譯debug,為true則會生成解析過程中的跟蹤信息,用于調試;
6、client,標識是否用于瀏覽器客戶端運行,為true則返回解析后的可以單獨運行的Function函數;
7、open,代碼開頭標記,默認為'<%';
8、close,代碼結束標記,默認為'%>';
9、其他的一些用于解析模版時提供的變量。 在express中使用時,options參數將由response.render進行傳入,其中包含了一些express中的設置,以及用戶提供的變量值。

五、最后總結一下EJS的應用場所

用JavaScript創建HTML字符串 正如我們在新手教程中所討論的,在JavaScript中拼字符串的缺點是可維護性不好。當你在JavaScript中將這些字符串拼到一起時,很難看出你正在寫的HTML是什么---|一個你頁面展現的結構。而使用模板可以讓你通過代碼的空行和縮進來清楚地展現出你的HTML。

基于WebService的AJAX網站開發 EJS可以接收WebService異步傳送過來的JSON格式的數據,將這種數據直接傳入你的模板里,然后將結果插入到你的頁面中。你所需要做的只是通過以下代碼:

  1. new
 EJS({url: 
'comments.ejs'
}).update(
'element_id'
, 
'/comments.json'
)
  1. 程序換膚功能
    如果你想給用戶自制頁面顯示的功能,EJS提供了非常適合的機制。EJS的模板只在瀏覽器里執行,因此對你的服務器沒有任何安全風險。你可以允許你的用戶上傳EJS模板以及其關聯的樣式表,從而實現定制你的網站頁面的功能。
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,578評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,701評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,691評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,974評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,694評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,026評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,015評論 3 450
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,193評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,719評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,442評論 3 360
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,668評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,151評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,846評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,255評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,592評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,394評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,635評論 2 380

推薦閱讀更多精彩內容