7.3   模板输出

模板变量赋值后就需要调用模板文件来输出相关的变量，模板调用通过display方法来实现。我们在操作方法的最后使用：

$this->display();

就可以输出模板，根据前面的模板定义规则，因为系统会按照默认规则自动定位模板文件，所以通常display方法无需带任何参数即可输出对应的模板，这是模板输出的最简单的用法。

事情总有特例，或者根本不需要按模块进行分目录存放，不过display方法总是能够帮你解决问题。

Display方法提供了几种规则让你可以随心所欲的输出需要的模板，无论你的模板文件在什么位置。

下面来看具体的用法：

一、调用当前模块的其他操作模板

格式：display('操作名')

例如，假设当前操作是User模块下面的read操作，我们需要调用User模块的edit操作模版，使用：

$this->display('edit'); 

不需要写模板文件的路径和后缀。

 

二、调用其他模块的操作模板

格式：display('模块名:操作名')

例如，当前是User模块，我们需要调用Member模块的read操作模版 ，使用：

$this->display('Member:read'); 

这种方式也不需要写模板文件的路径和后缀，严格来说，这里面的模块名和操作名并不一定需要有对应的模块或者操作，只是一个目录名称和文件名称而已，例如，你的项目里面可能根本没有Public模块，更没有Public模块的menu操作，但是一样可以使用

$this->display('Public:menu'); 

输出这个模板文件。理解了这个，模板输出就清晰了。

 

三、调用其他主题的操作模板

格式：display('主题名:模块名:操作名')

例如我们需要 调用Xp主题的User模块的edit操作模版，使用：

$this->display('Xp:User:edit'); 

这种方式需要指定模块和操作名

 

四、直接全路径输出模板

格式：display('模板文件名')

例如，我们直接输出当前的Public目录下面的menu.html模板文件，使用： 

$this->display('./Public/menu.html');

这种方式需要指定模板路径和后缀，这里的Public目录是位于当前项目入口文件位置下面。如果是其他的后缀文件，也支持直接输出，例如：

$this->display('./Public/menu.tpl');

只要./Public/menu.tpl是一个实际存在的模板文件。如果使用的是相对路径的话，要注意当前位置是相对于项目的入口文件，而不是模板目录。

 

事实上，display方法还有其他的参数和用法。

有时候某个模板页面我们需要输出指定的编码，而不是默认的编码，可以使用：

$this->display('Member:read','gbk'); 

或者输出的模板文件不是text/html格式的，而是XML格式的，可以用：

$this->display('Member:read','utf-8','text/xml'); 

如果你的网站输出编码不是默认的编码，可以使用：

'DEFAULT_CHARSET'=>'gbk' 

如果要输出XML格式的，可以用：

'TMPL_CONTENT_TYPE'=>'text/xml' 

 

如果不需要渲染模板文件而是直接输出内容，可以使用show方法，例如：

$this->show($content,'utf-8','text/xml');