码迷,mamicode.com
首页 > 其他好文 > 详细

模板引擎使用详解:包含公共模板

时间:2014-11-17 12:12:05      阅读:251      评论:0      收藏:0      [点我收藏+]

标签:style   blog   http   color   ar   使用   sp   strong   文件   

ThinkPHP内置了一个基于XML的编译型模板引擎,本篇开始对其内置的标签做深入的讲解,如果你使用的是Smarty等第三方模板引擎,请忽略。
变量的输出我们已经在快速入门的变量输出中做了详细的描述,后面主要讲解变量的输出判断、循环和控制,以及包含公共模板和资源文件等。

包含公共模板

[-more-]

include标签

使用include标签在当前模板中包含公共模板,例如常见的header和footer等公共模板,include标签最常用的属性是file,但是支持不同的用法,其用法基本和我们常用的模板渲染方法display方法差不多。例如:
包含Public目录下面的header模板

<include file="Public:header" />

 

复制代码

包含当前模板目录下面的menu模板

<include file="menu" />

 

复制代码

如果当前使用了多模板主题功能,还可以包含其他主题的模板

<include file="blue:User:read" />

 

复制代码

表示包含blue模板主题下面的User/read模板文件,include标签所支持的模板深度只能到操作层次,也就是说ThinkPHP默认的模板结构采用的是:主题/模块/操作.模板后缀,使用上述用法包含模板的时候,file属性不需要指定模板后缀,如果你的模板结构不是标准结构,可以采用包含完整模板文件的方式:

<include file="./Tpl/default/header.html" />

 

复制代码

如果你在file属性中指定了模板文件后缀,则就会认为是包含完整模板的规则,如果你采用的是相对路径包含,那么当前的起始目录应该是项目入口文件所在的位置。
也可以用变量的方式:

    <include file="$filename" />

 

复制代码

但是并不推荐变量调用方式,因为由于模板引擎的编译特性,编译后会被缓存。

参数传递

include标签除了file属性之外,还支持传入一些简单的参数,并直接传递给模板文件使用,举个例子,我们包含一个头部文件,希望在模板文件里面动态指定网页标题和关键字信息,那么可以通过:

<include file="Public:header" title="ThinkPHP框架" keywords="开源WEB开发框架"/>

 

复制代码

这里我们在包含header公共模板的时候,还传入了title和keywords两个参数,我们来看下header模板文件怎么接收这些参数:

    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
    <title>[title]</title>
    <meta name="keywords" content="[keywords]" />
    </head>
复制代码

模板文件中的[title]和[keywords]来替换include标签中传入的参数。

包含多个模板

从3.1版本开始,include标签可以支持同时包含多个模板文件,例如:

<include file="Public:header,Public:menu" />
复制代码

也可以支持不同方式的包含混合,例如:

<include file="Public:header,./Tpl/default/menu.html" />
复制代码

嵌套包含模板

include标签支持嵌套使用,例如,我们可以在header公共模板文件中再次包含另外一个公共模板:

    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
    <title>[title]</title>
    <meta name="keywords" content="[keywords]" />
    </head>
    <include file="Public:menu" />

 

复制代码

并且理论上不限制嵌套层次,只要避免不发生循环嵌套的情况即可。

总结

include标签可以一定程度上简化重复的模板书写,和便于同步修改,不足就是如果公共模板文件发生更改,但是当前的主模板文件没有更改,则不会自动更新模板缓存,除非你设置了模板缓存有效期,那么在缓存过期后会自动更新模板缓存。

模板引擎使用详解:包含公共模板

标签:style   blog   http   color   ar   使用   sp   strong   文件   

原文地址:http://www.cnblogs.com/chen-lhx/p/4103069.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!