# 模板渲染 [上一頁](# "上一頁")[下一頁](# "下一頁") 模板定義后就可以渲染模板輸出，系統也支持直接渲染內容輸出，模板賦值必須在模板渲染之前操作。 ### 渲染模板 渲染模板輸出最常用的是使用display方法，調用格式： display('[模板文件]'[,'字符編碼'][,'輸出類型']) 模板文件的寫法支持下面幾種： | 用法 | 描述 | |-----|-----| | 不帶任何參數 | 自動定位當前操作的模板文件 | | [模塊@][控制器:][操作] | 常用寫法，支持跨模塊 模板主題可以和theme方法配合 | | 完整的模板文件名 | 直接使用完整的模板文件名（包括模板后綴） | 下面是一個最典型的用法，不帶任何參數： ~~~ // 不帶任何參數 自動定位當前操作的模板文件 $this->display(); ~~~ 表示系統會按照默認規則自動定位模板文件，其規則是： 如果當前沒有啟用模板主題則定位到：`當前模塊/默認視圖目錄/當前控制器/當前操作.html`如果有啟用模板主題則定位到：`當前模塊/默認視圖目錄/當前主題/當前控制器/當前操作.html` 如果有更改TMPL_FILE_DEPR設置（假設 `'TMPL_FILE_DEPR'=>'_'`）的話，則上面的自動定位規則變成：`當前模塊/默認視圖目錄/當前控制器_當前操作.html` 和 `當前模塊/默認視圖目錄/當前主題/當前控制器_當前操作.html`。 所以通常display方法無需帶任何參數即可輸出對應的模板，這是模板輸出的最簡單的用法。 > 通常默認的視圖目錄是View 如果沒有按照模板定義規則來定義模板文件（或者需要調用其他控制器下面的某個模板），可以使用： ~~~ // 指定模板輸出 $this->display('edit'); ~~~ 表示調用當前模塊下面的edit模板 ~~~ $this->display('Member:read'); ~~~ 表示調用Member模塊下面的read模板。 如果我們使用了模板主題功能，那么也可以支持跨主題調用，使用： ~~~ $this->theme('blue')->display('User:edit'); ~~~ 表示調用blue主題下面的User控制器的edit模板。 如果你不希望每個主題都重復定義一些相同的模版文件的話，還可以啟用差異主題定義方式，設置： ~~~ 'TMPL_LOAD_DEFAULTTHEME'=>true ~~~ 設置后，如果blue主題下面不存在edit模板的話，就會自動定位到默認主題中的edit模板。 渲染輸出不需要寫模板文件的路徑和后綴，確切地說，這里面的控制器和操作并不一定需要有實際對應的控制器和操作，只是一個目錄名稱和文件名稱而已，例如，你的項目里面可能根本沒有Public控制器，更沒有Public控制器的menu操作，但是一樣可以使用 ~~~ $this->display('Public:menu'); ~~~ 輸出這個模板文件。理解了這個，模板輸出就清晰了。 display方法支持在渲染輸出的時候指定輸出編碼和類型，例如，可以指定編碼和類型： ~~~ $this->display('read', 'utf-8', 'text/xml'); ~~~ 表示輸出XML頁面類型（配合你的應用需求可以輸出很多類型）。 事情總有特例，如果的模板目錄是自定義的，或者根本不需要按模塊進行分目錄存放，那么默認的display渲染規則就不能處理，這個時候，我們就需要使用另外一種方式來應對，直接傳入模板文件名即可，例如： ~~~ $this->display('./Template/Public/menu.html'); ~~~ 這種方式需要指定模板路徑和后綴，這里的Template/Public目錄是位于當前項目入口文件位置下面。如果是其他的后綴文件，也支持直接輸出，例如：`$this->display('./Template/Public/menu.tpl');` 只要`./Template/Public/menu.tpl`是一個實際存在的模板文件。 > 要注意模板文件位置是相對于項目的入口文件，而不是模板目錄。 [上一頁](# "上一頁")[下一頁](# "下一頁")