视图 (View)

基本用法

视图里面包含了你应用程序所提供的 HTML 代码,并且提供一个简单的方式来分离控制器和网页呈现上的逻辑。视图被保存在 resources/views 文件夹内。

一个简单的视图看起来可能像这样:

<!-- 视图被保存在 resources/views/greeting.php -->

<html>
    <body>
        <h1>Hello, <?php echo $name; ?></h1>
    </body>
</html>

这个视图可以使用以下的代码传递到用户的浏览器:

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

如你所见,view 辅助方法的第一个参数会对应到 resources/views 文件夹内视图文件的名称;传递到 view 辅助方法的第二个参数是一个能够在视图内取用的数据数组。

当然,视图文件也可以被存放在 resources/views 的子文件夹内。举例来说,如果你的视图文件保存在 resources/views/admin/profile.php,你可以用以下的代码来返回:

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

传递数据到视图

// 使用传统的方法
$view = view('greeting')->with('name', 'Victoria');

// 使用魔术方法
$view = view('greeting')->withName('Victoria');

在上面的例子代码中,视图将可以使用 $name 来取得数据,其值为 Victoria

如果你想的话,还有一种方式就是直接在 view 辅助方法的第二个参数直接传递一个数组:

$view = view('greetings', $data);

把数据共享给所有视图

有时候你可能需要共享一些数据给你的所有视图,你有很多个选择:view 辅助方法;Illuminate\Contracts\View\Factory 合约 (contract);在 视图组件 (view composer) 内使用通配符。

这里有个 view 辅助方法的例子:

view()->share('data', [1, 2, 3]);

你也可以使用 view 的 Facade:

View::share('data', [1, 2, 3]);

通常你应该在服务提供者的 boot 方法内使用 share 方法。你可以选择加在 AppServiceProvider 或者是新建一个单独的服务提供者来容纳这些代码。

备注:view 辅助方法没有带入任何参数调用时,它将会返回一个的 Illuminate\Contracts\View\Factory 合约 (contract) 的实现 (implementation)。

确认视图是否存在

如果你需要确认视图是否存在,使用 exists 方法:

if (view()->exists('emails.customer'))
{
    //
}

从一个文件路径产生视图

你可以从一个完整的文件路径来产生一个视图:

return view()->file($pathToFile, $data);

视图组件

视图组件就是在视图被渲染前,会调用的闭包或类方法。如果你想在每次渲染某些视图时绑定数据,视图组件可以把这样的程序逻辑组织在同一个地方。

定义一个视图组件

让我们在 服务提供者 内组织我们的视图组件。底下例子将使用 View Facade 来取得底层 Illuminate\Contracts\View\Factory 合约的实现:

<?php namespace App\Providers;

use View;
use Illuminate\Support\ServiceProvider;

class ComposerServiceProvider extends ServiceProvider {

    /**
     * Register bindings in the container.
     *
     * @return void
     */
    public function boot()
    {
        // 使用类来指定视图组件
        View::composer('profile', 'App\Http\ViewComposers\ProfileComposer');

        // 使用闭包来指定视图组件
        View::composer('dashboard', function()
        {

        });
    }

    /**
     * Register
     *
     * @return void
     */
    public function register()
    {
        //
    }

}

备注: Laravel 没有默认的文件夹来放置类形式的视图组件。你可以自由的把它们放在你想要的地方。举例来说,你可以放在 App\Http\ViewComposers 文件夹内。

记得要把这个服务提供者添加到 config/app.php 配置文件的 providers 数组中。

现在我们已经注册了视图组件,并且在每次 profile 视图渲染的时候,ProfileComposer@compose 都将会被执行。接下来我们来看看这个类要如何定义:

<?php namespace App\Http\ViewComposers;

use Illuminate\Contracts\View\View;
use Illuminate\Users\Repository as UserRepository;

class ProfileComposer {

    /**
     * The user repository implementation.
     *
     * @var UserRepository
     */
    protected $users;

    /**
     * Create a new profile composer.
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        // service container 会自动解析所需的参数
        $this->users = $users;
    }

    /**
     * Bind data to the view.
     *
     * @param  View  $view
     * @return void
     */
    public function compose(View $view)
    {
        $view->with('count', $this->users->count());
    }

}

在视图被渲染之前,视图组件的 compose 方法就会被调用,并且传入一个 Illuminate\Contracts\View\View 实例。你可以使用 with 方法来把数据绑定到 view

备注: 所有的视图组件会被 服务容器 (service container) 解析,所以你需要在视图组件的构造器类型限制你所需的任何依赖参数。

在视图组件内使用通配符

Viewcomposer 方法可以接受 * 作为通配符,所以你可以对所有视图附加 composer 如下:

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

同时对多个视图附加视图组件

你也可以同时针对多个视图附加同一个视图组件:

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

定义多个视图组件

你可以使用 composers 方法来同时定义一群视图组件:

View::composers([
    'App\Http\ViewComposers\AdminComposer' => ['admin.index', 'admin.profile'],
    'App\Http\ViewComposers\UserComposer' => 'user',
    'App\Http\ViewComposers\ProductComposer' => 'product'
]);

视图创建者

视图 创建者 几乎和视图组件运作方式一样;只是视图创建者会在视图初始化后就立刻执行。要注册一个创建者,只要使用 creator 方法:

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