前端开发中，经常需要生成 HTML 代码，以展示数据或者呈现页面结构。ejs 是一种流行的 JavaScript 模板引擎，可以轻松地生成 HTML 代码。而在使用 ejs 时，@jdists/ejs 是一个很好的选择，因为它可以方便地将 ejs 模板转换为 JavaScript 代码，实现更高效的代码生成。本文将介绍如何使用 @jdists/ejs，包括安装、使用、API 等内容。
安装
@jdists/ejs 是一个 npm 包，因此你需要在你的项目中安装它，可以直接使用 npm 进行安装：
npm install @jdists/ejs
安装完成后，即可在项目中使用 @jdists/ejs。
使用
使用 @jdists/ejs 很简单，只需要传入 ejs 模板和数据即可生成 HTML 代码。下面是一个简单的示例：
const jdistsEjs = require('@jdists/ejs');
const template = '<h1><%= title %></h1>';
const data = { title: 'Hello, world!' };
const result = jdistsEjs(template, data);
console.log(result); // <h1>Hello, world!</h1>在这个示例中，我们传入了一个 ejs 模板和一个数据对象，@jdists/ejs 就会将它们转换为 HTML 代码，并返回结果。这里的模板中使用了 ejs 的语法，<%= %> 表示输出数据，title 在模板中被替换为数据对象中的值。
API
@jdists/ejs 提供了多个 API，可以方便地进行模板生成。下面是 @jdists/ejs 的 API 列表。
jdistsEjs(template, data, options)
将 ejs 模板转换为 HTML 代码。
参数：
template{string} ejs 模板字符串。data{Object} ejs 模板中的数据对象。options{Object} 可选参数，指定 ejs 的编译选项。
返回值：
- {string} HTML 代码。
jdistsEjs.safe(value)
将字符串标记为“安全”，在 ejs 中使用时不会被转义。这个函数通常用于转义已经被转义的数据。
参数：
value{string} 要标记为“安全”的字符串。
返回值：
- {string} 被标记为“安全”的字符串。
jdistsEjs.include(template, data, options)
在 ejs 模板中引用其他模板。
参数：
template{string} 引用的模板。data{Object} 引用模板时使用的数据对象。options{Object} 编译选项。
返回值：
- {string} 处理后的 HTML 代码。
示例
下面是一个更复杂的示例，演示如何在 ejs 模板中引用其他模板，并使用编译选项进行自定义：
-- -------------------- ---- -------
----- --------- - -----------------------
----- ---- - ----------------
-- -----------
----- ------ - ------------ ----- -------------
-- -----------------
----- ------- - -
--- ------------------------------- ---------------- - ------ --- ----- -- --
---------
------- ------------- -------
------ --------------- ------
----------
--
-- ---------------- ------- -----
----- ------- - -
------- -----
------- ------
------------- ------
------------------- -------
------ ------
----------- -------
------------- ------
------- -----
--
----- ---- - -
-------- -
------ --- ----- ---------
-------- ----------------------- -- -- ----- --------------
-
--
----- ------ - ------------------ ----- ---------
--------------------在这个示例中，我们定义了一个公共的头部模板和一个文章模板，文章模板中引用了公共头部模板。在编译选项中，我们使用 jdistsEjs.safe() 函数将 content 标记为“安全”，避免 ejs 进行转义。编译完成后，我们得到了一个完整的 HTML 页面。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005693381e8991b448e4bdd