模板標簽 · 微擎

[TOC] #### 視圖視圖是 MVC 模式中的一部分。它是展示數據到終端用戶的代碼。在網頁應用中，根據視圖模板來創建視圖，視圖模板為PHP腳本文件，主要包含HTML代碼和展示類PHP代碼，簡單起見，我們稱視圖模板或視圖模板文件為視圖。 #### 渲染視圖 ##### **調用系統模板文件** 在任何php代碼中可以使用 **template()** 函數來渲染一個視圖文件。例如： ``` <?php /** * [WeEngine System] Copyright (c) 2013 WE7.CC */ $setting = $_W['setting']; //將渲染web/themes/default/user/login.html文件 template('user/login'); ``` app端與web端類似，只不過是起始目錄為 /app/themes/default/xxx/yyyy.html ##### **調用模塊中的模板文件** 同生成URL函數一樣，微擎也同樣為模塊封裝了單獨的模板調用函數，例如： ``` <?php class We7_demoModuleSite extends WeModuleSite { public function doMobileIndex1() { global $_W, $_GPC; $title = '支付測試'; //將渲染模塊目錄下的app端的模板文件 // addons/we7_demo/template/mobile/index1.html include $this->template('index1'); } public function doWebManage() { global $_W, $_GPC; //將渲染模塊目錄下的web端的模板文件 // addons/we7_demo/template/manage1.html include $this->template('manage1'); } } ``` 模塊中的template函數，分為app端與web端的調用，開發時請大家注意各自的目錄 ##### 模板標簽微擎的模板文件本質上就是一個php文件，所以支持直接書寫php代碼，但是為了增加開發效率和非php人員的使用，微擎系統定了了一套類似于 Smarty 的模板引擎標簽下面我們通過實例講解一下微擎中的標簽如何使用。 ##### 輸出一個變量輸出標簽是由一對花括號做為定界符的，不支持輸出數組，相對于php中的 echo 如下： ``` <div class="user-head ellipsis">{$_W['fans']['nickname']} :</div> // 對等于 ``` ##### 判斷語句如果 $do 等于 record 則顯示下面的卡券領取記錄，否則顯示查看卡券 ``` {if $do == 'record'} <li class="active"><a href="javascript:;">卡券領取記錄</a></li> {else} <li class="active"><a href="javascript:;">查看卡券</a></li> {/if} ``` if 和 elseif 配合使用 ``` {if $dca['status'] == 1} 未使用 {elseif $dca['status'] == 2} 已失效 {elseif $dca['status'] == 3} 已核銷 {elseif $dca['status'] == 4} 已刪除 {else} 全部 {/if} ``` ##### 循環語句循環一個數組用 loop 標簽，與php中的 foreach 函數類似，第一個參數為數組的索引，第二個參數為數組第一項的值只要標簽成對匹配，模板中的標簽是可以嵌套使用的。 ```` {loop $list $index $item} <tr> <td>{$index}（顯示數組的索引）：</td> <td>{$item['user']['nickname']}</td> <td> {if $item['follow'] == '1'} 已關注 {elseif $item['unfollowtime'] <> '0'} 取消關注 {else} 未關注 {/if} </td> </tr> {/loop} ``` ##### 一行php語句由于某些時候需要使用一些php來輸出內容，比如格式化時間戳為日期時，此寫法并不支持多行php語句，例如： ``` {php echo date('Y-m-d H:i:s', $row['followtime'])} ``` ##### 引用一個模板文件在模板中如果需要引用其它模板文件可以使用以下的方法： ``` //模塊中的使用方法，不需要添加目錄信息 {template 'header'} //系統的模板引用的方法，需要添加目錄信息 {template 'common/header-base'} ``` ##### 創建一個URL地址定義URL時，與在php文件中的創建方法一樣，具體使用如下： ``` <a href="{url 'extension/service/display'}" class="tile img-rounded">常用服務</a> <a href="{url 'home/welcome/ext' array('m' => $module['name'])}">模塊 - {$module['title']}</a> ``` 此標簽并沒有提供模塊 $this->createMobileUrl('xx') 函數，在模塊中的模板中請按以下方法創建： ``` {php echo $this->createMobileUrl('order')} ``` ##### 轉義一個圖片，附件地址微擎系統支持遠程附件，如果你有用到圖片或是附件請轉義一下地址，具體使用如下： ``` ``` ##### 輸出一對花括號因為模板標簽定界符是一對花括號，所以當你想輸出一對花括號本身時可以使用以下方法： ``` {##$order##} ``` 則此花括號和變量不會被轉義