@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');
});