Eta

轻量、强大、插件化的嵌入式 JS 模板引擎。

采用 TypeScript 语言编写,支持 Node、Deno 以及浏览器运行环境

η
首页»快速入门»Eta 语法指南 - 标签、插值、控制流与布局模板详解

Eta 语法指南

本页系统梳理 Eta 模板的语法骨架:从标签类型、插值与原始输出,到控制流、多行注释、自定义分隔符,再到布局模板与插件扩展。每一节都配有可直接在练习场验证的最小示例,帮助你从「会写」进阶到「写得干净」。

语法速览:一张表看懂 Eta 的标签体系

Eta 的语法由「标签 + 分隔符」构成,标签负责逻辑,分隔符负责边界。下表列出最常用的几类写法,其中 <% %> 为默认标签,~ 用于输出原始值,- 用于控制左侧空白符。

语法 作用 典型场景
<% %>执行 JS 语句变量声明、循环、条件
<%= %>输出并转义用户输入、动态文本
<%~ %>输出原始 HTML已信任的富文本片段
<%# %>多行注释模板内说明,不参与渲染
<%_ %>去除左侧空白压缩输出、保持缩进整洁
Eta 插值与转义示意

插值与转义

默认输出自动转义,防止注入;确需渲染 HTML 时使用 ~ 前缀,并确保数据来源可信。

Eta 控制流与循环

控制流与循环

条件、遍历与嵌套均以普通 JS 语句书写,模板层不引入额外 DSL,学习成本低。

Eta 布局模板与插件

布局与插件

通过布局模板复用页面骨架,通过插件机制扩展编译流程,兼顾复用性与可维护性。

四个必须掌握的语法要点

常见误区对照

从 EJS 迁移时,最容易混淆的是「原始输出」与「空白控制」两个符号的位置。Eta 把两者拆开:~ 管输出,- 管空白,互不干扰。

  • 输出原始值:用 <%~ %>,而不是在标签内加 -。
  • 去除空白:把 - 放在标签左侧,如 <%- %>。
  • 注释不要用 HTML 注释代替,<%# %> 不会出现在最终输出中。

推荐的学习顺序

  1. 先跑通一个最小模板,确认渲染管线可用。
  2. 再练习插值与转义,理解安全边界。
  3. 然后加入控制流,构造列表与条件区块。
  4. 最后引入布局模板与插件,组织多页面结构。

语法常见问题

为什么我的 HTML 被转义成了文本?

默认输出会转义特殊字符。若确需渲染标签,请改用 <%~ %>,并确认数据经过可信校验。

可以同时使用两套分隔符吗?

单次编译使用一套分隔符即可;如需与其它模板共存,建议在配置中显式指定 tags,避免解析歧义。

布局模板会影响渲染性能吗?

布局在编译阶段完成拼接,运行时开销很小;建议把稳定不变的骨架放入布局,把变化部分留给子模板。

最新文章 / 相关阅读

迈希泽 | EN 16510 家用固体燃料燃烧设备 CE 认证服务
迈希泽 | EN 16510 家用固体燃料燃烧设备 CE 认证服务

EN 16510认证EN 16510 是欧盟统一的家用固体燃料燃烧设备安全与性能标准,2025 年 11 月 9 日起强制实施,全面替代旧标准(EN 13240/13229/14785 等)。适用产品:室内加热器、壁炉嵌件、炉灶、≤50kW

公司资讯 · 2025-11-09
尼日利亚电子签证于 2025年3月1日正式开通-eTA Visa电子签证中文网站
尼日利亚电子签证于 2025年3月1日正式开通-eTA Visa电子签证中文网站

尼日利亚正准备通过引入电子签证 (e-visa) 在移民系统现代化方面迈出新的一步,这一举措旨在使旅客入境尼日利亚更加简单、快速和安全。从 2025 年 3 月 1 日起,旅游者将可以在线达成整个签证申请,而无需前去领事馆或领事馆。在 X(

热点文章 · 2025-03-01
钰泰半导体通过ISO 26262 ASIL-D汽车功能安全管理体系认证 – ETA Semiconductor Limited
钰泰半导体通过ISO 26262 ASIL-D汽车功能安全管理体系认证 – ETA Semiconductor Limited

导言:通过ISO 26262:2018 ASIL-D汽车功能安全管理体系认证,代表钰泰半导体已经拥有了足够的能力和技术开发更加复杂成熟的车规级芯片。2024年3月19日,钰泰半导体股份有限公司正式通过ISO 26262:2018 ASIL-

公司资讯 · 2024-03-21
转载丨车规级认证体系大成!钰泰半导体车规级低压线性稳压器EQ5130重磅来袭 – ETA Semiconductor Limited
转载丨车规级认证体系大成!钰泰半导体车规级低压线性稳压器EQ5130重磅来袭 – ETA Semiconductor Limited

<转发集微网,原文链接可点击此处>集微网消息,由于应用场景的特殊性,汽车对芯片的可靠性要求极高,不仅要适应-40℃~150℃的温度环境、具备长达10年以上的稳定运行寿命,在抗干扰、散热处理、多重电路保护等方面也提出了严苛的要求,加上传统汽车

公司资讯 · 2023-07-14
转发|钰泰半导体如何闯荡汽车市场新蓝海? – ETA Semiconductor Limited
转发|钰泰半导体如何闯荡汽车市场新蓝海? – ETA Semiconductor Limited

<转发集微网,略有删减>2021年,缺芯潮令整个电源管理芯片市场狂飙突进,成为全年最炙手可热的芯片品类之一。在广阔的市场需求驱动下,随着中美贸易摩擦持续升级、国家政策支持、疫情使国外供应链失衡等背景下,本土电源管理芯片厂商迎来前所未有的利好

行业新闻 · 2023-01-17
[转]钰泰半导体ACDC产品介绍,数款常规、合封氮化镓快充器件可选 – ETA Semiconductor Limited
[转]钰泰半导体ACDC产品介绍,数款常规、合封氮化镓快充器件可选 – ETA Semiconductor Limited

以下内容和图片均选自充电头网微信公众号,详细内容可访问链接:点击此处访问 11月23日,2022(冬季)USB PD&Type-C 亚洲大会改为线上直播形式,此次大会邀请到了数位 USB PD 快充行业的技术专家和 USB PD 快充资深从

行业新闻 · 2022-12-19
继续深入语法细节 返回文档首页