Skip to content

视图

基本用法

视图包含应用程序提供的HTML,并作为将控制器和领域逻辑与表示逻辑分离的便捷方法。视图存储在resources/views目录中。

一个简单的视图如下所示:

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

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

可以像这样将视图返回给浏览器:

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

如您所见,传递给view助手的第一个参数对应于resources/views目录中视图文件的名称。传递给助手的第二个参数是一个数据数组,该数据应在视图中可用。

当然,视图也可以嵌套在resources/views目录的子目录中。例如,如果您的视图存储在resources/views/admin/profile.php,则应像这样返回:

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

向视图传递数据

php
// 使用常规方法
$view = view('greeting')->with('name', 'Victoria');

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

在上面的示例中,变量$name在视图中可访问,并包含Victoria

如果您愿意,可以将数据数组作为第二个参数传递给view助手:

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

以这种方式传递信息时,$data应为具有键/值对的数组。在视图中,您可以使用其对应的键来访问每个值,例如{{ $key }}(假设$data['key']存在)。

与所有视图共享数据

有时,您可能需要与应用程序呈现的所有视图共享一段数据。您有几种选择:view助手,Illuminate\Contracts\View\Factory 契约,或通配符视图作曲器

例如,使用view助手:

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

您也可以使用View facade:

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

通常,您会在服务提供者的boot方法中放置对share方法的调用。您可以将它们添加到AppServiceProvider中,或生成一个单独的服务提供者来容纳它们。

lightbulb

当不带参数调用view助手时,它返回Illuminate\Contracts\View\Factory契约的实现。

确定视图是否存在

如果需要确定视图是否存在,可以使用exists方法:

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

从文件路径返回视图

如果愿意,可以从完全限定的文件路径生成视图:

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

视图作曲器

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

定义视图作曲器

让我们在服务提供者中组织视图作曲器。我们将使用View facade来访问底层的Illuminate\Contracts\View\Factory契约实现:

php
<?php namespace App\Providers;

use 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()
	{
		//
	}

}
lightbulb

Laravel不包含视图作曲器的默认目录。您可以随意组织它们。例如,您可以创建一个App\Http\ViewComposers目录。

请记住,您需要将服务提供者添加到config/app.php配置文件中的providers数组中。

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

php
<?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方法将数据绑定到视图。

lightbulb

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

通配符视图作曲器

composer方法接受*字符作为通配符,因此您可以将作曲器附加到所有视图,如下所示:

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

将作曲器附加到多个视图

您还可以将视图作曲器附加到多个视图:

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

定义多个作曲器

您可以使用composers方法同时注册一组作曲器:

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

视图创建者

视图创建者的工作方式几乎与视图作曲器完全相同;然而,它们在视图实例化时立即触发。要注册视图创建者,请使用creator方法:

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