Skip to content

视图

创建视图

lightbulb

想了解更多关于如何编写 Blade 模板的信息?请查看完整的 Blade 文档 以开始。

视图包含应用程序提供的 HTML,并将控制器/应用程序逻辑与表示逻辑分开。视图存储在 resources/views 目录中。一个简单的视图可能如下所示:

php
<!-- 视图存储在 resources/views/greeting.blade.php -->

<html>
    <body>
        <h1>你好,{{ $name }}</h1>
    </body>
</html>

由于此视图存储在 resources/views/greeting.blade.php,我们可以使用全局 view 辅助函数返回它,如下所示:

php
Route::get('/', function () {
    return view('greeting', ['name' => 'James']);
});

如您所见,传递给 view 辅助函数的第一个参数对应于 resources/views 目录中视图文件的名称。第二个参数是一个数据数组,该数据应在视图中可用。在此示例中,我们传递了 name 变量,该变量使用 Blade 语法 在视图中显示。

当然,视图也可以嵌套在 resources/views 目录的子目录中。可以使用“点”符号引用嵌套视图。例如,如果您的视图存储在 resources/views/admin/profile.blade.php,您可以这样引用它:

php
return view('admin.profile', $data);

确定视图是否存在

如果需要确定视图是否存在,可以使用 View facade。exists 方法将返回 true,如果视图存在:

php
use Illuminate\Support\Facades\View;

if (View::exists('emails.customer')) {
    //
}

向视图传递数据

如您在前面的示例中所见,您可以将数据数组传递给视图:

php
return view('greetings', ['name' => 'Victoria']);

以这种方式传递信息时,数据应为键/值对的数组。在视图中,您可以使用其对应的键访问每个值,例如 <?php echo $key; ?>。作为将完整数据数组传递给 view 辅助函数的替代方法,您可以使用 with 方法将单个数据添加到视图中:

php
return view('greeting')->with('name', 'Victoria');

与所有视图共享数据

有时,您可能需要与应用程序呈现的所有视图共享一段数据。您可以使用视图 facade 的 share 方法来实现。通常,您应该在服务提供者的 boot 方法中放置对 share 的调用。您可以将它们添加到 AppServiceProvider 或生成单独的服务提供者来容纳它们:

php
<?php

namespace App\Providers;

use Illuminate\Support\Facades\View;

class AppServiceProvider extends ServiceProvider
{
    /**
     * 启动任何应用程序服务。
     *
     * @return void
     */
    public function boot()
    {
        View::share('key', 'value');
    }

    /**
     * 注册服务提供者。
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

视图作曲器

视图作曲器是在视图呈现时调用的回调或类方法。如果您有数据希望在每次呈现视图时绑定到视图,视图作曲器可以帮助您将该逻辑组织到一个位置。

在此示例中,让我们在 服务提供者 中注册视图作曲器。我们将使用 View facade 访问底层的 Illuminate\Contracts\View\Factory 合约实现。请记住,Laravel 不包含视图作曲器的默认目录。您可以自由地组织它们。例如,您可以创建一个 app/Http/ViewComposers 目录:

php
<?php

namespace App\Providers;

use Illuminate\Support\Facades\View;
use Illuminate\Support\ServiceProvider;

class ComposerServiceProvider extends ServiceProvider
{
    /**
     * 在容器中注册绑定。
     *
     * @return void
     */
    public function boot()
    {
        // 使用基于类的作曲器...
        View::composer(
            'profile', 'App\Http\ViewComposers\ProfileComposer'
        );

        // 使用基于闭包的作曲器...
        View::composer('dashboard', function ($view) {
            //
        });
    }

    /**
     * 注册服务提供者。
     *
     * @return void
     */
    public function register()
    {
        //
    }
}
exclamation

请记住,如果您创建了一个新的服务提供者来包含视图作曲器注册,您需要将服务提供者添加到 config/app.php 配置文件中的 providers 数组中。

现在我们已经注册了作曲器,每次 profile 视图被呈现时,ProfileComposer@compose 方法将被执行。因此,让我们定义作曲器类:

php
<?php

namespace App\Http\ViewComposers;

use Illuminate\View\View;
use App\Repositories\UserRepository;

class ProfileComposer
{
    /**
     * 用户仓库实现。
     *
     * @var UserRepository
     */
    protected $users;

    /**
     * 创建一个新的配置文件作曲器。
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        // 依赖关系由服务容器自动解析...
        $this->users = $users;
    }

    /**
     * 将数据绑定到视图。
     *
     * @param  View  $view
     * @return void
     */
    public function compose(View $view)
    {
        $view->with('count', $this->users->count());
    }
}

在视图呈现之前,作曲器的 compose 方法会被调用,并传入 Illuminate\View\View 实例。您可以使用 with 方法将数据绑定到视图。

lightbulb

所有视图作曲器都是通过 服务容器 解析的,因此您可以在作曲器的构造函数中类型提示任何所需的依赖项。

将作曲器附加到多个视图

您可以通过将视图数组作为 composer 方法的第一个参数传递,将视图作曲器附加到多个视图:

php
View::composer(
    ['profile', 'dashboard'],
    'App\Http\ViewComposers\MyViewComposer'
);

composer 方法还接受 * 字符作为通配符,允许您将作曲器附加到所有视图:

php
View::composer('*', function ($view) {
    //
});

视图创建者

视图创建者与视图作曲器非常相似;然而,它们在视图实例化后立即执行,而不是等待视图即将呈现时。要注册视图创建者,请使用 creator 方法:

php
View::creator('profile', 'App\Http\ViewCreators\ProfileCreator');