Laravel 8.x 中文文档

简体中文

English

简体中文

English

主题

视图 ​

介绍 ​

当然，从路由和控制器直接返回整个HTML文档字符串是不切实际的。幸运的是，视图提供了一种方便的方法来将所有HTML放在单独的文件中。视图将控制器/应用程序逻辑与表示逻辑分开，并存储在resources/views目录中。一个简单的视图可能如下所示：

html
<!-- View stored in resources/views/greeting.blade.php -->

<html>
    <body>
        <h1>Hello, {{ $name }}</h1>
    </body>
</html>

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

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

NOTE

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

创建和渲染视图 ​

您可以通过在应用程序的resources/views目录中放置一个带有.blade.php扩展名的文件来创建视图。.blade.php扩展名通知框架该文件包含一个Blade模板。Blade模板包含HTML以及Blade指令，允许您轻松地回显值、创建"if"语句、迭代数据等。

一旦创建了视图，您可以使用全局view助手从应用程序的路由或控制器返回它：

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

视图也可以使用View facade返回：

php
use Illuminate\Support\Facades\View;

return View::make('greeting', ['name' => 'James']);

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

嵌套视图目录 ​

视图也可以嵌套在resources/views目录的子目录中。"点"符号可以用来引用嵌套视图。例如，如果您的视图存储在resources/views/admin/profile.blade.php，您可以从应用程序的路由/控制器中返回它，如下所示：

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

NOTE

视图目录名称不应包含.字符。

创建第一个可用视图 ​

使用View facade的first方法，您可以创建给定视图数组中第一个存在的视图。如果您的应用程序或包允许视图自定义或覆盖，这可能会很有用：

php
use Illuminate\Support\Facades\View;

return View::first(['custom.admin', 'admin'], $data);

判断视图是否存在 ​

如果您需要判断视图是否存在，可以使用View facade。exists方法将返回true，如果视图存在：

php
use Illuminate\Support\Facades\View;

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

向视图传递数据 ​

如您在前面的示例中所见，您可以将数据数组传递给视图，以便该数据在视图中可用：

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

以这种方式传递信息时，数据应为键/值对的数组。在向视图提供数据后，您可以使用数据的键在视图中访问每个值，例如<?php echo $name; ?>。

作为将完整数据数组传递给view助手函数的替代方法，您可以使用with方法将单个数据添加到视图中。with方法返回视图对象的实例，以便您可以在返回视图之前继续链接方法：

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

与所有视图共享数据 ​

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

php
<?php

namespace App\Providers;

use Illuminate\Support\Facades\View;

class AppServiceProvider extends ServiceProvider
{
    /**
     * 注册任何应用程序服务。
     *
     * @return void
     */
    public function register()
    {
        //
    }

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

视图作曲器 ​

视图作曲器是在渲染视图时调用的回调或类方法。如果您希望在每次渲染视图时将数据绑定到视图，视图作曲器可以帮助您将逻辑组织到一个位置。如果同一个视图由应用程序中的多个路由或控制器返回，并且总是需要特定的数据，视图作曲器可能特别有用。

通常，视图作曲器将在应用程序的服务提供者中注册。在此示例中，我们假设我们创建了一个新的App\Providers\ViewServiceProvider来容纳此逻辑。

我们将使用View facade的composer方法注册视图作曲器。Laravel不包含类视图作曲器的默认目录，因此您可以自由地组织它们。例如，您可以创建一个app/View/Composers目录来容纳应用程序的所有视图作曲器：

php
<?php

namespace App\Providers;

use App\View\Composers\ProfileComposer;
use Illuminate\Support\Facades\View;
use Illuminate\Support\ServiceProvider;

class ViewServiceProvider extends ServiceProvider
{
    /**
     * 注册任何应用程序服务。
     *
     * @return void
     */
    public function register()
    {
        //
    }

    /**
     * 启动任何应用程序服务。
     *
     * @return void
     */
    public function boot()
    {
        // 使用类视图作曲器...
        View::composer('profile', ProfileComposer::class);

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

NOTE

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

现在我们已经注册了作曲器，每次渲染profile视图时，App\View\Composers\ProfileComposer类的compose方法将被执行。让我们看看作曲器类的示例：

php
<?php

namespace App\View\Composers;

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

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

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

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

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

将作曲器附加到多个视图 ​

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

php
use App\Views\Composers\MultiComposer;

View::composer(
    ['profile', 'dashboard'],
    MultiComposer::class
);

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

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

视图创建者 ​

视图"创建者"与视图作曲器非常相似；然而，它们在视图实例化后立即执行，而不是等到视图即将渲染时。要注册视图创建者，请使用creator方法：

php
use App\View\Creators\ProfileCreator;
use Illuminate\Support\Facades\View;

View::creator('profile', ProfileCreator::class);

优化视图 ​

默认情况下，Blade模板视图是按需编译的。当执行渲染视图的请求时，Laravel将确定视图的编译版本是否存在。如果文件存在，Laravel将确定未编译视图是否比编译视图更早修改。如果编译视图不存在，或者未编译视图已被修改，Laravel将重新编译视图。

在请求期间编译视图可能对性能有轻微的负面影响，因此Laravel提供了view:cache Artisan命令来预编译应用程序使用的所有视图。为了提高性能，您可能希望在部署过程中运行此命令：

php
php artisan view:cache

您可以使用view:clear命令清除视图缓存：

php
php artisan view:clear

版权所有 © 2024-2025 laravel.wiki