SLIGHTPHP / SAMPLES
TPL / INCLUDE + PART

模板与模块组合

include 复用模板和当前变量;part 调用另一个控制器方法。这里的结果都由实际调用生成。

1. include:共享父模板变量

父模板的 scope 为 PARENT。动态文件名的 include 跨目录加载 Widgets 的公共模板,继续使用同一个 Tpl 实例,子模板还会嵌套 include。

{%include $include_child%}

include 读取到:PARENT

嵌套 include 读取到:PARENT

2. part:调用 Widgets 模块

Card 方法创建自己的 Tpl 实例,将 scope 设置为 CHILD,并从路径参数读取 demo。卡片内部的 include 共享 CHILD。

{%part "/widgets/template/card/demo"%}

Widgets 模块卡片

模块变量:CHILD;路径参数:demo

模块内的 include:CHILD

调用后父模板:PARENT

单独打开模块卡片 →

3. 字符串返回与混合输出

part 将模块直接输出的内容与字符串返回值按顺序插入当前位置,各输出一次。

{%part "/widgets/template/returned/demo"%}
{%part "/widgets/template/mixed"%}

字符串返回:demo

先直接输出 / 再返回字符串

4. 嵌套 part 与响应结束

Nested 模块再次调用 Returned 方法;内部 Response::end() 输出片段后,父页面继续渲染。

{%part "/widgets/template/nested"%}
{%part "/widgets/template/ended"%}

嵌套模块变量:NESTED

字符串返回:nested

内部 part 完成,模块变量仍为:NESTED

Response::end 输出

所有模块完成,父模板仍为:PARENT

继续阅读

完整调用规则、文件位置和异常处理见仓库 docs/templates.md。模板与模块返回的动态 HTML 都应在输出处转义。