第一种方式:全局配置方式
在项目配置文件中添加相关的布局模板配置,就可以简单实现模板布局功能,比较适用于全站使用相同布局的情况,需要在config.php中配置开启layout_on 参数(默认不开启),config.php中原本没有就只需要添加即可,并且设置布局入口文件名layout_name(默认为layout)。
'template' => [
'layout_on' => true,
'layout_name' => 'layout',
]
开启layout_on后,我们的模板渲染流程就有所变化:首先会渲染application/index/view/layout.html 模板,布局模板的写法和其他模板的写法类似,本身也可以支持所有的模板标签以及包含文件,区别在于有一个特定的输出替换变量{__CONTENT__},例如,下面是一个典型的layout.html模板的写法:
{include file="public/header" /}
{__CONTENT__}
{include file="public/footer" /}
读取layout模板之后,会再解析对应控制器方法对应的模板文件,并把解析后的内容替换到layout布局模板文件的{CONTENT} 特定字符串。
第二种方式:模板标签方式
这种布局模板不需要在配置文件中设置任何参数,也不需要开启layout_on。而布局模板文件的写法和上面第一种方式是一样的。并且也是放在application/index/view/layout.html不同的模块中都可以单独设置,在控制器方法对应的视图文件中,首先使用此标签加载上布局模板文件。
{layout name="layout" /}
第三种方式:使用layout控制模板布局
在程序中控制模板输出的布局功能,尤其适用于局部需要布局或者关闭布局的情况,这种方式也不需要在配置文件中开启layout_on。
namespace appindexcontroller;
use thinkController;
class User extends Controller{
public function add()
{
$this->view->engine->layout(true);
// 或者使用指定的模板;
$this->view->engine->layout('Layout/newlayout');
return $this->fetch('add');
}}
模板继承
模板继承是一项更加灵活的模板布局方式,模板继承不同于模板布局,甚至来说,应该在模板布局的上层。
一个模板中可以定义任意多个名称标识不重复的区块,例如下面定义了一个base.html基础模板:可以放到对应模块的view文件夹下;
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>{block name="title"}标题{/block}</title>
</head>
<body>
{block name="menu"}菜单{/block}
{block name="left"}左边分栏{/block}
{block name="main"}主内容{/block}
{block name="right"}右边分栏{/block}
{block name="footer"}底部{/block}
</body>
</html>
然后我们在子模板(其实是当前操作的入口模板)中使用继承
{extend name="base" /}
{block name="title"}{$title}{/block}
{block name="menu"}
<a href="/" >首页</a>
<a href="/info/" >资讯</a>
<a href="/bbs/" >论坛</a>
{/block}
{block name="left"}{/block}
{block name="main"}
{volist name="list" id="vo"}
<a href="/new/{$vo.id}">
{$vo.title}
</a>
<br/>
{$vo.content}
{/volist}
{/block}
{block name="right"}
最新资讯:
{volist name="news" id="new"}
<a href="/new/{$new.id}">{$new.title}</a>
<br/>
{/volist}
{/block}
{block name="footer"}{__block__}
@ThinkPHP 版权所有{/block}
在子模板中,可以对基础模板中的区块进行重载定义,如果没有重新定义的话,则表示沿用基础模板中的区块定义,如果定义了一个空的区块,则表示删除基础模板中的该区块内容。这一区块中有{_block_}这个标签,当区块中有这个标记时,就不只是直接重载这个区块,它表示引用所继承模板对应区块的内容到这个位置,最终这个区块是合并后的内容。在当前子模板中,只能定义区块而不能定义其他的模板内容,否则将会直接忽略,并且只能定义基础模板中已经定义的区块。
二、包含文件:
在当前模版文件中包含其他的模版文件使用include标签,标签用法:
{include file='模版文件1,模版文件2,...' /}
包含的模板文件中不能再使用模板布局或者模板继承。
模版表达式的定义规则为:模块@控制器/操作
{include file="public/header" /} // 包含头部模版header
{include file="public/menu" /} // 包含菜单模版menu
{include file="blue/public/menu" /} // 包含blue主题下面的menu模版