ThinkPHP的模板引擎內置了布局(ju)模板功能支持,可(ke)以方便的實現模板布局(ju)以及布局(ju)嵌套功能。
有(you)三(san)種布局(ju)模板的支(zhi)持(chi)方式:
第一種方式:全局配置方式
這種方式(shi)僅需在項目配置(zhi)文件(jian)中(zhong)添加相關的(de)布局(ju)模(mo)(mo)板配置(zhi),就可以簡單實現(xian)模(mo)(mo)板布局(ju)功能,比較適用于全站使用相同布局(ju)的(de)情況(kuang),需要配置(zhi)開啟(qi)(qi)layout_on 參數(shu)(默認不開啟(qi)(qi)),并(bing)且設(she)置(zhi)布局(ju)入口文件(jian)名layout_name(默認為layout)。
'template' => [
'layout_on' => true,
'layout_name' => 'layout',
]
開啟layout_on后,我們(men)的模板渲染流程就有(you)所變化,例(li)如:
namespace app\index\controller;
use think\Controller;
Class User extends Controller
{
public function add()
{
return $this->fetch('add');
}
}
在不開啟layout_on布局模板之前,會直接渲染 application/index/view/user/add.html 模板文件,開啟之后,首先會渲染application/index/view/layout.html 模板,布局模板的寫法和其他模板的寫法類似,本身也可以支持所有的模板標簽以及包含文件,區別在于有一個特定的輸出替換變量{__CONTENT__},例如,下面是(shi)一個典型(xing)的layout.html模板(ban)的寫法:
{include file="public/header" /}
{__CONTENT__}
{include file="public/footer" /}
讀取layout模板之后,會再解析user/add.html 模板文件,并把解析后的內容替換到layout布局模板文件的{CONTENT} 特定字符串。
當然可以(yi)通過設置來改變這個特(te)定的替換字(zi)符串,例如:
'template' => [
'layout_on' => true,
'layout_name' => 'layout',
'layout_item' => '{__REPLACE__}'
]
一個(ge)布局(ju)模板同時只(zhi)能(neng)有一個(ge)特定替換(huan)字符(fu)串。
采用這種布局方式(shi)的情況下(xia),一(yi)旦user/add.html 模(mo)板(ban)文件或者layout.html布局模(mo)板(ban)文件發生修改,都會導致模(mo)板(ban)重新編譯。
如果需要(yao)指定其他(ta)位置的(de)布局(ju)模板,可以(yi)使用:
'template' => [
'layout_on' => true,
'layout_name' => 'layout/layoutname',
'layout_item' => '{__REPLACE__}'
]
就表示采用application/index/view/layout/layoutname.html作為布局模板。
如果某些頁面不需要使用布局模板功能,可以在模板文件開頭加上 {__NOLAYOUT__} 字符(fu)串。
如果上面的user/add.html 模板文件里面包含有{__NOLAYOUT__},則即使(shi)當(dang)前開啟(qi)布局模板,也(ye)不會(hui)進行布局模板解析。
第二種方式:模板標簽方式
這種布局模板不需要在配置文件中設置任何參數,也不需要開啟layout_on,直接在(zai)模板文件中指定布(bu)局(ju)模板即可,相(xiang)關的布(bu)局(ju)模板調(diao)整也在(zai)模板中進行。
以前面的輸出模板為例,這種方式的入口還是在user/add.html 模板,但是我們可以修改下add模板文件的內容,在頭部增加下面的布局標簽(記得首先關閉前面的layout_on設(she)置,否(fou)則可能出(chu)現布局循(xun)環(huan)):
{layout name="layout" /}
表示當前模板文件需要使用layout.html 布局模板文件,而布局模板文件的寫法和上面第一種方式是一樣的。當渲染user/add.html 模板文件的時候,如果讀取到layout標簽,則會把當前模板的解析內容替換到layout布局模板的{CONTENT} 特定字符串。
一個(ge)(ge)模(mo)(mo)板文(wen)件中只(zhi)能(neng)使用(yong)一個(ge)(ge)布局(ju)模(mo)(mo)板,如果模(mo)(mo)板文(wen)件中沒有使用(yong)任何layout標簽則表示當前模(mo)(mo)板不使用(yong)任何布局(ju)。
如(ru)果需要使(shi)用其他的布局模板,可以改(gai)變(bian)layout的name屬(shu)性,例如(ru):
{layout name="newlayout" /}
還可(ke)以(yi)在layout標簽里面(mian)指定要替換的特定字符串:
{layout name="Layout/newlayout" replace="[__REPLACE__]" /}
第三種方式:使用layout控制模板布局
使(shi)用內置(zhi)的layout方法可以更靈活(huo)的在程序(xu)中控制模(mo)板輸出(chu)的布局功能(neng),尤其(qi)適用于局部需要(yao)(yao)布局或者關閉布局的情(qing)況,這(zhe)種方式也不需要(yao)(yao)在配(pei)置(zhi)文(wen)件(jian)中開啟layout_on。例如:
namespace app\index\controller;
use think\Controller;
class User extends Controller
{
public function add()
{
$this->view->engine->layout(true);
return $this->fetch('add');
}
}
表示當前(qian)的模板輸出啟用了布(bu)局模板,并且采用默認的layout布(bu)局模板。
如果當前輸出需要使用(yong)不同的布局模板,可以動(dong)態(tai)的指定布局模板名稱,例如:
namespace app\index\controller;
use think\Controller;
class User extends Controller
{
public function add()
{
$this->view->engine->layout('Layout/newlayout');
return $this->display('add');
}
}
或者使用(yong)(yong)layout方(fang)法動態關閉當前模板(ban)的布(bu)局功能(這(zhe)種(zhong)用(yong)(yong)法可以配(pei)合第一種(zhong)布(bu)局方(fang)式,例如全局配(pei)置已經開(kai)啟了布(bu)局,可以在某個(ge)頁面(mian)單獨關閉):
namespace app\index\controller;
use think\Controller;
class User extends Controller
{
public function add()
{
// 臨時關閉當前模板(ban)的布局功(gong)能
$this->view->engine->layout(false);
return $this->display('add');
}
}
三種模(mo)(mo)板(ban)布局(ju)方(fang)式中(zhong)(zhong),第(di)(di)一種和第(di)(di)三種是在(zai)程序(xu)中(zhong)(zhong)配置實(shi)(shi)現模(mo)(mo)板(ban)布局(ju),第(di)(di)二種方(fang)式則(ze)是單純通過模(mo)(mo)板(ban)標簽在(zai)模(mo)(mo)板(ban)中(zhong)(zhong)使用(yong)布局(ju)。具體選擇什么方(fang)式,需要根據項目的實(shi)(shi)際(ji)情(qing)況來了。
