EJS 模板变量渲染指南:解决 不显示输出的问题

EJS 模板变量渲染指南:解决  不显示输出的问题

本文旨在解决 EJS 模板中变量不正确渲染的问题,特别是当使用 标签尝试显示变量值时,却发现变量名原样输出而非实际内容。核心在于区分 EJS 模板中不同标签的功能: 用于控制流,而 才是用于安全地输出变量内容。通过详细解释和示例代码,本文将指导开发者正确使用 EJS 标签,确保模板变量能够被预期地解析和渲染。

EJS 模板标签解析

ejs (embedded javascript) 是一种流行的模板引擎,它允许在 html 模板中嵌入 javascript 代码,从而实现动态内容的生成。理解 ejs 提供的不同标签是正确使用它的关键。ejs 主要有以下几种标签类型:

(Scriptlet Tag):此标签用于执行 JavaScript 代码,但不直接输出结果到 HTML。它通常用于控制流,例如 if/else 语句、for 循环、变量声明等。示例:

    

欢迎

请登录

(Output Tag, Escaped):此标签用于将 JavaScript 表达式的结果输出到 HTML。它会自动对输出内容进行 HTML 转义(例如,将 示例:

页面标题:

(Output Tag, Unescaped):此标签也用于输出 JavaScript 表达式的结果,但它不会对内容进行 HTML 转义。这意味着如果变量中包含 HTML 标签,它们将作为原始 HTML 被渲染。使用此标签时需要格外小心,因为它可能引入 XSS 漏洞。仅在您确定内容是安全的情况下使用。示例:

(Comment Tag):此标签用于在 EJS 模板中添加注释。注释内容不会被渲染到最终的 HTML 输出中。示例:


常见问题:变量不渲染的原因

许多初学者在使用 EJS 时,会遇到一个常见问题:尝试显示变量 KindOfDay 的值,但在浏览器中却看到

Its a

这样的原始输出,而不是期望的 “Its a Weekend” 或 “Its a Weekday”。

问题根源:这通常是因为错误地使用了 Scriptlet Tag () 来尝试输出变量。如上所述, 标签仅用于执行代码逻辑,而不负责将表达式的结果渲染到 HTML。当 EJS 引擎遇到 时,它会将其视为一段需要执行的 JavaScript 代码,但由于 KindOfDay 只是一个变量名,没有明确的执行操作(如 console.log() 或赋值),它不会产生任何输出,最终导致原始标签内容被保留。

解决方案:使用正确的输出标签

要正确地将变量 KindOfDay 的值渲染到 HTML 中,必须使用 输出标签

错误示例 (不渲染变量):

    

Its a

正确示例 (渲染变量):

    

Its a

通过将 修改为 ,EJS 引擎将识别这是一个需要输出的表达式,并将其值(例如 “Weekend” 或 “Weekday”)安全地插入到 HTML 中。

完整示例与实践

下面是一个结合 Express.js 和 EJS 的完整示例,演示如何正确设置 EJS 模板引擎并渲染动态内容:

1. 项目结构:

my-express-app/├── app.js└── views/    └── list.ejs

2. app.js (Express 应用):

const express = require("express");const bodyParser = require("body-parser");const path = require("path"); // 引入 path 模块const app = express();// 设置 EJS 为视图引擎app.set('view engine', 'ejs');// 设置视图文件目录app.set('views', path.join(__dirname, 'views'));// 使用 body-parser 中间件(如果需要处理 POST 请求)app.use(bodyParser.urlencoded({ extended: true }));app.use(express.static("public")); // 如果有静态文件(如CSS/JS),需要设置静态文件目录app.get("/", (req, res) => {    var today = new Date();    // 使用 getDay() 获取星期几(0-6,0为周日,6为周六)    var dayOfWeek = today.getDay();    var day = "";    if (dayOfWeek === 0 || dayOfWeek === 6) { // 周日或周六        day = "Weekend";    } else {        day = "Weekday";    }    // 渲染 list.ejs 模板,并传入 KindOfDay 变量    res.render("list", { KindOfDay: day });    console.log(`当前计算出的日期类型: ${day}`);});const port = 3000;app.listen(port, () => {    console.log(`Server Running on port ${port}`);});

注意: 在 app.js 中,我们修正了获取星期几的逻辑,使用 today.getDay() 代替 today.getDate(),因为 getDate() 返回的是月份中的日期,而不是星期几。

3. views/list.ejs (EJS 模板):

            EJS 动态内容    

今天是

运行步骤:

确保已安装必要的依赖:

npm init -ynpm install express ejs body-parser

将上述 app.js 和 views/list.ejs 文件保存到对应的位置。在终端中运行 app.js:

node app.js

在浏览器中访问 http://localhost:3000。您将看到页面显示 “今天是 Weekend” 或 “今天是 Weekday”,具体取决于当前是周末还是工作日。

注意事项与总结

区分标签功能: 始终牢记 用于逻辑控制, 用于输出转义后的内容, 用于输出未转义的原始内容。安全实践: 除非您完全信任要输出的内容来源,否则应优先使用 来输出变量,以避免潜在的 XSS 攻击。VS Code 扩展: 虽然 EJS 渲染问题与 VS Code 本身无关,但安装 EJS 相关的 VS Code 扩展(如 “EJS language support”)可以提供语法高亮、代码片段和智能提示,极大地提升开发体验。调试: 如果遇到变量未按预期渲染的问题,首先检查 EJS 标签是否正确,其次检查 Express 路由中 res.render() 函数是否正确传递了数据对象,以及数据对象中的键名是否与 EJS 模板中使用的变量名一致。

通过掌握 EJS 模板标签的正确用法,开发者可以高效且安全地构建动态 Web 页面。理解 Scriptlet Tag 和 Output Tag 的核心区别是解决大多数 EJS 渲染问题的关键。

以上就是EJS 模板变量渲染指南:解决 不显示输出的问题的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1577278.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月22日 18:45:21
下一篇 2025年12月22日 18:45:39

相关推荐

  • JavaScript外部函数调用疑难解析:脚本位置与命名规范

    本文探讨了在HTML中调用外部JavaScript函数时常见的两个问题:脚本加载时机不当导致DOM元素未就绪,以及函数命名可能与浏览器内置事件或关键字冲突。文章提供了详细的解决方案,包括调整脚本引用位置和遵循良好的函数命名规范,以确保JavaScript代码能够正确执行。 理解问题根源:为何外部JS…

    2025年12月22日
    000
  • 解决HTML中无法调用外部JavaScript函数的常见问题与最佳实践

    本文深入探讨了在HTML中调用外部JavaScript函数时遇到的常见问题及其解决方案。主要聚焦于脚本加载时机不当(如在head中加载)和函数命名冲突(如使用click等保留字)两大原因,并提供了将脚本放置在body末尾以及使用更具描述性的函数名等专业建议,旨在帮助开发者构建更健壮的前端应用。 在w…

    2025年12月22日
    000
  • HTML5文件读取怎么操作_FileAPI文件读取方法详解

    答案:HTML5通过File API实现前端文件读取,核心是FileReader接口。用户需主动选择文件,JavaScript可异步读取文本、Data URL或ArrayBuffer格式内容。支持分块读取、Web Workers提升大文件处理性能,并提供onprogress实时反馈。安全上依赖用户授…

    2025年12月22日
    000
  • 捕获含跨域iframe的父元素mousedown事件:原理与限制

    本文探讨了在包含跨域iframe的父div上捕获mousedown事件的挑战。核心问题在于浏览器安全策略(同源策略)阻止了对跨域iframe内容的直接DOM事件监听。除非控制iframe源域名并配置CORS,否则无法实现此类事件捕获。文章将详细解释这些安全机制及其对事件交互的限制,并提供可能的替代方…

    2025年12月22日
    000
  • HTML表格可访问性怎么提升_HTML表格无障碍访问优化

    提升HTML表格可访问性的核心是语义化结构与辅助技术兼容,需使用提供标题、/划分结构、配合scope明确表头关系,复杂表格用id和headers建立数据关联,避免滥用合并单元格,确保屏幕阅读器和键盘用户能准确理解数据上下文。 提升HTML表格的可访问性,核心在于确保所有用户,包括使用屏幕阅读器或其他…

    2025年12月22日
    000
  • HTML在线运行响应式设计_在线调试HTML响应式布局方法

    首先使用支持实时预览的在线编辑器如CodePen或JSFiddle,将HTML和CSS代码粘贴后通过多设备视图测试不同屏幕下的显示效果;接着确保HTML中包含viewport元标签,并利用Chrome开发者工具模拟移动设备查看响应式表现;然后拆分媒体查询条件,在线添加背景色变化等可视化规则,逐一验证…

    2025年12月22日
    000
  • HTML锚点跳转:实现页面内快速导航的设置方法

    使用id属性设置锚点可实现页面内快速导航,通过href=”#id”链接跳转至目标元素位置。 如果您希望在网页中实现快速定位到特定内容区域,可以通过设置HTML锚点来完成页面内导航。以下是几种常用的实现方法: 一、使用id属性创建锚点 通过为页面中的某个元素设置唯一的id属性,…

    2025年12月22日
    000
  • 捕获包含iframe子元素的div上的鼠标事件:跨域安全与技术限制

    当一个div元素包含iframe子元素时,直接在其上捕获mousedown等鼠标事件会遇到挑战,特别是当鼠标点击iframe内部时。这主要是由于浏览器安全策略(同源策略)限制了父页面与跨域iframe内容之间的JavaScript交互。因此,除非父页面和iframe内容同源或有特定CORS配置,否则…

    2025年12月22日
    000
  • HTMLsitemap怎么做_XML网站地图创建提交教程

    XML网站地图用于提升搜索引擎爬虫的索引效率,HTML网站地图则优化用户导航体验;前者通过提交至Google Search Console等平台帮助发现深层页面并传递更新信息,后者在页脚等位置提供清晰链接结构以改善用户体验和内部链接。两者互补,需定期维护、检查错误,并确保URL规范化、避免包含noi…

    2025年12月22日
    000
  • CSS动画技巧:实现汉堡菜单按钮默认显示箭头并切换为三条杠

    本教程将详细讲解如何修改一个基于CSS动画的汉堡菜单按钮,使其初始状态即显示为箭头图标,并在点击时平滑过渡到三条杠的汉堡图标。核心方法是通过在HTML中预设CSS激活类,从而巧妙地反转了按钮的默认视觉状态,同时保留了其动态交互功能。 在现代网页设计中,交互式菜单按钮是提升用户体验的关键元素之一。常见…

    2025年12月22日
    000
  • HTML引用文本怎么标记_HTML的blockquote标签使用教程

    使用标签可语义化标记大段引用内容,配合cite属性提供机器可读来源,结合与元素展示用户可见的引用信息,提升SEO与无障碍访问;短行内引用则应使用标签。 HTML中引用文本主要使用 标签。它被设计用来标记那些大段的、独立于当前上下文的引用内容,帮助浏览器和屏幕阅读器理解这部分文本的语义是引自他处。 解…

    2025年12月22日
    000
  • 深入理解iframe事件捕获与跨域安全限制

    本文探讨了在包含iframe的父div上捕获mousedown事件的挑战。核心问题在于浏览器同源策略,它阻止了父页面JavaScript直接访问或监听跨域iframe内部的事件,导致事件无法冒泡到父元素。除非同时控制iframe内容源并进行CORS配置,否则直接捕获第三方iframe内的鼠标事件几乎…

    2025年12月22日
    000
  • HTML5QrCode摄像头检测与初始化:避免getCameras()方法误用

    在使用HTML5QrCode库时,开发者常会遇到Uncaught TypeError: html5QrCode.getCameras is not a function的错误。本文旨在澄清getCameras()方法的正确用法,指出它应作为Html5Qrcode类的静态方法而非实例方法调用,并提供完…

    2025年12月22日 好文分享
    000
  • HTML文档换行怎么实现_HTML换行符使用指南

    最直接的换行方式是使用标签,适用于行内强制换行;而标签用于语义化的段落分隔,自带间距并提升可访问性;CSS的white-space属性则提供更精细的换行控制,如pre-wrap保留换行空格且自动换行;块级元素天然独占一行,适合结构布局;响应式设计中应避免滥用,优先让文本自然流动,并结合CSS优化多端…

    2025年12月22日
    000
  • Html5Qrcode 摄像头访问:getCameras() 方法的正确用法

    本文旨在解决在使用 Html5Qrcode 库时,调用 getCameras() 方法出现 TypeError 的问题。核心原因在于 getCameras() 是 Html5Qrcode 类的一个静态方法,而非其实例方法。教程将详细阐述如何正确调用此方法以获取设备摄像头列表,确保应用程序能够顺利检测…

    2025年12月22日
    000
  • 深入理解与实践:使用JavaScript选择含JSON字符串值的下拉选项

    本文详细阐述了如何在HTML 元素中,当选项的 value 属性存储的是JSON字符串时,通过JavaScript动态选择匹配特定JavaScript对象的选项。核心方法包括将目标JavaScript对象转换为标准的JSON字符串,然后利用CSS属性选择器精确查找并设置对应的选项为选中状态,同时强调…

    2025年12月22日
    000
  • HTML在线运行与云服务结合_在线运行HTML代码的云服务集成

    通过集成云服务可实现HTML在线实时运行与高效协作:一、使用GitHub Codespaces等云IDE编写并预览代码,文件自动同步至云端;二、将HTML项目上传至AWS S3等对象存储,开启静态网站托管并配置权限,获取公网访问链接;三、利用腾讯云SCF等Serverless函数动态返回HTML内容…

    2025年12月22日
    000
  • HTML音频转录怎么提供_音频内容可访问性转录指南

    答案:通过选择合适的转录方法、创建准确文本、使用WebVTT格式嵌入HTML的元素,并进行人工校对与测试,可实现高可访问性的HTML音频转录。 HTML音频转录旨在为听力障碍者或其他需要以文本形式访问音频内容的用户提供便利。它通过将音频内容转换成文本,使得信息更容易被理解和搜索。 解决方案 提供HT…

    2025年12月22日
    000
  • HTML与字体图标:使用FontAwesome添加图标的教程

    使用FontAwesome可通过CDN引入图标库,再用类名插入图标,并通过CSS自定义样式,还支持动画效果和SVG形式渲染。 如果您希望在网页中使用简洁美观的图标,而无需加载大量图片资源,FontAwesome 是一个高效且广泛使用的解决方案。通过将图标作为字体引入,您可以轻松调整大小、颜色和样式。…

    2025年12月22日
    000
  • HTML表格字体怎么设置_HTML表格文字字体样式调整方法

    答案:HTML表格字体设置应使用CSS,通过font-family、font-size、color等属性定义样式,并推荐使用外部样式表以实现内容与样式的分离;可结合class、id及伪类选择器对特定单元格或行设置独特样式,同时遵循可读性、对比度和响应式设计等用户体验最佳实践。 HTML表格的字体设置…

    2025年12月22日
    000

发表回复

登录后才能评论
关注微信