在 Sage 10 中使用 @include 引入 Blade 组件时，可通过 PHP 空合并逻辑为传入变量设置默认值，避免因遗漏参数导致渲染异常（如空按钮），提升组件健壮性与团队协作可靠性。
在 sage 10 中使用 `@include` 引入 blade 组件时，可通过 php 空合并逻辑为传入变量设置默认值，避免因遗漏参数导致渲染异常（如空按钮），提升组件健壮性与团队协作可靠性。
在 Sage 10 的 Blade 模板中，@include('partials.button', $data) 会将数组中的键值直接注入到被包含模板的作用域中（即 $button_class、$button_label 等变量可直接使用）。但若调用方未传入某项变量（例如忘记传 'button_label'），该变量将为 null 或未定义，直接 esc_html($button_label) 可能输出空内容甚至触发 PHP notice（尤其在严格模式下）。
✅ 正确做法：在组件文件顶部主动声明并提供回退值，利用 PHP 的三元空合并语法（?:）或更推荐的 ?? 运算符（自 PHP 7 起支持，语义更清晰，仅对 null 或未定义生效）：
<?php // resources/views/partials/button.blade.php
$button_class = $button_class ?? 'btn btn-primary';
$button_label = $button_label ?? __('Click me', 'textdomain');
?><button class="<?= esc_attr($button_class); ?>">
= esc_html($button_label); ?>
</button>
? 关键说明：
- ?? 比 ?: 更安全：$x ?? 'default' 仅在 $x 为 null 或未定义时生效；而 $x ?: 'default' 在 $x 为 false、0、'' 等“falsy”值时也会触发回退——这可能导致意外覆盖合法的空字符串或零值。
- 国际化支持：使用 __() 函数包裹回退文案，并传入正确的文本域（如 'textdomain'），确保多语言兼容。
- 属性类名建议保留基础样式：如示例中默认添加 'btn btn-primary'，既保证组件可用性，又不妨碍调用方通过传参完全覆盖。
? 调用示例（更灵活）：
{{-- 完整传参 --}}
@include('partials.button', [
'button_class' => 'btn btn-outline-secondary',
'button_label' => 'Cancel',
])
{{-- 仅传 label，class 使用默认值 --}}
@include('partials.button', ['button_label' => 'Submit'])
{{-- 无参数 —— 完全依赖回退值 --}}
@include('partials.button')
⚠️ 注意事项：
- 不要在 Blade 模板中混用 @php 和变量赋值逻辑（如 @php $x = $x ?? 'def'; @endphp），虽可行但可读性差，且易引发作用域混淆；统一使用顶部 块更清晰、符合 Sage 最佳实践。
- 若需复杂默认逻辑（如基于上下文动态生成 label），可封装为辅助函数或使用 Laravel 的 view()->share() 预设全局回退，但简单组件推荐就地声明，保持内聚。
通过这一模式，你的组件天然具备“防呆”能力，既保障用户体验一致性，也降低新成员接入成本——真正实现「约定优于配置」的现代前端工程实践。
