模板引擎

Blade 模板

Blade 是 Laravel 所提供的一个简单却又非常强大的模板引擎,甚至在 Lumen 中也可以使用,Blade 是使用 模板继承(template inheritance) 和 区块(sections)。所有的 Blade 模板后缀名都要命名为 .blade.php

定义一个 Blade 页面布局

  1. <!-- Stored in resources/views/layouts/master.blade.php -->
  2. <html>
  3. <head>
  4. <title>App Name - @yield('title')</title>
  5. </head>
  6. <body>
  7. @section('sidebar')
  8. This is the master sidebar.
  9. @show
  10. <div class="container">
  11. @yield('content')
  12. </div>
  13. </body>
  14. </html>

在视图模板中使用 Blade 页面布局

  1. @extends('layouts.master')
  2. @section('title', 'Page Title')
  3. @section('sidebar')
  4. @@parent
  5. <p>This is appended to the master sidebar.</p>
  6. @stop
  7. @section('content')
  8. <p>This is my body content.</p>
  9. @stop

请注意 如果视图 继承(extend) 了一个 Blade 页面布局会将页面布局中定义的区块用视图的所定义的区块重写。如果想要将页面布局中的区块内容也能在继承此布局的视图中呈现,那就要在区块中使用 @@parent 语法指令,通过这种方式可以把内容附加到页面布局中,我们会在侧边栏区块或者页脚区块看到类似的使用。

有时候,如您不确定这个区块内容有没有被定义,您可能会想要传一个默认的值给 @yield。您可以传入第二个参数作为默认值给 @yield:

  1. @yield('section', 'Default Content')

其他 Blade 控制语法结构

在 Blade 视图中打印(Echoing)数据

  1. Hello, {{ $name }}.
  2. The current UNIX timestamp is {{ time() }}.

检查数据是否存在后再打印数据

有时候您想要打印一个变量,但您不确定这个变量是否存在,通常情况下,您会想要这样写:

  1. {{ isset($name) ? $name : 'Default' }}

然而,除了写这种三元运算符语法之外,Blade 让您可以使用下面这种更简便的语法:

  1. {{ $name or 'Default' }}

使用花括号显示文字

如果您需要显示的一个字符串刚好被花括号包起来,您可以在花括号之前加上 @ 符号前缀来跳出 Blade 引擎的解析:

  1. @{{ This will not be processed by Blade }}

如果您不想数据被转义, 也可以使用如下语法:

  1. Hello, {!! $name !!}.

特别注意: 在您的应用程序打印用户所提供的内容时要非常小心。请记得永远使用双重花括号来转义内容中的 HTML 实体字符串。

If 声明

  1. @if (count($records) === 1)
  2. I have one record!
  3. @elseif (count($records) > 1)
  4. I have multiple records!
  5. @else
  6. I don't have any records!
  7. @endif
  8. @unless (Auth::check())
  9. You are not signed in.
  10. @endunless

循环

  1. @for ($i = 0; $i < 10; $i++)
  2. The current value is {{ $i }}
  3. @endfor
  4. @foreach ($users as $user)
  5. <p>This is user {{ $user->id }}</p>
  6. @endforeach
  7. @forelse($users as $user)
  8. <li>{{ $user->name }}</li>
  9. @empty
  10. <p>No users</p>
  11. @endforelse
  12. @while (true)
  13. <p>I'm looping forever.</p>
  14. @endwhile

加载子视图

  1. @include('view.name')

您也可以通过传入数组的形式将数据传递给加载的子视图:

  1. @include('view.name', ['some' => 'data'])

重写区块

如果想要重写掉前面区块中的内容,您可以使用 overwrite 声明:

  1. @extends('list.item.container')
  2. @section('list.item.content')
  3. <p>This is an item of type {{ $item->type }}</p>
  4. @overwrite

显示语言行

  1. @lang('language.line')
  2. @choice('language.line', 1)

注释

  1. {{-- This comment will not be in the rendered HTML --}}