視圖 · MixPHP V2 開發指南

## 視圖簡單來說，一個視圖其實就是一個 Web 頁面，或者頁面的一部分，像頁頭、頁腳、側邊欄等，MixPHP的視圖支持布局。 | 類 | | --- | | Mix\Http\View\ViewTrait | ## 創建一個視圖試圖功能詳解： - MixPHP 的視圖直接使用 PHP 做為引擎。 - 使用視圖功能，只需 use ViewTrait 即可。 - 視圖文件名全部使用小寫，多個單詞時，使用下劃線分隔，例如：`setting_profile.php`。 - 通過 `$this->name` 可以傳遞數據到布局文件中使用。下面演示為控制器 `ProfileController` 創建一個視圖，控制器代碼如下： ~~~ <?php namespace Http\Controllers; use Mix\Http\View\ViewTrait; /** * Class ProfileController * @package Http\Controllers * @author LIUJIAN <coder.keda@gmail.com> */ class ProfileController { /** * 引用視圖特性 */ use ViewTrait; /** * 布局 * @var string */ public $layout = 'main'; /** * 默認動作 * @return string */ public function actionIndex() { $data = [ 'name' => '小明', 'age' => 18, 'friends' => ['小紅', '小花', '小飛'], ]; return $this->render('index', $data); } } ~~~ 先在 `applications/http/views/layouts` 目錄建立一個布局文件 `main.php`，代碼如下： ~~~ <html> <head> <title><?= $this->title ?></title> </head> <body> <?= $content ?> </body> </html> ~~~ 然后在 `applications/http/views` 目錄創建一個 `profile` 目錄，在目錄中創建一個 `index.php` 文件，代碼如下: ~~~ <?php $this->title = 'Profile'; ?> <p>name: <?= $name ?>, age: <?= $age ?></p> <p>friends:</p> <ul> <?php foreach($friends as $name): ?> <li><?= $name ?></li> <?php endforeach; ?> </ul> ~~~ ## 渲染視圖從上面的例子中可看出，視圖的渲染是在控制器中，代碼如下： >[info] return $this->render(視圖名, 數組); ### 視圖名不需要加上目錄，框架會自動獲取，只需輸入視圖文件名稱，不需要帶 `.php` 后綴。 ``` // 當前控制器目錄 return $this->render('index', $data); // 其他目錄 return $this->render('dirname.index', $data); ``` ### 數組需要傳遞給視圖使用的數據，是一個數組類型，數組 `key` 會變為視圖內的變量名稱，數組 `value` 會變為變量的值。 ## 視圖布局當使用 `$this->render` 渲染視圖時，MixPHP會獲取控制器屬性 `layout` 的值，用來讀取對應的布局文件。 >[info] 如果控制器未定義該屬性，則該屬性默認為 main。 ~~~ public $layout = 'main'; ~~~ ### 不使用布局當有需求不需要使用到布局時，使用下面的代碼渲染視圖： >[info] return $this->renderPartial(視圖文件名, 數組); ## 視圖嵌套當你在布局中使用公共的側邊欄等類似的需求時，需要在視圖中加載另一個視圖，如下： ~~~ <?= $this->render('子視圖名', $__data__); ?> ~~~ >[info] `$__data__` 為當前視圖傳入所有變量的數組，可以讓子視圖使用父視圖的全部變量。