Pascal-# 像写HTML一样写Delphi界面？深度解析 sempare-delphi-template-engine 模板引擎

摘要： 在传统的 Delphi 开发中，我们习惯于在 IDE 的窗体设计器（Form Designer）中通过拖拽控件来构建 UI。虽然这种方式直观，但在面对需要高度动态化、由数据驱动的界...

在传统的 Delphi 开发中，我们习惯于在 IDE 的窗体设计器（Form Designer）中通过拖拽控件来构建 UI。虽然这种方式直观，但在面对需要高度动态化、由数据驱动的界面，或者需要将 UI 逻辑与业务逻辑彻底分离的场景时，传统的 .dfm 文件显得过于僵硬。

sempare-delphi-template-engine 为 Delphi 开发者提供了一种全新的思路：通过模板语法在运行时动态生成内容。它将模板引擎的概念引入了 Pascal 世界，让开发者能够使用类似 HTML 模板的语法来定义界面或文本结构，并在运行时填充数据。

1. 项目核心理念

该项目的核心目标是实现逻辑与表现的分离。

在标准的 Delphi 开发中，如果你想在界面上显示 10 个根据数据生成的面板，你可能需要写大量的 TPanel 实例化代码，手动设置 Top、Left 和 Caption。而使用该模板引擎，你可以定义一个简单的模板片段，然后通过循环指令将其重复渲染。

核心特性：

• 轻量级：无需复杂的依赖，直接集成到 Delphi 项目中。
• 动态绑定：支持将对象、记录或简单变量绑定到模板占位符。
• 控制流：支持在模板中使用简单的逻辑判断和循环。
• 灵活性：不仅可以用于生成 UI 布局，也可以用于生成复杂的文本报告、邮件正文或配置文件。

2. 快速上手实例

为了让你快速理解这个引擎是如何工作的，我们来看一个典型的应用场景：生成一个用户列表的动态描述文本。

场景需求

假设我们有一个用户对象列表，我们需要生成一段如下格式的文本：

当前在线用户： - 张三 (等级: 黄金) - 李四 (等级: 白金) - 王五 (等级: 钻石)

代码实现

uses
  System.SysUtils, 
  Sempare.TemplateEngine; // 假设单元名为此

procedure GenerateUserList;
var
  Template: TTemplateEngine;
  Data: TTemplateData;
  ResultText: string;
begin
  // 1. 初始化模板引擎
  Template := TTemplateEngine.Create;
  try
    // 2. 定义模板内容
    // 使用 {{变量名}} 进行占位，使用 #for 循环
    Template.TemplateText := 
      '当前在线用户：' + sLineBreak + 
      '#for user in users' + 
      ' - {{user.Name}} (等级: {{user.Rank}})' + 
      '#endfor';

    // 3. 准备数据源
    Data := TTemplateData.Create;
    try
      // 创建一个用户列表
      Data.AddList('users', [
        TUser.Create('张三', '黄金'),
        TUser.Create('李四', '白金'),
        TUser.Create('王五', '钻石')
      ]);

      // 4. 渲染模板
      ResultText := Template.Render(Data);
      
      // 输出结果
      Writeln(ResultText);
    finally
      Data.Free;
    end;
  finally
    Template.Free;
  end;
end;

3. 深度解析：关键语法与机制

3.1 变量替换 {{ variable }}

这是最基础的语法。引擎会扫描模板中的双花括号，并在 TTemplateData 中寻找对应的键值。如果键值是一个对象，它支持通过点号（.）访问属性。

3.2 循环指令 #for

对于列表数据的处理，#for 指令允许你定义一个迭代块。 - 语法：#for item in list ... #endfor - 原理：引擎在识别到 #for 时，会获取 list 对应的集合，并重复执行块内内容，每次将当前迭代项赋值给 item。

3.3 条件判断（如果支持）

在复杂的模板中，可以通过条件指令控制内容的显示与隐藏。例如，只有当用户是管理员时才显示“管理面板”按钮。

4. 实际应用场景分析

场景 A：动态 UI 生成

在 Delphi 中，你可以将模板引擎生成的字符串传递给 TWebBrowser 控件，或者利用该引擎生成 XML/JSON 格式的配置，再由自定义的解析器将其转化为 VCL 或 FMX 控件。

场景 B：多语言与国际化

不要在代码中硬编码 ShowMessage('Hello World')。你可以将所有提示语放在一个模板文件中： Greeting = "你好，{{UserName}}！欢迎回来。" 根据用户的语言设置加载不同的模板文件，实现极速国际化。

场景 C：自动化报告生成

在生成财务报表或系统日志时，可以使用模板定义表头、表尾和正文循环部分，避免在代码中拼接数千行字符串，极大提高代码的可维护性。

5. 与传统方式的对比

6. 总结与建议

sempare-delphi-template-engine 为 Pascal 开发者提供了一种现代化的开发模式。它打破了 Delphi 长期以来在界面构建上的“静态”印象。

如果你遇到以下情况，建议立即尝试该项目： 1. 你的代码中出现了大量的字符串拼接逻辑。 2. 你需要根据数据库内容动态生成复杂的文本或界面布局。 3. 你希望实现一个可以通过外部配置文件修改界面文案的系统。

通过将“如何显示”交给模板，将“显示什么”交给代码，你的 Delphi 项目将获得前所未有的灵活性和可维护性。