ThinkPHP5.0模板之模板继承和包含文件与模板之内置标签
模板继承是一项更加灵活的模板布局方式,模板继承不同于模板布局,甚至来说,应该在模板布局的上层。模板继承其实并不难理解,就好比类的继承一样,模板也可以定义一个基础模板(或者是布局),并且其中定义相关的区块(block),然后继承(extend)该基础模板的子模板中就可以对基础模板中定义的区块进行重载。
因此,模板继承的优势其实是设计基础模板中的区块(block)和子模板中替换这些区块。
每个区块由{block} {/block}
标签组成。 下面就是基础模板中的一个典型的区块设计(用于设计网站标题):
{block name="title"}<title>网站标题</title>{/block}
block标签必须指定name属性来标识当前区块的名称,这个标识在当前模板中应该是唯一的(也就是说不能有重复的name属性的值),block标签中可以包含任何模板内容,包括其他标签和变量。
-
{block name="title"}<title>{$web_title}</title>{/block}
你甚至还可以在区块中加载外部文件:
{block name="include"}{include file="Public:header" /}{/block}
一个模板中可以定义任意多个名称标识不重复的区块,如我们在view视图目录下定义一个base.html基础模板:
在子模板中,可以对基础模板中的区块进行重载定义,如果没有重新定义的话,则表示沿用基础模板中的区块定义,如果定义了一个空的区块,则表示删除基础模板中的该区块内容。
{___block__}这个标签,当区块中有这个标记时,就不只是直接重载这个区块,它表示引用所继承模板对应区块的内容到这个位置,最终这个区块是合并后的内容。
在当前子模板中,只能定义区块而不能定义其他的模板内容,否则将会直接忽略,并且只能定义基础模板中已经定义的区块。
模板可以多级继承,比如B继承了A,而C又继承了B,最终C中的区块会覆盖B和A中的同名区块,但C和B中的区块必须是A中已定义过的。
子模板中的区块定义顺序是随意的,模板继承的用法关键在于基础模板如何布局和设计规划了,如果结合原来的布局功能,则会更加灵活。
(子模版区域外面的信息不会被展现出来的)
包含文件
在当前模版文件中包含其他的模版文件使用include标签,标签用法:
{include file='模版文件1,模版文件2,...' /}
包含的模板文件中不能再使用模板布局或者模板继承。
路径以 项目目录/public/ 路径下为起点
可以直接包含一个模版文件名(包含完整路径),例如:
{include file="../application/index/view/index/lang.html" /}
项目组常用内置标签
循环输出标签
VOLIST标签
volist标签通常用于查询数据集(select方法)的结果输出,通常模型的select方法返回的结果是一个二维数组,可以直接使用volist标签进行输出。 在控制器中首先对模版赋值:
$list = User::all();
$this->assign('list',$list);
在模版定义如下,循环输出用户的编号和姓名:
{volist name="list" id="vo"}
{$vo.id}:{$vo.name}<br/>
{/volist}
Volist标签的name属性表示模板赋值的变量名称(就是assign分配过来的这个名字),因此不可随意在模板文件中改变。id表示当前的循环变量,可以随意指定,但确保不要和name属性冲突,例如:
然后在view视图目录下的user控制器里建一个list.html模板
支持输出查询结果中的部分数据,例如输出其中的第5~15条记录
volist name="list" id="vo" offset="5" length='10'}//表示从第5条开始查询,查询10条
{$vo.name}
{/volist}
FOREACH标签
foreach标签类似与volist标签,只是更加简单,没有太多额外的属性,最简单的用法是:
{foreach $list as $vo}
{$vo.id}:{$vo.name}
{/foreach}
FOR标签
用法:
{for start="开始值" end="结束值" comparison="" step="步进值" name="循环变量名" }
{/for}
开始值、结束值、步进值和循环变量都可以支持变量,开始值和结束值是必须,其他是可选。comparison 的默认值是lt,name的默认值是i,步进值的默认值是1,举例如下:
{for start="1" end="100"}
{$i}
{/for}
解析后的代码是
for ($i=1;$i<100;$i+=1){
echo $i;
}
标签嵌套
模板引擎支持标签的多层嵌套功能,可以对标签库的标签指定可以嵌套。
系统内置的标签中,volist、switch、if、elseif、else、foreach、compare(包括所有的比较标签)、(not)present、(not)empty、(not)defined等标签都可以嵌套使用。例如:
{volist name="list" id="vo"}
{volist name="vo['sub']" id="sub"}
{$sub.name}
{/volist}
{/volist}
上面的标签可以用于输出双重循环。
原生PHP
Php代码可以和标签在模板文件中混合使用,可以在模板文件里面书写任意的PHP语句代码 ,包括下面两种方式使用php标签
例如:
{php}echo 'Hello,world!';{/php}
我们建议需要使用PHP代码的时候尽量采用php标签,因为原生的PHP语法可能会被配置禁用而导致解析错误。
所有要查看效果的地址都是localhost/tp5/index/user/list
下面举一个原生的例子
注意:php标签或者php代码里面就不能再使用标签(包括普通标签和XML标签)了,因此下面的几种方式都是无效的:
{php}{eq name='name'value='value'}value{/eq}{/php}
Php标签里面使用了
eq
标签,因此无效
{php}if( {$user} != 'ThinkPHP' ) echo 'ThinkPHP' ;{/php}
Php标签里面使用了
{$user}
普通标签输出变量 ,因此无效。
{php}if( $user.name != 'ThinkPHP' ) echo 'ThinkPHP' ;{/php}
(这样文件将会报错)
Php标签里面使用了
$user.name
点语法变量输出 ,因此无效。简而言之,在PHP标签里面不能再使用PHP本身不支持的代码。
如果设置了
tpl_deny_php
参数为true,就不能在模板中使用原生的PHP代码,但是仍然支持PHP标签输出。时间:2018.4.30