EJS模板中在单个脚本标签内渲染多个变量的技巧-html教程-PHP中文网

EJS模板中在单个脚本标签内渲染多个变量的技巧

花韻仙語

发布： 2025-10-12 13:27:05

原创

228人浏览过

EJS模板中在单个脚本标签内渲染多个变量的技巧

本教程探讨在ejs模板中，如何在一个``脚本标签内高效地渲染多个变量。针对传统方法仅显示首个变量的局限，文章详细介绍了利用javascript模板字面量（template literals）的解决方案，通过实际代码示例，指导开发者实现更简洁、灵活的模板变量组合与输出。

在EJS（Embedded JavaScript）模板引擎中，开发者经常需要将后端传递的多个数据变量渲染到前端页面。通常情况下，我们可以通过为每个变量使用独立的EJS脚本标签（<%= %>）来实现。然而，当需要将多个变量组合成一个连续的字符串输出时，如何在一个脚本标签内完成这一操作，是许多初学者会遇到的疑问。

变量的传递与基本渲染

首先，我们来看后端如何将数据传递给EJS模板。在Express等框架中，这通常通过res.render方法完成：

// 假设 currentDay 和 typeOfDay 已经定义
const currentDay = "星期一";
const typeOfDay = "工作日";

res.render('index', {
    currentDay: currentDay,
    typeOfDay: typeOfDay
});

登录后复制

在EJS模板文件（例如index.ejs）中，最直接且有效的方法是为每个变量使用独立的<%= %>标签进行渲染：

<h1>今天是 <%= currentDay%>。这是一个 <%= typeOfDay %>。</h1>

登录后复制

这种方法能够清晰地将currentDay和typeOfDay这两个变量分别插入到HTML字符串中，并正确显示。

遇到的问题：单个标签内的多变量尝试

有些开发者可能会尝试在一个<%= %>标签内使用逗号分隔多个变量，期望它们都能被渲染出来，例如：

<h1>今天是 <%= currentDay, typeOfDay%>。</h1>

登录后复制

然而，这种做法并不能如预期般工作。在EJS中，<%= %>标签内部期望的是一个JavaScript表达式，其最终计算结果将被输出。当使用逗号操作符时，JavaScript会依次评估每个表达式，并返回最后一个表达式的值。因此，<%= currentDay, typeOfDay%>通常只会输出typeOfDay的值（或在某些严格模式下可能报错，但EJS通常会取最后一个有效值），而不是将两者都输出或以某种组合形式输出。这与我们期望的将多个变量拼接成一个字符串的目的不符。

解决方案：利用JavaScript模板字面量

为了在单个<%= %>标签内高效且灵活地组合多个变量并输出，我们可以利用ES6引入的模板字面量（Template Literals）。模板字面量允许我们在字符串中嵌入表达式，使得字符串的构建变得异常简洁和强大。

模板字面量使用反引号（``）来定义字符串，并通过${expression}的语法在字符串中嵌入JavaScript表达式。

AiPPT模板广场

AiPPT模板广场-PPT模板-word文档模板-excel表格模板

147

查看详情

下面是使用模板字面量解决上述问题的示例：

<h1>今天是 <%= `${currentDay}。这是一个 ${typeOfDay}。` %></h1>

登录后复制

在这个示例中：

我们使用反引号（``）定义了一个模板字面量字符串。
在字符串内部，我们通过${currentDay}和${typeOfDay}将currentDay和typeOfDay这两个EJS变量嵌入到字符串中。
整个模板字面量字符串被包裹在<%= %>EJS标签内，EJS会计算这个模板字面量表达式，并将其最终的字符串结果输出到HTML中。

这样，即使在单个<%= %>标签中，我们也能以高度可读和灵活的方式组合任意数量的变量以及静态文本。

优势与注意事项

使用模板字面量在EJS中渲染多个变量具有以下优势：

简洁性与可读性：减少了EJS标签的数量，使得模板代码更加整洁，易于理解。
灵活性：可以在模板字面量中执行更复杂的JavaScript表达式，而不仅仅是简单地插入变量。
一致性：与现代JavaScript的字符串处理方式保持一致，降低了学习曲线。
减少HTML实体编码问题：EJS的<%= %>会自动对输出进行HTML实体编码，模板字面量内的变量也会被正确处理，从而避免XSS（跨站脚本攻击）风险。

注意事项：

确保你的EJS模板文件是.ejs扩展名，以便EJS引擎正确解析。
模板字面量是ES6特性，但EJS作为服务器端渲染引擎，其运行环境通常支持ES6，因此兼容性不是问题。
虽然可以在<%= %>内部执行复杂的JavaScript，但为了保持模板的“视图”职责，建议将大部分业务逻辑放在后端处理，模板只负责数据的展示。

总结

在EJS模板中，当需要在一个脚本标签内组合并输出多个变量时，使用JavaScript的模板字面量（Template Literals）是最佳实践。它不仅解决了传统方法无法实现多变量组合输出的问题，还通过其简洁、灵活的语法，显著提升了模板的可读性和开发效率。掌握这一技巧，将使你的EJS模板开发更加得心应手。

以上就是EJS模板中在单个脚本标签内渲染多个变量的技巧的详细内容，更多请关注php中文网其它相关文章！