在 laravel blade 的 foreach 循环中，若通过 @if 条件过滤数据，原生 $loop->odd / $loop->even 将失效（因其基于原始数组索引而非实际渲染项）。本文提供可靠解决方案：使用自定义计数器实现精准的奇偶交替布局。
在 laravel blade 的 foreach 循环中，若通过 @if 条件过滤数据，原生 $loop->odd / $loop->even 将失效（因其基于原始数组索引而非实际渲染项）。本文提供可靠解决方案：使用自定义计数器实现精准的奇偶交替布局。
当需要在 Blade 模板中遍历数据并仅渲染满足特定条件的条目（如 featured == 1 且非首页引用）时，直接依赖 $loop->odd 或 $loop->even 会导致样式错乱——因为这些变量反映的是原始循环迭代序号，而非实际渲染的第几个有效项。例如，若第 1、2、4 个 $references 元素通过了 @if 检查，则它们分别被标记为 odd、even、even，破坏了视觉上的交替节奏。
✅ 正确做法是：引入独立计数器，仅对成功渲染的项递增，并基于该计数器判断奇偶性。
以下为优化后的 Blade 代码示例：
@php $featuredCount = 0; @endphp
@foreach ($references as $reference)
@if(
isset($reference['is_startpage'])
&& $reference['is_startpage'] != 1
&& isset($reference['content']['featured'])
&& $reference['content']['featured'] == 1
)
@php $featuredCount++; @endphp
<div @class([
'row py-5',
'flex-row-reverse' => $featuredCount % 2 === 0,
])>
<!-- 此处可插入引用内容，如标题、图片等 -->
<h3>{{ $reference['title'] ?? 'Untitled' }}</h3>
</div>
@endif
@endforeach? 关键说明：
- @php $featuredCount = 0; @endphp 在循环外初始化计数器，确保作用域清晰；
- 每次进入 @if 块并准备渲染时执行 $featuredCount++，保证计数严格对应「已展示」的条目；
- 使用 $featuredCount % 2 === 0 判断“逻辑偶数位”（即第 2、4、6…个有效项），简洁可靠；
- @class 数组语法中，基础类名（如 'row py-5'）始终存在，仅 'flex-row-reverse' 动态切换，语义更清晰、性能更优。
⚠️ 注意事项：
- 避免在 Blade 中嵌套复杂 PHP 逻辑；若过滤逻辑较重（如多层嵌套判断或数据库关联），建议提前在控制器中完成数据预处理（例如使用 collect($references)->filter(...)->values()），提升模板可读性与维护性；
- 计数器变量名应具语义（如 $featuredCount 而非 $i），便于团队协作理解；
- 若需支持响应式反转（如移动端取消 flex-row-reverse），可将该类移至 CSS 媒体查询中，而非 Blade 条件控制。
通过该方案，无论原始数据集如何变化，只要满足条件的条目顺序不变，其视觉呈现的奇偶交替效果就始终保持准确、稳定与可预测。
