视图开发

    Blade 视图都会被编译缓存成普通的 PHP 代码，一直到它们被更改为止。这代表 Blade 基本不会对你的应用程序生成负担。

    Blade 视图文件使用 .blade.php 做为扩展名，通常保存于 或 module/Xxx/View 文件夹内。

    页面标题/描述/关键词

    设置页面标题

    设置页面主标题（会自动补全网站名称）

    1. @section('pageTitleMain')页面主标题@endsection

    设置页面关键词

    1. @section('pageKeywords')页面关键词@endsection

    设置页面描述

    1. @section('pageDescription')页面描述@endsection

    在Controller中调用

    1. return view('blade文件',[
    2.       'pageTitle' => '页面标题',
    3.       'pageTitleMain' => '页面主标题',
    4.       'pageKeywords' => '页面关键词',
    5.       'pageDescription' => '页面描述',
    6. ]);

    页面 JavaScript 会自动放在页面尾部（</body> 之前）

    引入行内 JavaScript

    1. ModStart::script('console.log("Hello ModStart");');

    引入一个 JavaScript 文件内容到页面

    1. ModStart::scriptFile('文件路径.js');

    引入一个 JavaScript 文件路径到页面

    1. ModStart::js('文件路径.js');

    页面 CSS

    页面 CSS 会自动放在头部（</head> 之前）

    引入 CSS 样式到页面

      引入一个 CSS 文件内容到页面

      1. ModStart::styleFile('文件路径.css');

      在 head 中追加内容

      1. @section('headAppend')
      2.     @parent
      3.     <!-- 需要追加到 head 中的内容 -->
      4. @endsection

      在 body 中追加内容

      1. @section('bodyAppend')
      3.     <!-- 需要追加到 body 中的内容 -->
      4. @endsection

      页面公共顶部和底部

      模块安装通常不会影响公共的顶部和底部，如果需要定制化可以根据具体业务需求修改 HTML 页面。

      • 公共顶部视图路径：resources/views/theme/default/pc/share/header.blade.php
      • 公共底部视图路径：resources/views/theme/default/pc/share/footer.blade.php

      显示数据

      你可以使用「中括号」包住变量以显示传递至 Blade 视图的数据。就如以下的路由设置一样：

      1. return view('welcome', ['name' => 'Samantha']);

      你可以像这样显示 name 变量的内容：

      1. Hello, {{ $name }}.

      显示数据或默认值

      1. {{ empty($name) ? '默认值' : $name }}

      当然也不是说一定只能显示传递至视图的变量内容。你也可以显示 PHP 函数的结果。实际上，你可以放置任何你想要的 PHP 代码到 Blade 显示的语法里面：

      1. 目前的 UNIX 时间戳为 {{ time() }}。

      你可以使用 @if、@elseif、@else 及 @endif 命令建构 if 表达式。这些命令的功能等同于在 PHP 中的语法：

      1. @if (count($records) === 1)
      2.     我有一条记录！
      3. @elseif (count($records) > 1)
      4.     我有多条记录！
      5. @else
      6.     我没有任何记录！
      7. @endif

      循环 for foreach

      除了条件表达式外，Blade 也支持 PHP 的循环结构：

      1. @for ($i = 0; $i < 10; $i++)
      2.     目前的值为 {{ $i }}
      3. @endfor
      5. @foreach ($users as $user)
      6.     <p>此用户为 {{ $user->id }}</p>
      7. @endforeach
      9. @forelse ($users as $user)
      10.     <li>{{ $user->name }}</li>
      11. @empty
      12.     <p>没有用户</p>
      14. @while (true)
      16. @endwhile

      定义页面布局

      使用 Blade 模板的两个主要优点为 模板继承 与 区块。

      让我们先通过一个简单的例子来上手。首先，我们需要确认一下「主要的」页面布局。大多数的网页应用程序在不同页面都保持着相同的布局方式，这种布局在这单个 Blade 视图中可以很方便的定义：

      1. <html>
      2.     <head>
      3.         <title>应用程序名称 - @yield('title')</title>
      4.     </head>
      5.     <body>
      6.         @section('sidebar')
      7.             这是主要的侧边栏。
      8.         @show
      10.         <div class="container">
      11.             @yield('content')
      12.         </div>
      13.     </body>
      14. </html>

      如你所见，这个文件包含了传统的 HTML 语法。不过，请注意 @section 与 @yield 命令。正如其名，@section 命令定义一个内容区块，而 @yield 命令被用来 “显示指定区块” 的内容。

      现在，我们已经定义好了这个应用程序的布局，让我们接着来定义一个继承此布局的子页面。

      继承页面布局

      在这个例子中，sidebar 区块利用了 @parent 命令增加（而不是覆盖）内容至布局的侧边栏。@parent 命令会在视图输出时被置换成布局的内容。

      大括号不转义输出

      由于许多 JavaScript 框架也使用「大括号」在浏览器中显示指定的表达式，因此可以使用 @ 符号来告知 Blade 渲染引擎该表达式应该维持原样。举个例子：

      1. <h1>Laravel</h1>
      3. Hello, @{{ name }}.

      在这个例子中，@ 符号会被 Blade 移除。而且，Blade 引擎会保留 表达式，如此一来便可跟其它 JavaScript 框架一起应用。

      在默认情况下，Blade 模板中的 表达式将会自动调用 PHP 的 htmlentities 函数，以避免 XSS 攻击。如果你不希望你的数据被转义，可以使用下列的语法：

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

      引入子视图

      Blade 的 @include 命令用来引入已存在的视图，所有在父视图的可用变量在被引入的视图中都是可用的。

      1. <div>
      2.     @include('share.header')
      3.     <form>
      4.         <!-- 表单内容 -->
      5.     </form>
      6. </div>

      尽管被引入的视图会继承父视图中的所有数据，你也可以通过传递额外的数组数据至被引入的页面：

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

      当数据存在时输出

      有时候你想要输出一个变量，但你并不确定这个变量是否已被设置。我们可以用像这样的冗长 PHP 代码表达：

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

      不过，Blade 提供了较方便的缩写来替代写三元运算符表达式：

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

      在这个例子中，如果 $name 变量存在，它的值将会被显示出来。但是，如果这个变量不存在，便会显示 Default。

      为集合渲染视图

      你可以使用 Blade 的 @each 命令将循环及引入结合成一行代码：

      1. @each('view.name', $jobs, 'job')

      第一个参数为每个元素要渲染的局部视图，第二个参数你要迭代的数组或集合，而第三个参数为迭代时被分配至视图中的变量名称。所以，举例来说，如果你要迭代一个 jobs 数组，通常你会希望在局部视图中通过 job 变量访问每一个 job。

      你也可以传递第四个参数至 @each 命令。此参数为当指定的数组为空时，将会被渲染的视图。

      1. @each('view.name', $jobs, 'job', 'view.empty')

      注释