# Include 标签

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

# 使用完整文件名包含

使用方法如下:

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

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

public function testBaseUse(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        <include file="application/app/ui/theme/default/header.html">
        eot;

    $compiled = <<<'eot'
        <?php $this->display('application/app/ui/theme/default/header', [], '.html', true); ?>
        eot;

    $this->assertSame($compiled, $parser->doCompile($source, null, true));
}

# 使用变量定义完整的文件

public function testVar(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        {~$headTpl = \Leevel::themesPath() . '/' . 'header.html'}
        <include file="$headTpl">
        eot;

    $compiled = <<<'eot'
        <?php $headTpl = \Leevel::themesPath() . '/' . 'header.html'; ?>
        <?php $this->display($headTpl, [], '', true); ?>
        eot;

    $this->assertSame($compiled, $parser->doCompile($source, null, true));
}

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

public function testInViewDir(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        <include file="test" />
        eot;

    $compiled = <<<'eot'
        <?php $this->display('test', [], '', true); ?>
        eot;

    $this->assertSame($compiled, $parser->doCompile($source, null, true));
}

# 包含其他模块的操作模板

其中模块以目录分隔

public function testOtherModule(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        <include file="public+header" />
        eot;

    $compiled = <<<'eot'
        <?php $this->display('public+header', [], '', true); ?>
        eot;

    $this->assertSame($compiled, $parser->doCompile($source, null, true));

    $source = <<<'eot'
        <include file="public/header" />
        eot;

    $compiled = <<<'eot'
        <?php $this->display('public/header', [], '', true); ?>
        eot;

    $this->assertSame($compiled, $parser->doCompile($source, null, true));
}

# 函数表达式支持

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

public function testExpr(): void
{
    $parser = $this->createParser();

    // 防止 . 被替换加上 () 包裹起来
    $source = <<<'eot'
        <include file="($path . '/' . $name)" />
        <include file="Template::tpl('header')" />
        <include file="tpl('header')" />
        <include file="$hello.world('header')" />
        eot;

    $compiled = <<<'eot'
        <?php $this->display(($path . '/' . $name), [], '', true); ?>
        <?php $this->display(Template::tpl('header'), [], '', true); ?>
        <?php $this->display(tpl('header'), [], '', true); ?>
        <?php $this->display($hello->world('header'), [], '', true); ?>
        eot;

    $this->assertSame($compiled, $parser->doCompile($source, null, true));
}