视图
基本用法
视图包含应用程序提供的 HTML,并将控制器/应用程序逻辑与表示逻辑分离。视图存储在 resources/views
目录中。
一个简单的视图可能如下所示:
<!-- 视图存储在 resources/views/greeting.php -->
<html>
<body>
<h1>Hello, <?php echo $name; ?></h1>
</body>
</html>
由于此视图存储在 resources/views/greeting.php
,我们可以使用全局 view
辅助函数返回它,如下所示:
Route::get('/', function () {
return view('greeting', ['name' => 'James']);
});
如您所见,传递给 view
辅助函数的第一个参数对应于 resources/views
目录中视图文件的名称。传递给辅助函数的第二个参数是一个数据数组,该数据应在视图中可用。在此示例中,我们传递了 name
变量,该变量通过简单地在视图中执行 echo
来显示。
当然,视图也可以嵌套在 resources/views
目录的子目录中。可以使用“点”符号引用嵌套视图。例如,如果您的视图存储在 resources/views/admin/profile.php
,您可以这样引用它:
return view('admin.profile', $data);
确定视图是否存在
如果需要确定视图是否存在,可以在不带参数调用 view
辅助函数后使用 exists
方法。如果视图在磁盘上存在,此方法将返回 true
:
if (view()->exists('emails.customer')) {
//
}
当不带参数调用 view
辅助函数时,将返回 Illuminate\Contracts\View\Factory
的实例,从而可以访问工厂的任何方法。
视图数据
向视图传递数据
如您在前面的示例中所见,您可以轻松地将数据数组传递给视图:
return view('greetings', ['name' => 'Victoria']);
以这种方式传递信息时,$data
应为键/值对数组。在视图中,您可以使用相应的键访问每个值,例如 <?php echo $key; ?>
。作为将完整数据数组传递给 view
辅助函数的替代方法,您可以使用 with
方法将单个数据添加到视图中:
$view = view('greeting')->with('name', 'Victoria');
与所有视图共享数据
有时,您可能需要与应用程序呈现的所有视图共享一段数据。您可以使用视图工厂的 share
方法来实现。通常,您会在服务提供者的 boot
方法中放置对 share
的调用。您可以将它们添加到 AppServiceProvider
或生成单独的服务提供者来容纳它们:
<?php
namespace App\Providers;
class AppServiceProvider extends ServiceProvider
{
/**
* 启动任何应用程序服务。
*
* @return void
*/
public function boot()
{
view()->share('key', 'value');
}
/**
* 注册服务提供者。
*
* @return void
*/
public function register()
{
//
}
}
视图作曲器
视图作曲器是在视图呈现时调用的回调或类方法。如果您希望在每次呈现视图时将数据绑定到视图,视图作曲器可以帮助您将该逻辑组织到一个位置。
让我们在服务提供者中注册我们的视图作曲器。我们将使用 view
辅助函数访问底层的 Illuminate\Contracts\View\Factory
合约实现。请记住,Laravel 不包含视图作曲器的默认目录。您可以随意组织它们。例如,您可以创建一个 App\Http\ViewComposers
目录:
<?php
namespace App\Providers;
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()
{
//
}
}
请记住,如果您创建了一个新的服务提供者来包含视图作曲器注册,您需要将服务提供者添加到 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
{
/**
* 用户存储库实现。
*
* @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\Contracts\View\View
实例调用。您可以使用 with
方法将数据绑定到视图。
所有视图作曲器都是通过服务容器解析的,因此您可以在作曲器的构造函数中类型提示任何所需的依赖项。
将作曲器附加到多个视图
您可以通过将视图数组作为 composer
方法的第一个参数传递来将视图作曲器附加到多个视图:
view()->composer(
['profile', 'dashboard'],
'App\Http\ViewComposers\MyViewComposer'
);
composer
方法接受 *
字符作为通配符,允许您将作曲器附加到所有视图:
view()->composer('*', function ($view) {
//
});
视图创建者
视图创建者与视图作曲器非常相似;然而,它们在视图实例化时立即触发,而不是等到视图即将呈现时。要注册视图创建者,请使用 creator
方法:
view()->creator('profile', 'App\Http\ViewCreators\ProfileCreator');