萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Laravel Blade 模板 @section 系列標籤完整差異指南

@yield vs @section

特性@yield@section
可被子模板擴展否是(配合 @parent)
預設內容@yield('name', 'default')區塊內直接寫入
多次定義行為後者覆蓋前者配合 @append 可疊加
{{-- layout.master --}}
@yield('title', '預設標題')

@section('content')
預設內容
@show
{{-- child.view --}}
@extends('layout.master')

@section('title')
@parent
新標題
@stop

@section('content')
@parent
擴展內容
@stop

結果:title 只會顯示「新標題」(替換),content 顯示「預設內容 擴展內容」(疊加)。

@show vs @stop

  • @show:定義區塊**並立即輸出**到頁面。通常用於**佈局模板**的首次定義。
  • @stop:僅定義區塊內容,**不輸出**,交由最終佈局決定輸出位置。用於**子模板**覆寫/擴展時。
{{-- layout --}}
<div id="zoneA">
@section('zoneA') AAA @show </div>

<div id="zoneB">
@section('zoneB') BBB @stop </div> {{-- 永不顯示,除非子模板用 @show --}}

<div id="zoneC">
@section('zoneC') CCC @show </div>
{{-- page --}}
@extends('layout')
@section('zoneA') aaa @stop
@section('zoneB') bbb @stop
@section('zoneC') ccc @show

輸出結果:zoneB 內容丟失(無 @show),zoneC 顯示兩次(父子各一次)且破壞結構。

@append vs @override

同一區塊在子模板可**多次出現**:

  • @append:內容**疊加**到區塊末尾
  • @stop:結束疊加,後續同名區塊失效
  • @override:**推翻所有前面定義**,以本次為準
{{-- child --}}
@section('content') 第一行 @append
@section('content') 第二行 @append
@section('content') 結束 @stop
@section('content') 全部不要,聽我的 @override

最終輸出:全部不要,聽我的。適用於迴圈中動態構建內容,遇特殊條件需重置時。

最佳實踐建議

  1. 佈局模板:主要區塊用 @section ... @show,次要區塊用 @yield
  2. 子模板:覆寫用 @section ... @stop,需疊加用 @append,需重置用 @override
  3. 善用 @parent 保留父類內容,避免重複 HTML
  4. 避免在同一模板鏈中對同區塊混用 @show 多次
copyright © 萬盛學電腦網 all rights reserved