> For the complete documentation index, see [llms.txt](https://tips.laradoc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tips.laradoc.cn/views.md).
# 视图
## foreach 语句中的 $loop 变量
在 `foreach` 循环中，使用 `$loop` 变量来查看当前是否是第一次 / 最后一次循环。
```
@foreach ($users as $user)
@if ($loop->first)
This is the first iteration.
@endif
@if ($loop->last)
This is the last iteration.
@endif
This is user {{ $user->id }}
@endforeach
```
同样也有诸如 `$loop->iteration` 或 `$loop->count` 等属性。可以在 [官方文档](https://laravel.com/docs/master/blade#the-loop-variable) 中查看更多相关内容。
## 视图是否存在
你可以在视图实际加载之前确认该视图文件是否存在。
```php
if (view()->exists('custom.page')) {
// Load the view
}
```
你甚至可以使用一个数组来加载视图，这样只有第一个视图文件确实存在的视图会被加载。
```php
return view()->first(['custom.dashboard', 'dashboard'], $data);
```
## 错误代码视图页面
如果你想为一些特殊的 HTTP 返回码建立特定的错误页面，比如 `500` —— 只需要使用该码值创建视图文件，比如 `resources/views/errors/500.blade.php` ，或者是 `403.blade.php` 等等，这些视图会在对应的错误码出现时自动被加载。
## 脱离控制器的视图
如果你想让一个路由仅仅显示某个视图，不需要创建控制器，只需要使用 Route::view() 方法即可。
```php
// Instead of this
Route::get('about', 'TextsController@about');
// And this
class TextsController extends Controller
{
public function about()
{
return view('texts.about');
}
}
// Do this
Route::view('about', 'texts.about');
```
## Blade @auth 指令
不需要使用 if 来检查用户是否登录，使用 @auth 指令即可。
比较典型的方式是：
```
@if(auth()->user())
// The user is authenticated.
@endif
```
更短的用法：
```
@auth
// The user is authenticated.
@endauth
```
与 @auth 相对的是 @guest 指令：
```
@guest
// The user is not authenticated.
@endguest
```
## Blade 视图中的二级 $loop 变量
你甚至可以在 `Blade` 视图的二级 `foreach` 循环中使用 `$loop` 变量来表示外层的循环变量。
```
@foreach ($users as $user)
@foreach ($user->posts as $post)
@if ($loop->parent->first)
This is first iteration of the parent loop.
@endif
@endforeach
@endforeach
```
## 创建你自己的 Blade 指令
你只需要在 `app/Providers/AppServiceProvider.php` 中添加你自己的方法。举个例子，如果你需要将 ` ` 标签替换为换行：
```
```
然后将这个指令添加到 `AppServiceProvider` 的 `boot()` 方法中：
```php
public function boot()
{
Blade::directive('br2nl', function ($string) {
return "/i', \"\n\", $string); ?>";
});
}
```
## 视图指令 IncludeIf IncludeWhen IncludeFirst
如果你不确定 Blade 文件是否存在，你可以使用这些条件指令。 仅当 Blade 文件存在时载入 header：
```
@includeIf('partials.header')
```
仅当用户的 role\_id == 1 的时候载入 header：
```
@includeWhen(auth()->user()->role_id == 1, 'partials.header')
```
尝试加载 adminlte.header ，如果不存在，则加载 default.header：
```
@includeFirst('adminlte.header', 'default.header')
```
## 使用 Laravel Blade-X 变量绑定节省更多空间
```php
// Using include, the old way
@include("components.post", ["title" => $post->title])
// Using Blade-X
// Using Blade-X variable binding
```
由 [@anwar\_nairi](https://twitter.com/anwar_nairi/status/1442441888787795970) 提供
## Blade 组件属性
```php
// button.blade.php
@props(['rounded' => false])
// view.blade.php
// Non-rounded:
Submit
// Rounded:
Submit
```
由 [@godismyjudge95](https://twitter.com/godismyjudge95/status/1448825909167931396) 提供
## Blade 类型提示
```php
@php
/* @var App\Models\User $user */
@endphp
// your ide will typehint the property for you
{{$user->email}}
```
由 [@freekmurze](https://twitter.com/freekmurze/status/1455466663927746560) 提供
## 组件语法提示
在组件参数之前传入 `:` 你可以直接传入变量而不需要使用 `{{}}`表达式
```php
// you can do instead
```
由 [@sky\_0xs](https://twitter.com/sky_0xs/status/1457056634363072520) 提供
## 自动高亮导航链接
当精确的URL匹配或传递路径或路由名称模式时，自动突出显示导航链接
带有请求和CSS类助手的 `blade` 组件使显示活动/非活动状态变得非常简单。
```php
class NavLink extends Component
{
public function __construct($href, $active = null)
{
$this->href = $href;
$this->active = $active ?? $href;
}
public function render(): View
{
$classes = ['font-medium', 'py-2', 'text-primary' => $this->isActive()];
return view('components.nav-link', [
'class' => Arr::toCssClasses($classes);
]);
}
protected function isActive(): bool
{
if (is_bool($this->active)) {
return $this->active;
}
if (request()->is($this->active)) {
return true;
}
if (request()->fullUrlIs($this->active)) {
return true;
}
return request()->routeIs($this->active);
}
}
```
```
class($class) }}>
{{ $slot }}
```
```
ProjectsProjectsProjectsProjects
```
由 [@mpskovvang](https://twitter.com/mpskovvang/status/1459646197635944455) 提供
## 简化循环
你知道 Blade `@each` 指令可以帮助清理模板中的循环吗？
```
// good
@foreach($item in $items)
@endforelse
```
由 \[@alexjgarrett] 提供
## 已检查的 Blade 指令
在 Laravel 9中, 你将能够使用很酷的新 "checked" Blade 指令。
这将是一个很好的补充，我们可以用它来清理一下我们的 Blade 视图
```php
// Before Laravel 9:
active) ? 'checked' : '' }}/>
active) ? '' : 'checked' }}/>
// Laravel 9
active))/>
active))/>
```
由 [@AshAllenDesign](https://twitter.com/AshAllenDesign/status/1489567000812736513) 提供
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tips.laradoc.cn/views.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.