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