Include 标签

Testing Is Documentation

tests/View/Compiler/CompilerIncludeTest.phpInclude 标签 - 图1

可以使用 include 标签来包含外部的模板文件。

使用完整文件名包含

使用方法如下：

  1. <include file="完整模板文件名" />

这种情况下，模板文件名必须包含后缀。

  1. public function testBaseUse(): void
  2. {
  3.     $parser = $this->createParser();
  5.     $source = <<<'eot'
  6.         <include file="application/app/ui/theme/default/header.html">
  7.         eot;
  9.     $compiled = <<<'eot'
  10.         <?php $this->display('application/app/ui/theme/default/header', [], '.html', true); ?>
  11.         eot;
  13.     $this->assertSame($compiled, $parser->doCompile($source, null, true));
  14. }

使用变量定义完整的文件

  1. public function testVar(): void
  2. {
  3.     $parser = $this->createParser();
  5.     $source = <<<'eot'
  6.         {~$headTpl = \Leevel::themesPath() . '/' . 'header.html'}
  7.         <include file="$headTpl">
  8.         eot;
  10.     $compiled = <<<'eot'
  11.         <?php $headTpl = \Leevel::themesPath() . '/' . 'header.html'; ?>
  12.         <?php $this->display($headTpl, [], '', true); ?>
  13.         eot;
  15.     $this->assertSame($compiled, $parser->doCompile($source, null, true));
  16. }

包含当前视图目录下的模板文件

  1. public function testInViewDir(): void
  2. {
  3.     $parser = $this->createParser();
  5.     $source = <<<'eot'
  6.         <include file="test" />
  7.         eot;
  9.     $compiled = <<<'eot'
  10.         <?php $this->display('test', [], '', true); ?>
  11.         eot;
  13.     $this->assertSame($compiled, $parser->doCompile($source, null, true));
  14. }

包含其他模块的操作模板

其中模块以目录分隔

  1. public function testOtherModule(): void
  2. {
  3.     $parser = $this->createParser();
  5.     $source = <<<'eot'
  6.         <include file="public+header" />
  7.         eot;
  9.     $compiled = <<<'eot'
  10.         <?php $this->display('public+header', [], '', true); ?>
  11.         eot;
  13.     $this->assertSame($compiled, $parser->doCompile($source, null, true));
  15.     $source = <<<'eot'
  16.         <include file="public/header" />
  17.         eot;
  19.     $compiled = <<<'eot'
  20.         <?php $this->display('public/header', [], '', true); ?>
  21.         eot;
  23.     $this->assertSame($compiled, $parser->doCompile($source, null, true));
  24. }

函数表达式支持

为了防止 . 被解析为 ->，需要由 () 包裹起来，file 内容区的解析规则遵循 if 标签的 condition 特性。

  1. public function testExpr(): void
  2. {
  3.     $parser = $this->createParser();
  5.     // 防止 . 被替换加上 () 包裹起来
  6.     $source = <<<'eot'
  7.         <include file="($path . '/' . $name)" />
  8.         <include file="Template::tpl('header')" />
  9.         <include file="tpl('header')" />
  10.         <include file="$hello.world('header')" />
  11.         eot;
  13.     $compiled = <<<'eot'
  14.         <?php $this->display(($path . '/' . $name), [], '', true); ?>
  15.         <?php $this->display(Template::tpl('header'), [], '', true); ?>
  16.         <?php $this->display(tpl('header'), [], '', true); ?>
  17.         <?php $this->display($hello->world('header'), [], '', true); ?>
  18.         eot;
  20.     $this->assertSame($compiled, $parser->doCompile($source, null, true));
  21. }