Yii框架renderPartial渲染头部：不同模块需展示不同子头部内容问题

嘿，这个动态子头部的需求其实用Yii的renderPartial传参就能轻松搞定，我给你捋清楚步骤：

1. 修改通用头部视图_header.php，支持接收动态子头部内容 #

首先，在你的通用头部里预留动态子头部的位置，通过判断传入的变量来决定展示默认内容还是自定义内容。修改后的代码大概是这样：

<style type="text/css">
.header__fnav .navbar-brand{ background:#fff; }
.header__fnav .navbar-brand .st0{ fill:#00AAC6; }
.header__fnav .navbar-brand .st1{ fill:#CE... }
</style>

<!-- 固定的通用头部结构 -->
<header class="header__fnav">
    <nav class="navbar">
        <!-- 这里是你原本的通用导航内容 -->
        <a class="navbar-brand" href="#">...</a>
    </nav>

    <!-- 动态子头部区域 -->
    <?php if (isset($subHeader)): ?>
        <!-- 展示自定义子头部 -->
        <?php echo $subHeader; ?>
    <?php else: ?>
        <!-- 默认子头部内容（如果有的话） -->
        <div class="default-sub-header">
            <p>这是默认的子头部内容</p>
        </div>
    <?php endif; ?>
</header>

这里我把变量名设为$subHeader，你可以根据自己的习惯调整，核心就是通过传入的变量控制子头部内容。

2. 在不同模块中渲染头部时传入对应内容 #

接下来，在需要自定义子头部的模块里，调用renderPartial时传入子头部内容即可：

场景1：使用默认子头部的模块 #

直接调用，不需要传额外参数，会自动展示_header.php里的默认子头部：

<?php echo $this->renderPartial('//layouts/_header'); ?>

场景2：自定义简单子头部的模块 #

如果子头部内容比较短，可以直接把HTML字符串作为参数传入：

<?php
// 定义自定义子头部内容
$customSubHeader = '<div class="module-sub-header">
    <h2>这是XX模块的专属子头部</h2>
    <p>仅在当前模块展示</p>
</div>';

// 渲染头部并传入参数
echo $this->renderPartial('//layouts/_header', array('subHeader' => $customSubHeader));
?>

场景3：自定义复杂子头部的模块 #

如果子头部包含很多逻辑或者HTML结构，建议把它拆成单独的局部视图（比如_sub_header_user.php），然后通过嵌套renderPartial传入：

<?php
// 先渲染子头部视图，第三个参数设为true表示返回HTML字符串（而非直接输出）
$complexSubHeader = $this->renderPartial('//modules/user/views/_sub_header_user', null, true);

// 再把这个字符串传给通用头部
echo $this->renderPartial('//layouts/_header', array('subHeader' => $complexSubHeader));
?>

额外小技巧 #

如果你的项目里有大量模块需要不同的子头部，还可以考虑在控制器里统一处理：比如在控制器的beforeRender方法中根据当前模块/动作设置$subHeader变量，这样视图里就不用重复写传参代码了，更简洁。

内容的提问来源于stack exchange，提问作者rory-h