@include
當我們網站開始變大的時候,就需要把共用的地方獨立出來後再讀入,比如這個網站如果我們要讀入 css 的話,沒有把共用的內容做管理,每次要更動內容的時候就可能會動到許多地方,所以我們這邊建立一個 part 的資料夾,並在裡面建立一個 head.blade.php,並在裡面放入這樣的內容:
<head>
<meta charset="UTF-8">
<meta name="viewport"
content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Posts</title>
<link rel="stylesheet" href="/style.css">
</head>
這個就是我們把 head 給獨立出來,接下來其他網頁要用的話只要像這樣就能讀入:
@include('part.head')
這樣之後要更動 head 裡面的內容的話只要修改 head 那支 blade 就好了。
讀入的 view 也可以繼承父層的 view 的資料,但也可以像這樣傳遞額外的資料到讀入的 view 裡:
@include('part.head', ['some' => 'data'])
@each
blade 也可以使用 @each 把資料帶到迴圈內將 html 渲染出來:
比如這邊在 part 的資料夾建立一個 user.blade.php 的檔案,內容如下:
<li>{{ $user["name"] }}</li>
原始資料:
$users = [ [ "name" => "Jason", "email" => "[email protected]" ], [ "name" => "Tom", "email" => "[email protected]" ] ];
接著我們利用 @each 把資料帶進去:
<ul>
@each('part.user', $users, 'user')
</ul>
其中第一個參數為要讀取的 view,第二個參數為資料,第三個則為帶進去後的變數名稱,還可以有第四個參數是用來判斷如果資料是空的讀取的 view。
這樣就能把資料帶到其他的 view 後把內容渲染出來。
樣板
不過我們更常用的是使用 blade 的樣板結構,我們可以先建立一個像這樣的 layout:
<!-- 檔案儲存於 resources/views/layouts/master.blade.php -->
<html>
<head>
<title>應用程式名稱 - @yield('title')</title>
</head>
<body>
@section('sidebar')
這是主要的側邊欄。
@show
<div class="container">
@yield('content')
</div>
</body>
</html>
這個檔案包含了傳統的 HTML 語法,不過包含了 @section 與 @yield 指令。正如其名,@section 指令定義一個內容區塊,而 @yield 指令被用來顯示給定區塊的內容。
繼承頁面佈局
當正在定義子頁面時,你可以使用 Blade 的 @extends 指令指定子頁面應該「繼承」哪一個佈局。當 view @extends Blade 的佈局之後,即可使用 @section 指令將內容注入於佈局的區塊中。切記,如上述範例所見,這些區塊的內容都會使用 @yield 顯示在佈局中:
<!-- 儲存於 resources/views/child.blade.php -->
@extends('layouts.master')
@section('title', '頁面標題')
@section('sidebar')
@parent
<p>這邊會附加在主要的側邊欄。</p>
@endsection
@section('content')
<p>這是我的主要內容。</p>
@endsection
在這個範例中,sidebar 區塊利用了 @parent 指令增加(而不是覆蓋)內容至佈局的側邊欄。@parent 指令會在視圖輸出時被置換成佈局的內容。
當然,就像一般的 PHP 視圖,可以在路由中使用全域的 view 輔助函式回傳 Blade 視圖:
Route::get('blade', function () { return view('child'); });