koa2 從入門到進階之路 (四)


之前的文章我們介紹了一下 koa 中間件 以及 koa 中間件的洋蔥圖執行流程,本篇文章我們來看一下 koa 中使用 ejs 模板及頁面渲染。

在 Express 中,我們經常會用 ejs 模板來渲染前端頁面,在 koa 中同樣可以使用 ejs 模板引擎,關於 ejs 模板引擎的用法這里就不做過多說明了,https://ejs.bootcss.com/,這是官網,為我們做了詳細的教程。

在 koa 中使用 ejs 我們需要安裝 koa-views 和 ejs 兩個模塊:

安裝 koa-views npm installkoa-views --save  / cnpm install koa-views --save

安裝 ejs npm install ejs --save / cnpm install ejs --save

然后就可以在我們的項目中配置和使用了,我們在之前的項目中將 app.js 改為如下:

 1 //引入 koa模塊
 2 const Koa = require('koa');
 3 const Router = require('koa-router');
 4 const views = require('koa-views');
 5 
 6 //實例化
 7 const app = new Koa();
 8 const router = new Router();
 9 
10 //配置模板引擎中間件
11 
12 // 模板的后綴名是.html
13 // app.use(views('views', {
14 //     map: {html: 'ejs'}
15 // }));
16 // 模板的后綴名是.html
17 app.use(views('views', {
18     extension: 'ejs'
19 }));
20 
21 //寫一個中間件配置公共的信息
22 app.use(async (ctx, next) => {
23     ctx.state.commonData = "這是一個公有數據,每個頁面都能引用";
24     // 繼續向下匹配路由
25     await next();
26 });
27 
28 router.get('/', async (ctx) => {
29     let title = "hello world";
30     let list = ["aaa", "bbb", "ccc"];
31 
32     await ctx.render('index', {
33         title,
34         list,
35     });
36 });
37 
38 router.get('/news', async (ctx) => {
39     await ctx.render('news', {});
40 });
41 
42 //啟動路由
43 app.use(router.routes());
44 app.use(router.allowedMethods());
45 
46 app.listen(3000);

首先在模塊中引入 koa-views;然后我們用中間件 app.use("views",{ }) 的形式引入 ejs 模板引擎,其中注釋掉的為第一種,是以 .html 結尾,第二種是以 .ejs 結尾。

"views" 是我們要指定的目錄,我們寫成 "views",就需要在項目目錄中創建一個 views 目錄來存放我們的 ejs 文件。  

之后我們寫了一個應用級中間件來存放一個共有的數據,這個中間件可以去上一篇文章看一下具體作用,這里不過多解釋。

然后我們在 router.get("/", ) 路由中存放了兩條數據,一條字符串,一條數組。

我們不再使用 stx.body="" 的方式向前端輸出內容,而是使用 ctx.render("index",{ }) 形式向前端輸出內容,其中 "idenx" 為我們在 "views" 目錄中定義的 index.ejs 的文件名稱,{ } 內為我們要傳入的數據。

剩下的內容就和我們之前項目的一樣即可,我們再來看一下現在的項目目錄:

如果我們在 views 目錄中定義的以 .html 結尾,將上面代碼的 html 注釋解開,將 ejs 注釋掉即可。

然后我們來看一下 index.ejs 中的代碼:

 1 <!DOCTYPE html>
 2 <html lang="en">
 3 <head>
 4     <meta charset="UTF-8">
 5     <title></title>
 6 </head>
 7 <body>
 8     <% include blocks/header.ejs %>
 9     <p><%= commenData %></p>
10     <p><%= title %></p>
11     <ul>
12         <% for(var i = 0;i < list.length;i++){ %>
13             <li><%= list[i] %></li>
14         <% } %>
15     </ul>
16 </body>
17 </html>

news.ejs 

 1 <!DOCTYPE html>
 2 <html lang="en">
 3 <head>
 4     <meta charset="UTF-8">
 5     <title></title>
 6 </head>
 7 <body>
 8 <% include blocks/header.ejs %>
 9 <h2><%= commonData %></h2>
10 </body>
11 </html>

blocks/header.ejs

<h1>這是一個頭部的模塊</h1>

關於 ejs 文件內的運算符號 <%%> 在這里就不做過多解釋了,大家可以去 ejs 官網學習,不是很難。

最終結果如下:

 

 

可以看出我們的 ejs 模板引擎運行的沒有問題,數據也都正常顯示在了頁面中。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM