Skip to content

Latest commit

 

History

History
202 lines (135 loc) · 6.2 KB

views.md

File metadata and controls

202 lines (135 loc) · 6.2 KB
Raw

视图 (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) 解析，所以你需要在视图组件的构造器类型限制你所需的任何依赖参数。

在视图组件内使用通配符

View 的 composer 方法可以接受 * 作为通配符，所以你可以对所有视图附加 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');