Laravel Blade：使用@forelse实现空数据时的优雅提示

在web应用开发中，从数据库获取数据并展示是常见操作。然而，当查询结果为空时，如何向用户提供友好的反馈，而不是显示一个空白区域，是一个需要妥善处理的细节。laravel blade模板引擎为我们提供了强大的工具来应对这类挑战。

控制器层的数据准备

首先，我们来看控制器如何从数据库获取数据并将其传递给视图。这是一个典型的例子，查询当前用户关联的角色信息：

public function mycharacters()
{
    $id = Auth::id();
    // 查询当前用户关联的角色信息
    // Player::where('account_id', $id)->get() 会返回一个 Illuminate\Support\Collection 实例
    // 即使没有找到匹配的记录，它也会返回一个空的 Collection，而不是 null。
    $userCharacters = Player::where('account_id', $id)->get();

    // 将查询结果传递给视图，变量名为 'user'
    return view('user.characters')->with('user', $userCharacters);
}

在上述代码中，$userCharacters变量被赋值为数据库查询的结果。即使没有找到任何匹配项，get()方法也会返回一个空的Collection对象，这对于Blade模板的处理至关重要。

传统@foreach的局限性

在Blade模板中，开发者可能会尝试在@foreach循环内部通过@if条件判断来处理空数据的情况，如下所示：

<h1 class="text-light">My Characters</h1>
@foreach ($user as $u)
    {{-- 这里的判断是针对集合中每个元素的特定属性（如 $u->name），
         而非集合本身是否为空。 --}}
    @if ($u->name !== "")
        <h1 class="text-light">{{ $u->name }}</h1>
    @else
        {{-- 如果 $u->name 为空字符串，则显示此消息 --}}
        <h1 class="text-light">I have not found anything!</h1>
    @endif
@endforeach

这种方法存在一个核心问题：如果$user集合本身是空的（即数据库中没有找到任何角色），那么@foreach ($user as $u)循环将根本不会执行。这意味着，无论@if还是其对应的@else块都不会被渲染。结果是，当没有数据时，页面上除了“My Characters”标题外，不会显示任何“I have not found anything!”的提示，用户会看到一个空白区域，这并非我们所期望的用户体验。

解决方案：使用@forelse指令

Laravel Blade提供了一个专门用于解决此问题的指令：@forelse。它结合了@foreach和@if的功能，允许您在循环遍历集合的同时，为集合为空的情况提供一个备用内容块。

@forelse的语法结构如下：

@forelse ($collection as $item)
    {{-- 当 $collection 不为空时，遍历每个 $item 并执行此处的代码 --}}
    ...
@empty
    {{-- 当 $collection 为空时（包括 null 或空 Collection），执行此处的代码 --}}
    ...
@endforelse

将上述示例中的Blade代码修改为使用@forelse：

<h1 class="text-light">My Characters</h1>
@forelse ($user as $u)
    {{-- 当 $user 集合不为空时，遍历并显示每个用户的名称 --}}
    <h1 class="text-light">{{ $u->name }}</h1>
@empty
    {{-- 当 $user 集合为空时，显示此消息 --}}
    <h1 class="text-light">I have not found anything!</h1>
@endforelse

现在，如果$user集合中包含数据，@forelse将像普通的@foreach一样遍历每个$u并显示其名称。然而，如果$user集合是空的（无论是空的Collection还是null），@empty块中的内容（即“I have not found anything!”）将被渲染出来。这完美解决了空数据提示的问题。

SpeakingPass-打造你的专属雅思口语语料

使用chatGPT帮你快速备考雅思口语，提升分数

25

查看详情

@forelse的优势与注意事项

• 代码简洁性与可读性: @forelse提供了一种声明式的方式来处理空集合，使代码意图更加清晰，避免了额外的@if (count($collection) > 0)判断，提高了代码的整洁度。

• Laravel惯例: 它是Laravel推荐的、更符合框架设计哲学的处理方式，有助于保持代码风格的一致性。

• 与@if结合使用: 即使在使用@forelse时，您仍然可以在@forelse内部（即@empty块之前）使用@if指令来处理集合中单个元素的特定条件。例如，如果$u->name可能为空字符串，您仍需在@forelse内部进行判断：

  @forelse ($user as $u)
      @if (!empty($u->name)) {{-- 检查单个元素的name是否为空 --}}
          <h1 class="text-light">{{ $u->name }}</h1>
      @else
          <p>角色名称未设置</p>
      @endif
  @empty
      <h1 class="text-light">I have not found anything!</h1>
  @endforelse

  登录后复制

  这强调了@forelse是处理集合整体是否为空，而内部的@if是处理集合中每个元素的特定属性。

• 处理null值: 虽然get()方法通常返回Collection实例，但如果您的变量可能被设置为null（例如，通过某些逻辑判断或返回了null），@forelse也能很好地处理这种情况，它会将null视为空集合。

总结

在Laravel Blade模板中处理数据集合时，@forelse指令是显示“无数据”提示的最佳实践。它不仅提高了代码的可读性和简洁性，还确保了在集合为空时能够优雅地向用户展示信息，从而显著提升了用户体验。掌握并运用@forelse是每个Laravel开发者必备的技能之一，它能帮助您构建更加健壮和用户友好的应用程序。

以上就是Laravel Blade：使用@forelse实现空数据时的优雅提示的详细内容，更多请关注php中文网其它相关文章！