Laravel Blade
Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:
- fuse-ai-pilot:explore-codebase - Check existing views, components structure
- fuse-ai-pilot:research-expert - Verify latest Blade docs via Context7
- mcp__context7__query-docs - Query specific patterns (components, slots)
After implementation, run fuse-ai-pilot:sniper for validation.
Overview
Blade is Laravel's templating engine. It provides a clean syntax for PHP in views while compiling to pure PHP for performance.
| Component Type |
When to Use |
| Anonymous |
Simple UI, no logic needed |
| Class-based |
Dependency injection, complex logic |
| Layout |
Page structure, reusable shells |
| Dynamic |
Runtime component selection |
Critical Rules
- Always escape output - Use
{{ }} not {!! !!} unless absolutely necessary
- Use @props - Declare expected props explicitly
- Merge attributes - Allow class/attribute overrides with
$attributes->merge()
- Prefer anonymous - Use class components only when logic is needed
- Use named slots - For complex layouts with multiple content areas
- CSRF in forms - Always include
@csrf in forms
Decision Guide
Component Type Selection
Need dependency injection?
├── YES → Class-based component
└── NO → Anonymous component
│
Need complex props logic?
├── YES → Class-based component
└── NO → Anonymous component
Layout Strategy
Simple page structure?
├── YES → Component layout (<x-layout>)
└── NO → Need fine-grained sections?
├── YES → @extends/@section
└── NO → Component layout
Key Concepts
| Concept |
Description |
Reference |
| @props |
Declare component properties |
components.md |
| $attributes |
Pass-through HTML attributes |
slots-attributes.md |
| x-slot |
Named content areas |
slots-attributes.md |
| @yield/@section |
Traditional layout inheritance |
layouts.md |
| $loop |
Loop iteration info |
directives.md |
Reference Guide
Concepts (WHY & Architecture)
| Topic |
Reference |
When to Consult |
| Components |
components.md |
Class vs anonymous, namespacing |
| Slots & Attributes |
slots-attributes.md |
Data flow, $attributes bag |
| Layouts |
layouts.md |
Page structure, inheritance |
| Directives |
directives.md |
@if, @foreach, @auth, @can |
| Security |
security.md |
XSS, CSRF, escaping |
| Vite |
vite.md |
Asset bundling |
| Advanced Directives |
advanced-directives.md |
@once, @use, @inject, @switch, stacks |
| Custom Directives |
custom-directives.md |
Blade::if, Blade::directive |
| Advanced Components |
advanced-components.md |
@aware, shouldRender, index |
| Forms & Validation |
forms-validation.md |
@error, form helpers |
| Fragments |
fragments.md |
@fragment, HTMX integration |
Templates (Complete Code)
| Template |
When to Use |
| ClassComponent.php.md |
Component with logic/DI |
| AnonymousComponent.blade.md |
Simple reusable UI |
| LayoutComponent.blade.md |
Page layout structure |
| FormComponent.blade.md |
Form with validation |
| CardWithSlots.blade.md |
Named slots pattern |
| DynamicComponent.blade.md |
Runtime component |
| AdvancedDirectives.blade.md |
@once, @use, @inject, @switch |
| CustomDirectives.php.md |
Create custom directives |
| AdvancedComponents.blade.md |
@aware, shouldRender, index |
| Fragments.blade.md |
HTMX partial updates |
Quick Reference
Anonymous Component
{{-- resources/views/components/alert.blade.php --}}
@props(['type' => 'info', 'message'])
<div {{ $attributes->merge(['class' => 'alert alert-'.$type]) }}>
{{ $message }}
</div>
Class Component
// app/View/Components/Alert.php
class Alert extends Component
{
public function __construct(
public string $type = 'info',
public string $message = ''
) {}
public function render(): View
{
return view('components.alert');
}
}
Named Slots
<x-card>
<x-slot:header class="font-bold">
Title
</x-slot>
Content goes here
<x-slot:footer>
Footer content
</x-slot>
</x-card>
Attribute Merging
@props(['disabled' => false])
<button {{ $attributes->merge([
'type' => 'submit',
'class' => 'btn btn-primary'
])->class(['opacity-50' => $disabled]) }}
@disabled($disabled)
>
{{ $slot }}
</button>
Best Practices
DO
- Use
@props to document expected props
- Use
$attributes->merge() for flexibility
- Prefer anonymous components for simple UI
- Use named slots for complex layouts
- Keep components focused and reusable
DON'T
- Use
{!! !!} without sanitization
- Forget
@csrf in forms
- Put business logic in Blade templates
- Create deeply nested component hierarchies
- Hardcode classes (allow overrides)
Laravel 13 Notes
Attributes Controllers #[Middleware] et #[Authorize]
Laravel 13 supporte les attributs PHP sur les classes ET méthodes de controllers pour déclarer middleware et autorisations (remplace __construct middleware boilerplate).
use Illuminate\Routing\Attributes\Middleware;
use Illuminate\Routing\Attributes\Authorize;
#[Middleware(['auth', 'verified'])]
final class PostController extends Controller
{
#[Authorize('viewAny', Post::class)]
public function index() { return view('posts.index'); }
#[Middleware('throttle:60,1')]
#[Authorize('create', Post::class)]
public function store(StorePostRequest $request) { /* ... */ }
}
Le middleware passé via attribut s'applique avant les middlewares groupes/routes. #[Authorize] jette AuthorizationException (403) si la policy refuse.
1---2name: laravel-blade3description: Create Blade templates with components, slots, layouts, and directives. Use when building views, reusable components, or templating.4versions:5 laravel: "13.0"6 php: "8.3"7user-invocable: true8references: references/components.md, references/slots-attributes.md, references/layouts.md, references/directives.md, references/security.md, references/vite.md, references/advanced-directives.md, references/custom-directives.md, references/advanced-components.md, references/forms-validation.md, references/fragments.md, references/templates/ClassComponent.php.md, references/templates/AnonymousComponent.blade.md, references/templates/LayoutComponent.blade.md, references/templates/FormComponent.blade.md, references/templates/CardWithSlots.blade.md, references/templates/DynamicComponent.blade.md, references/templates/AdvancedDirectives.blade.md, references/templates/CustomDirectives.php.md, references/templates/AdvancedComponents.blade.md, references/templates/Fragments.blade.md9related-skills: laravel-livewire, laravel-i18n, fusecore10metadata:11 source: https://skillmd.com/skills/fusengine/laravel-blade12---1314<objective>15Covers Laravel Blade templating: anonymous and class-based components, named16slots and attribute bags ($attributes->merge()), layouts (component-based and17@extends/@section inheritance), directives (@if, @foreach, @auth, @can, and18advanced ones like @once/@use/@inject/@switch/stacks), custom directives19(Blade::if, Blade::directive), security (XSS/CSRF escaping), Vite asset20integration, forms/validation helpers (@error), and fragments for21HTMX-style partial updates.22</objective>2324# Laravel Blade2526## Agent Workflow (MANDATORY)2728Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:29301. **fuse-ai-pilot:explore-codebase** - Check existing views, components structure312. **fuse-ai-pilot:research-expert** - Verify latest Blade docs via Context7323. **mcp__context7__query-docs** - Query specific patterns (components, slots)3334After implementation, run **fuse-ai-pilot:sniper** for validation.3536---3738## Overview3940Blade is Laravel's templating engine. It provides a clean syntax for PHP in views while compiling to pure PHP for performance.4142| Component Type | When to Use |43|----------------|-------------|44| **Anonymous** | Simple UI, no logic needed |45| **Class-based** | Dependency injection, complex logic |46| **Layout** | Page structure, reusable shells |47| **Dynamic** | Runtime component selection |4849---5051## Critical Rules52531. **Always escape output** - Use `{{ }}` not `{!! !!}` unless absolutely necessary542. **Use @props** - Declare expected props explicitly553. **Merge attributes** - Allow class/attribute overrides with `$attributes->merge()`564. **Prefer anonymous** - Use class components only when logic is needed575. **Use named slots** - For complex layouts with multiple content areas586. **CSRF in forms** - Always include `@csrf` in forms5960---6162## Decision Guide6364### Component Type Selection6566```67Need dependency injection?68├── YES → Class-based component69└── NO → Anonymous component70 │71 Need complex props logic?72 ├── YES → Class-based component73 └── NO → Anonymous component74```7576### Layout Strategy7778```79Simple page structure?80├── YES → Component layout (<x-layout>)81└── NO → Need fine-grained sections?82 ├── YES → @extends/@section83 └── NO → Component layout84```8586---8788## Key Concepts8990| Concept | Description | Reference |91|---------|-------------|-----------|92| **@props** | Declare component properties | [components.md](references/components.md) |93| **$attributes** | Pass-through HTML attributes | [slots-attributes.md](references/slots-attributes.md) |94| **x-slot** | Named content areas | [slots-attributes.md](references/slots-attributes.md) |95| **@yield/@section** | Traditional layout inheritance | [layouts.md](references/layouts.md) |96| **$loop** | Loop iteration info | [directives.md](references/directives.md) |9798---99100## Reference Guide101102### Concepts (WHY & Architecture)103104| Topic | Reference | When to Consult |105|-------|-----------|-----------------|106| **Components** | [components.md](references/components.md) | Class vs anonymous, namespacing |107| **Slots & Attributes** | [slots-attributes.md](references/slots-attributes.md) | Data flow, $attributes bag |108| **Layouts** | [layouts.md](references/layouts.md) | Page structure, inheritance |109| **Directives** | [directives.md](references/directives.md) | @if, @foreach, @auth, @can |110| **Security** | [security.md](references/security.md) | XSS, CSRF, escaping |111| **Vite** | [vite.md](references/vite.md) | Asset bundling |112| **Advanced Directives** | [advanced-directives.md](references/advanced-directives.md) | @once, @use, @inject, @switch, stacks |113| **Custom Directives** | [custom-directives.md](references/custom-directives.md) | Blade::if, Blade::directive |114| **Advanced Components** | [advanced-components.md](references/advanced-components.md) | @aware, shouldRender, index |115| **Forms & Validation** | [forms-validation.md](references/forms-validation.md) | @error, form helpers |116| **Fragments** | [fragments.md](references/fragments.md) | @fragment, HTMX integration |117118### Templates (Complete Code)119120| Template | When to Use |121|----------|-------------|122| [ClassComponent.php.md](references/templates/ClassComponent.php.md) | Component with logic/DI |123| [AnonymousComponent.blade.md](references/templates/AnonymousComponent.blade.md) | Simple reusable UI |124| [LayoutComponent.blade.md](references/templates/LayoutComponent.blade.md) | Page layout structure |125| [FormComponent.blade.md](references/templates/FormComponent.blade.md) | Form with validation |126| [CardWithSlots.blade.md](references/templates/CardWithSlots.blade.md) | Named slots pattern |127| [DynamicComponent.blade.md](references/templates/DynamicComponent.blade.md) | Runtime component |128| [AdvancedDirectives.blade.md](references/templates/AdvancedDirectives.blade.md) | @once, @use, @inject, @switch |129| [CustomDirectives.php.md](references/templates/CustomDirectives.php.md) | Create custom directives |130| [AdvancedComponents.blade.md](references/templates/AdvancedComponents.blade.md) | @aware, shouldRender, index |131| [Fragments.blade.md](references/templates/Fragments.blade.md) | HTMX partial updates |132133---134135## Quick Reference136137### Anonymous Component138139```blade140{{-- resources/views/components/alert.blade.php --}}141@props(['type' => 'info', 'message'])142143<div {{ $attributes->merge(['class' => 'alert alert-'.$type]) }}>144 {{ $message }}145</div>146```147148### Class Component149150```php151// app/View/Components/Alert.php152class Alert extends Component153{154 public function __construct(155 public string $type = 'info',156 public string $message = ''157 ) {}158159 public function render(): View160 {161 return view('components.alert');162 }163}164```165166### Named Slots167168```blade169<x-card>170 <x-slot:header class="font-bold">171 Title172 </x-slot>173174 Content goes here175176 <x-slot:footer>177 Footer content178 </x-slot>179</x-card>180```181182### Attribute Merging183184```blade185@props(['disabled' => false])186187<button {{ $attributes->merge([188 'type' => 'submit',189 'class' => 'btn btn-primary'190])->class(['opacity-50' => $disabled]) }}191 @disabled($disabled)192>193 {{ $slot }}194</button>195```196197---198199## Best Practices200201### DO202- Use `@props` to document expected props203- Use `$attributes->merge()` for flexibility204- Prefer anonymous components for simple UI205- Use named slots for complex layouts206- Keep components focused and reusable207208### DON'T209- Use `{!! !!}` without sanitization210- Forget `@csrf` in forms211- Put business logic in Blade templates212- Create deeply nested component hierarchies213- Hardcode classes (allow overrides)214215---216217## Laravel 13 Notes218219### Attributes Controllers `#[Middleware]` et `#[Authorize]`220Laravel 13 supporte les attributs PHP sur les classes ET méthodes de controllers pour déclarer middleware et autorisations (remplace `__construct` middleware boilerplate).221222```php223use Illuminate\Routing\Attributes\Middleware;224use Illuminate\Routing\Attributes\Authorize;225226#[Middleware(['auth', 'verified'])]227final class PostController extends Controller228{229 #[Authorize('viewAny', Post::class)]230 public function index() { return view('posts.index'); }231232 #[Middleware('throttle:60,1')]233 #[Authorize('create', Post::class)]234 public function store(StorePostRequest $request) { /* ... */ }235}236```237238Le middleware passé via attribut s'applique avant les middlewares groupes/routes. `#[Authorize]` jette `AuthorizationException` (403) si la policy refuse.