调用模板

您正在阅读旧版文档,新版文档已迁移至 [https://document.pescms.com]

目录

创建好模板后,我们还需要调用它们。否则他们一直被冷落,没准那天它们会疯。调用模版的方法只能在控制器中使用。PESCMS提供了 display() 和 layout两个方法。

display

参数说明备注
$themeFile调用模板的名称。为空时,则调用 控制器名称_方法.php 的模板(参数不带.php后缀)。非必填

要显示模板,我们只要调用diplay()方法:

<?php
...某个控制器...
    public function index(){
        $this->display();
    }

当不带任何参数的时候,diplay() 会在对应组的模板中寻找 控制器_方法.php 的模板文件。当寻找失败后,会返回找不到模板的提示。反之若带了参数,那么他就会寻找对应名称的模板。

layout

参数说明备注
$themeFile模板名称 为空时,则调用 控制器名称_方法.php 的模板(参数不带.php后缀)。必填
$layout布局模板文件名称 | 默认调用 layout.php(参数不带.php后缀)/

在编写模板过程,单纯使用diplay()调用模板,难免会经常重复引入页眉,页脚,侧栏等重复的代码。当出现这个情况时,应该使用layout() 方法。在调用layout之前,您需要在对应的组模板目录下创建一个名为layout.php的模板文件(若您起名其他,那么在调用layout方法时,需要带上第二个参数进行声明)。并在layout文件中写入如下代码:

<?php $this->header(); ?> <!--此处表示加载页眉-->

<?php include $file; ?> <!--此处表示加载对应的模板: 控制器_方法.php  此行为必须。layout显示的页面为空白页 -->

<?php $this->footer(); ?> <!--此处表示加载页脚-->

上面的为PESCMS通常的写法。header() 和 footer() 方法为加载页眉页脚的方法。后面将作介绍。具体的布局形式,请自行依据实际的项目进行调整。

header已移除

本方法于2.8核心版本移出

参数说明备注
$theme页眉名称,不填写默认寻找header.php文件。(参数不带.php后缀)非必填

header() 方法,顾名思义就是调用页眉。本方法用在模板文件中。调用方法非常简单,在任何模板找到您想引入页面的地方:

<?php $this->header();?>

footer已移除

本方法于2.8核心版本移出

参数说明备注
$theme页眉名称,不填写默认寻找footer.php文件。(参数不带.php后缀)非必填

footer() 方法和header()方法一样。再次不作说明了。

PESCMS DOC 文档系统
© Copyright 2015-2024. by the PESCMS DOC
耗时0.022秒