起きたこと

Laravel 6.6 （執筆時最新版）のBladeファイルで、includeしたテーマのyield部分に、sectionが挿入されないことがあったのでメモ。

ファイル

こんなベースファイルに

base.blade.php

<!DOCTYPE html>
<head>
    @yield("head")
</head>

<body>
    @yield("body")
</body>
</html>

こんなheadタグのパーツを作って

head.blade.php

@section("head")
<title>@yield("title")</title>
@endsection

こんな実装bladeを作ったとする。

index.blade.php

@extends("base") // baseを継承

@include("head") // headをinclude

@section("title")  
index   //includeしたheadに、タイトル[index]を挿入
@endsection

@section("body")
body   //extendsしたbaseに、[body]を挿入
@endsection

これで生成されるhtmlは

<!DOCTYPE html>

<head>
<title></title>    <!-- タイトルが挿入されていない -->
</head>

<body>
body               <!-- bodyは挿入されている -->
</body>
</html>

このように、 @section("body") はきちんとyieldに挿入されるが @section("title") の部分は無視される。

思い通りの動き方のためには

index.blade.php

@extends("base")

// titleが挿入されるテンプレート head をincludeする前に
// section("title")を設定する
@section("title", "index")  

@include("head")

@section("body")
body
@endsection

このようにするとhead内のyieldにきちんと挿入される。

どうやら

extendsしたテンプレートへ挿入したいsectionはどこに書いても良い
- extends宣言の前でも後でも良い
includeしたテンプレートへ挿入したいsectionは、includeするよりも先にsectionを書かないといけない
- sectionの記述後にincludeしないといけない

といった制約がある様子。
どう日本語で表現したらいいのか難しいですが、多重yieldとか、includeしたテンプレートへのyieldとか、そういった感じでしょうか。

そのうちLaravelのコード直接読んで仕組みを理解したいところですが、今は覚書として。