@include در Blade

دسته‌بندی‌ها

@include در Blade

دستور @include در Blade یکی از پرکاربردترین امکانات در قالب‌سازی Laravel هست که برای وارد کردن یک ویو (partial) در ویو دیگر استفاده می‌شه.

📌 کاربرد اصلی `@include`

فرض کن یک بخش مثل هدر (header) یا فوتر (footer) یا نوار کناری (sidebar) رو در چند صفحه استفاده می‌کنی. برای جلوگیری از تکرار کد، اون بخش‌ها رو در یک فایل جداگانه می‌نویسی و با @include وارد سایر فایل‌های Blade می‌کنی.

🛠️ سینتکس کلی:

blade
@include('view.name')

مسیر view.name، اشاره به مسیر فایل در پوشه resources/views بدون پسوند .blade.php داره.

🎯 مثال ساده:

ساخت فایل‌های partial:

resources/views/partials/header.blade.php

blade
<header>
    <h1>My Website</h1>
</header>

resources/views/partials/footer.blade.php

blade
<footer>
    <p>&copy; 2025 My Website</p>
</footer>

استفاده در صفحه اصلی:

resources/views/home.blade.php

blade
@include('partials.header')

<div class="content">
    <p>Welcome to the homepage!</p>
</div>

@include('partials.footer')

🧠 ارسال داده به `@include`

اگه بخوای داده هم به ویوی شامل‌شده ارسال کنی:

blade
@include('partials.user', ['user' => $user])

در فایل partials/user.blade.php:

blade
<p>Hello, {{ $user->name }}</p>

⚠️ نکات مهم

فایل مورد نظر حتماً باید وجود داشته باشه؛ در غیر این‌صورت ارور می‌گیری.
اگر می‌خوای فقط در صورت وجود فایل، اون رو بارگذاری کنی، از @includeIf استفاده کن:

blade
@includeIf('partials.maybe')

✨ سایر نسخه‌های مرتبط:

دستور	توضیح
`@include`	درج ویو به‌صورت مستقیم
`@includeIf`	فقط اگر ویو وجود داشته باشد
`@includeWhen($condition, 'view')`	اگر شرط برقرار باشد
`@includeUnless($condition, 'view')`	اگر شرط برقرار نباشد
`@each('itemView', $items, 'item')`	حلقه زدن روی مجموعه‌ای و رندر ویو برای هر مورد