視圖 · MixPHP V1 開發指南

## 視圖簡單來說，一個視圖其實就是一個 Web 頁面，或者頁面的一部分，像頁頭、頁腳、側邊欄等，MixPHP的視圖支持布局。 | 類 | | --- | | mix\http\View | ## 創建一個視圖下面演示為控制器 `ProfileController` 創建一個視圖，控制器代碼如下： ~~~ <?php namespace apps\index\controllers; use mix\http\Controller; class ProfileController extends Controller { public $layout = 'main'; public function actionIndex() { $data = [ 'name' => '小明', 'age' => 18, 'friends' => ['小紅', '小花', '小飛'], ]; return $this->render('index', $data); } } ~~~ 先在 `view/layout` 目錄建立一個布局文件 `main.php`，代碼如下： ~~~ <html> <head> <title><?= $this->title ?></title> </head> <body> <?= $content ?> </body> </html> ~~~ 然后在 `view` 目錄創建一個 `profile` 目錄，在目錄中創建一個 `index.php` 文件，代碼如下: - MixPHP 的視圖直接使用 PHP 做為引擎。 - 視圖文件名全部使用小寫，多個單詞時，使用下劃線分隔，例如：`setting_profile.php`。 - 通過 `$this->name` 可以傳遞數據到布局文件中使用。 ~~~ <?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__` 為當前視圖傳入所有變量的數組，可以讓子視圖使用父視圖的全部變量。