基本的な使用法Basic Usage
ビューはアプリケーションとして動作するHTMLにより構成されており、コントローラー／アプリケーションロジックをプレゼンテーションロジックから分離します。ビューはresources/viewsディレクトリーに保存します。Views contain the HTML served by your application and separate your controller / application logic from your presentation logic. Views are stored in the resources/views directory.
シンプルなビューは、以下のような形態です。A simple view might look something like this:
<!-- resources/views/greeting.phpとして保存されているビュー -->
<html>
<body>
<h1>Hello, <?php echo $name; ?></h1>
</body>
</html>
このビューをresources/views/greeting.phpとして保存した場合、以下のようにグローバルviewヘルパ関数を使用し結果を返します。Since this view is stored at resources/views/greeting.php, we may return it using the global view helper function like so:
Route::get('/', function () {
return view('greeting', ['name' => 'James']);
});
ご覧の通り、viewヘルパに渡している最初の引数は、resources/viewsディレクトリー中のビューファイル名に対応しています。２つ目の引数は、ビューで使用するデータの配列です。この場合、変数をただechoし、ビューで表示するためのname変数を渡しています。As you can see, the first argument passed to the view helper corresponds to the name of the view file in the resources/views directory. The second argument passed to helper is an array of data that should be made available to the view. In this case, we are passing the name variable, which is displayed in the view by simply executing echo on the variable.
もちろん、ビューはresources/viewsディレクトリーのサブディレクトリーにネストすることもできます。ネストしたビューを参照するために「ドット」記法が使えます。例えば、ビューがresources/views/admin/profile.phpとして保存するなら、次のように指定します。Of course, views may also be nested within sub-directories of the resources/views directory. "Dot" notation may be used to reference nested views. For example, if your view is stored at resources/views/admin/profile.php, you may reference it like so:
return view('admin.profile', $data);
ビューの存在を検査Determining If A View Exists
ビューが存在しているかを判定する必要があれば、viewヘルパを引数無しで呼び出した後に続けて、existsメソッドを使用します。このメソッドはビューが存在している場合にtrueを返します。If you need to determine if a view exists, you may use the exists method after calling the view helper with no arguments. This method will return true if the view exists on disk:
if (view()->exists('emails.customer')) {
//
}
viewヘルパが引数無しで呼び出されると、Illuminate\Contracts\View\Factoryのインスタンスが返されますので、ファクトリーのメソッドが利用できます。When the view helper is called without arguments, an instance of Illuminate\Contracts\View\Factory is returned, giving you access to any of the factory's methods.
ビューデータView Data
ビューにデータを渡すPassing Data To Views
前例で見たように、簡単にデータをビューに渡せます。As you saw in the previous examples, you may easily pass an array of data to views:
return view('greetings', ['name' => 'Victoria']);
この方法で情報を渡す場合、$dataはキー／値ペアの配列です。ビューの中で各値へは対抗するキーでアクセスできます。たとえば<?php echo $key; ?>のように表示可能です。全データをviewヘルパ関数に渡す代わりに、withメソッドでビューに渡すデータを個別に追加することもできます。When passing information in this manner, $data should be an array with key/value pairs. Inside your view, you can then access each value using its corresponding key, such as <?php echo $key; ?>. As an alternative to passing a complete array of data to the view helper function, you may use the with method to add individual pieces of data to the view:
$view = view('greeting')->with('name', 'Victoria');
全ビューでデータを共有するSharing Data With All Views
アプリケーションの全ビューで使用するデータを共有したい場合も時々あるでしょう。ビューファクトリーのshareメソッドが使用できます。通常、サービスプロバイダーのbootメソッドの中で呼び出します。AppServiceProviderに追加することできますし、別のプロバイダーを生成し設置することもできます。Occasionally, you may need to share a piece of data with all views that are rendered by your application. You may do so using the view factory's share method. Typically, you would place calls to share within a service provider's boot method. You are free to add them to the AppServiceProvider or generate a separate service provider to house them:
<?php
namespace App\Providers;
class AppServiceProvider extends ServiceProvider
{
/**
* アプリケーションサービスの初期処理
*
* @return void
*/
public function boot()
{
view()->share('key', 'value');
}
/**
* サービスプロバイダー登録
*
* @return void
*/
public function register()
{
//
}
}
ビューコンポーサーView Composers
ビューコンポーサーはビューがレンダーされる時に呼び出される、コールバックかクラスメソッドのことです。ビューがレンダーされるたびに結合したい情報があるなら、ビューコンポーサーがロジックを一箇所にまとめるのに役立ちます。View composers are callbacks or class methods that are called when a view is rendered. If you have data that you want to be bound to a view each time that view is rendered, a view composer can help you organize that logic into a single location.
サービスプロバイダーの中にビューコンポーサーを組み込みましょう。Viewファサードで動作しているIlluminate\Contracts\View\Factory契約の実装にアクセスします。Laravelにはデフォルトのビューコンポーサー置き場を用意していないことに注意してください。お好きな場所に置くことができます。たとえばApp\Http\ViewComposersディレクトリーを作成することもできます。Let's register our view composers within a service provider[/docs/{{version}}/providers]. We'll use the view helper to access the underlying Illuminate\Contracts\View\Factory contract implementation. Remember, Laravel does not include a default directory for view composers. You are free to organize them however you wish. For example, you could create an App\Http\ViewComposers directory:
<?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配列へ追加する必要があるのを忘れないでください。Remember, if you create a new service provider to contain your view composer registrations, you will need to add the service provider to the providers array in the config/app.php configuration file.
ではprofileビューがレンダーされるたび実行される、ProfileComposer@composeメソッドをコンポーサーとして登録してみましょう。まず、このコンポーサークラスを定義します。Now that we have registered the composer, the ProfileComposer@compose method will be executed each time the profile view is being rendered. So, let's define the composer class:
<?php
namespace App\Http\ViewComposers;
use Illuminate\Contracts\View\View;
use Illuminate\Users\Repository as UserRepository;
class ProfileComposer
{
/**
* userリポジトリの実装
*
* @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());
}
}
ビューがレンダーされる直前に、Illuminate\View\Viewインスタンスに対しコンポーサーのcomposeメソッドが呼びだされます。Just before the view is rendered, the composer's compose method is called with the Illuminate\Contracts\View\View instance. You may use the with method to bind data to the view.
注目： すべてのビューコンポーサーはサービスコンテナにより依存解決されます。ですから、コンポーサーのコンストラクターで必要な依存をタイプヒントで指定できます。Note: All view composers are resolved via the service container[/docs/{{version}}/container], so you may type-hint any dependencies you need within a composer's constructor.
複数ビューへの適用Attaching A Composer To Multiple Views
複数のビューにビューコンポーサーを適用するには、composerメソッドの最初の引数にビューの配列を渡してください。You may attach a view composer to multiple views at once by passing an array of views as the first argument to the composer method:
view()->composer(
['profile', 'dashboard'],
'App\Http\ViewComposers\MyViewComposer'
);
全ビューコンポーサーに適用できるように、composerメソッドでは*をワイルドカードとして使用できます。The composer method accepts the * character as a wildcard, allowing you to attach a composer to all views:
view()->composer('*', function ($view) {
//
});
ViewクリエーターView Creators
ビュークリエイターは、ビューコンポーサーとほぼ同じ働きをします。しかし、ビューがレンダーされるまで待つのではなく、インスタンス化されるとすぐに実行されます。ビュークリエイターを登録するには、creatorメソッドを使います。View creators are very similar to view composers; however, they are fired immediately when the view is instantiated instead of waiting until the view is about to render. To register a view creator, use the creator method:
view()->creator('profile', 'App\Http\ViewCreators\ProfileCreator');