本文介绍如何在 Laravel 8+ 中通过 @include 机制复用 Blade 图表组件，并灵活传入页面特定变量（如标题、ID、数据源等），避免代码重复，提升模板可维护性与一致性。
本文介绍如何在 laravel 8+ 中通过 `@include` 机制复用 blade 图表组件，并灵活传入页面特定变量（如标题、id、数据源等），避免代码重复，提升模板可维护性与一致性。
在构建仪表盘或多图表页面时，重复编写结构相似但仅局部变量（如标题、图表 ID、数据配置）不同的 Blade 模板不仅低效，还极易引发维护难题。Laravel 提供了强大而简洁的 @include 指令，配合参数传递机制，可完美实现「一次定义、多处复用、按需定制」的组件化开发目标。
✅ 正确复用 _chart-widget.blade.php 的方式
将原静态模板改造为接收动态参数的可复用组件。首先，确保你的组件文件（如 resources/views/partials/_chart-widget.blade.php）使用 Blade 变量语法替代硬编码值：
<!-- resources/views/partials/_chart-widget.blade.php -->
<div class="card {{ $class ?? 'card-flush' }}">
<!--begin::Header-->
<div class="card-header border-0 pt-5">
<h3 class="card-title align-items-start flex-column">
<span class="card-label fw-bolder fs-3 mb-1">{{ $title ?? 'Chart Title' }}</span>
<span class="text-muted fw-bold fs-7">{{ $subtitle ?? 'No description' }}</span>
</h3>
<div class="card-toolbar">
<button type="button"
class="btn btn-sm btn-icon btn-color-primary btn-active-light-primary"
data-kt-menu-trigger="click"
data-kt-menu-placement="bottom-end">
{!! theme()->getSvgIcon("icons/duotune/general/gen024.svg", "svg-icon-2") !!}
</button>
{{ theme()->getView('partials/menus/_menu-1') }}
</div>
</div>
<!--end::Header-->
<!--begin::Body-->
<div class="card-body">
<!-- 使用唯一 ID 确保多个图表不冲突 -->
<div id="{{ $chartId ?? 'kt_charts_widget_default' }}" style="height: 350px"></div>
</div>
<!--end::Body-->
</div>? 关键点：所有可变内容（$title、$subtitle、$chartId、$class）均通过 Blade 变量注入，并提供安全的默认值（使用 ?? 运算符），防止未传参时报错。
✅ 在不同页面中按需调用
在任意 Blade 模板中，使用 @include 并传入上下文相关数据：
<!-- dashboard.blade.php -->
<div class="row g-5 g-xl-8">
<div class="col-xl-6">
@include('partials._chart-widget', [
'title' => 'Revenue Overview',
'subtitle' => 'Last 30 days',
'chartId' => 'kt_revenue_chart',
'class' => 'card-xl-stretch mb-5 mb-xl-8'
])
</div>
<div class="col-xl-6">
@include('partials._chart-widget', [
'title' => 'User Acquisition',
'subtitle' => 'New signups by channel',
'chartId' => 'kt_acquisition_chart',
'class' => 'card-xl-stretch mb-5 mb-xl-8'
])
</div>
</div>你甚至可以在同一页面中多次复用，仅需保证 chartId 唯一（用于 JavaScript 初始化图表），其他字段自由组合。
⚠️ 注意事项与最佳实践
- 路径规范：@include 的路径基于 resources/views/，省略 .blade.php 后缀；推荐使用子目录（如 partials.）组织组件，提升可读性与 IDE 支持。
- 变量安全性：始终为必填变量设置合理默认值（如 {{ $title ?? 'N/A' }}），避免因漏传参数导致视图崩溃。
- 避免过度嵌套：若组件逻辑复杂（如需异步加载数据、条件渲染多个图表类型），建议升级为 Blade 组件（<x-chart-widget />） 或 Vue/React 集成，以获得更强的封装能力。
- 性能提示：@include 是服务端包含，无额外 HTTP 请求开销；但大量重复 include 相同资源时，注意 Blade 缓存是否启用（php artisan view:cache）。
通过以上方式，你不仅实现了图表区块的真正复用，更建立起符合 Laravel 最佳实践的模块化视图架构——简洁、健壮、易于协作与长期演进。
