Express.js 中 EJS 模板引擎使用方式及注意事项

阅读时长 5 分钟读完

前言

Express.js 是一个用于 Node.js 应用程序开发的灵活且强大的Web应用程序框架。而在 Express.js 中,EJS(Embedded JavaScript templates)模板引擎也是非常流行的前端技术之一。本文将详细介绍在 Express.js 中使用 EJS 模板引擎的使用方式和注意事项。

EJS 模板引擎介绍

在 Node.js 中,模板引擎是将数据和模板相结合,生成最终 HTML 文本的一种工具。而 EJS 是一种完全由 JavaScript 实现的模板引擎,它允许嵌入变量和逻辑代码,并通过动态生成 HTML 文本来渲染模板。

EJS 的主要特点如下:

  • 逻辑表现力强:支持条件判断、循环语句等。
  • 动态数据显示:可以根据不同的数据生成不同的 HTML 文本。
  • 扩展性强:可以使用扩展来添加自定义标记、过滤器等功能。

使用方式

要在 Express.js 中使用 EJS 模板引擎,需要进行如下步骤:

1. 安装 EJS 模板引擎

使用 npm 命令行工具安装 EJS 模板引擎:

2. 配置 Express.js

在 Express.js 中,使用 EJS 作为模板引擎需要进行相应的配置。在 Express.js 中,可以选择以下两种方式进行配置:

  • 使用内置的 app.engine 方法。
  • 使用 express-ejs-layouts 中间件。

下面分别介绍这两种方式的具体实现方法。

使用内置的 app.engine 方法

使用这种方式需要调用 app.engine 方法,并将 EJS 模板引擎设置为应用程序的默认引擎。

-- -------------------- ---- -------
----- ------- - -------------------
----- --- - ----------
----- --- - ---------------

------------------ ---------------- -- - ----- ----- --- ----
---------------- ----------- -- --------
------------- -------- -------- -- ------- ----

---------------- ---------- -
  -------------------- -------- ------------------------
---

使用 express-ejs-layouts 中间件

这种方式需要借助 express-ejs-layouts 插件,它是一种可以扩展 EJS 模板引擎的中间件,它包含了模板布局的功能,可以实现类似于模板继承的效果。

-- -------------------- ---- -------
----- ------- - -------------------
----- --- - ----------
----- ---------- - -------------------------------

--------------------
---------------- ----------- -- --------
------------- -------- ------- -- ------- ---

---------------- ---------- -
  -------------------- -------- ------------------------
---

3. 创建 EJS 模板文件

创建一个 EJS 模板文件,例如 index.ejs,并存放于 views 目录下。

-- -------------------- ---- -------
--------- -----
----- ----------
------
  ----- ----------------
  ---------- ----- ----------
-------
------
  ------- ------- -------
-------
-------

在上面的代码中,可以看到使用 <%= ... %> 来嵌入变量。<%= ... %> 中的变量会被动态渲染替换成相应的值。

4. 渲染 EJS 模板

在 Express.js 中,可以使用 res.render 方法来渲染 EJS 模板。

这里的 res.render 方法用于渲染 index 模板,同时提供了一个 JSON 对象作为变量,这个 JSON 对象中有 titlemessage 两个属性,它们会被 EJS 模板引擎动态渲染并渲染成最终的 HTML 文件。

注意事项

在使用 EJS 模板引擎时,需要注意一些常见问题:

1. 语法问题

在使用 EJS 模板引擎时,需要注意一些模板语法的问题,这些问题有可能会导致模板无法正确渲染,甚至会导致代码运行异常。

2. 变量命名问题

在使用 EJS 模板引擎时,需要注意变量名的命名问题,确保变量名的正确性和唯一性,否则也会导致代码运行异常。

3. 数据安全问题

在使用 EJS 模板引擎时,需要注意数据的安全性问题,确保用户输入的数据经过检验和过滤后再进行传递和输出,以防止 XSS 等攻击。

结语

本文详细介绍了在 Express.js 中使用 EJS 模板引擎的使用方式和注意事项。通过本文的学习,读者可以深入了解 EJS 模板引擎的基本概念,并掌握在 Express.js 中使用 EJS 模板引擎的技能,从而提高自己在 web 开发中的能力和竞争力。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6797364e504e4ea9bde4510c

纠错
反馈